Memantau Azure Digital Twins dengan metrik, pemberitahuan, dan diagnostik

Azure Digital Twins terintegrasi dengan Azure Monitor untuk menyediakan metrik dan informasi diagnostik yang dapat Anda gunakan untuk memantau sumber daya Azure Digital Twins Anda. Metrik diaktifkan secara default, dan memberi Anda informasi tentang status sumber daya Azure Digital Twins di langganan Azure Anda. Pemberitahuan dapat secara proaktif memberi tahu Anda saat kondisi tertentu ditemukan dalam data metrik Anda. Anda juga dapat mengumpulkan log diagnostik untuk instans layanan Anda untuk memantau performa, akses, dan data lainnya.

Fitur pemantauan ini dapat membantu Anda menilai kesehatan keseluruhan layanan Azure Digital Twins dan sumber daya yang terhubung ke layanan tersebut. Anda dapat menggunakannya untuk memahami apa yang terjadi di instans Azure Digital Twins Anda, dan menganalisis akar penyebab masalah tanpa perlu menghubungi dukungan Azure.

Mereka dapat diakses dari portal Azure, dikelompokkan di bawah judul Pemantauan untuk sumber daya Azure Digital Twins.

Metrik dan pemberitahuan

Untuk informasi umum tentang menampilkan metrik sumber daya Azure, lihat Mulai menggunakan penjelajah metrik di dokumentasi Azure Monitor. Untuk informasi umum tentang mengonfigurasi pemberitahuan untuk metrik Azure, lihat Membuat aturan pemberitahuan baru.

Bagian lainnya menjelaskan metrik yang dilacak oleh setiap instans Azure Digital Twins, dan bagaimana setiap metrik berkaitan dengan status keseluruhan instans Anda.

Metrik untuk melacak batas layanan

Anda dapat mengonfigurasi metrik ini untuk dilacak saat mendekati batas layanan yang diterbitkan untuk beberapa aspek solusi Anda.

Untuk menyiapkan penelusuran, gunakan fitur pemberitahuan di Azure Monitor. Anda dapat menentukan ambang batas untuk metrik ini sehingga Anda menerima peringatan saat metrik mencapai persentase tertentu dari batas yang diterbitkan.

Metrik permintaan API

Metrik harus dilakukan dengan permintaan API:

Metrik penagihan

Metrik ada hubungannya dengan penagihan:

Selengkapnya tentang cara penagihan Azure Digital Twins, lihat harga Azure Digital Twins.

Metrik Ingress

Metrik ada hubungannya dengan masuknya data:

Metrik operasi massal (dari API Pekerjaan)

Metrik berkaitan dengan operasi massal dari API Pekerjaan:

Metrik perutean

Metrik ada hubungannya dengan perutean:

Dimensi metrik

Dimensi membantu mengidentifikasi detail lebih lanjut tentang metrik. Beberapa metrik perutean menyediakan informasi per titik akhir. Tabel di bawah ini mencantumkan nilai yang mungkin untuk dimensi ini.

Log diagnostik

Untuk informasi umum tentang pengaturan diagnostik Azure, termasuk cara mengaktifkannya, lihat Pengaturan diagnostik di Azure Monitor. Untuk informasi tentang mengkueri log diagnostik menggunakan Analitik Log, lihat Gambaran Umum Analitik Log di Azure Monitor.

Bagian lainnya menjelaskan kategori log diagnostik yang dapat dikumpulkan Azure Digital Twins, dan skemanya.

Kategori log

Berikut adalah detail selengkapnya tentang kategori log yang dikumpulkan Azure Digital Twins.

Setiap kategori log terdiri dari operasi tulis, baca, hapus, dan tindakan. Peta kategori untuk panggilan REST API sebagai berikut:

Berikut adalah daftar komprehensif operasi dan panggilan REST API Azure Digital Twins yang sesuai yang dicatat di setiap kategori.

Skema log

Setiap kategori log memiliki skema yang menentukan bagaimana peristiwa dalam kategori tersebut dilaporkan. Setiap entri log individu disimpan sebagai teks dan diformat sebagai blob JSON. Bidang dalam log dan contoh badan JSON disediakan untuk setiap jenis log di bawah ini.

ADTDigitalTwinsOperation, ADTModelsOperation, dan ADTQueryOperationmenggunakan skema log API yang konsisten. ADTEventRoutesOperation memperluas skema untuk memuat bidang endpointName dalam properti.

Skema log API

Skema log ini konsisten untuk ADTDigitalTwinsOperation, ADTModelsOperation, ADTQueryOperation. Skema yang sama juga digunakan untuk ADTEventRoutesOperation, kecuali Microsoft.DigitalTwins/eventroutes/action nama operasi (untuk informasi selengkapnya tentang skema itu, lihat bagian berikutnya, skema log Keluar).

Skema ini berisi informasi yang berkaitan dengan panggilan API ke instans Azure Digital Twins.

Berikut adalah deskripsi bidang dan properti untuk log API.

Di bawah ini adalah contoh badan JSON untuk jenis log ini.

ADTDigitalTwinsOperation

{
  "time": "2020-03-14T21:11:14.9918922Z",
  "resourceId": "/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/MYRESOURCEGROUP/PROVIDERS/MICROSOFT.DIGITALTWINS/DIGITALTWINSINSTANCES/MYINSTANCENAME",
  "operationName": "Microsoft.DigitalTwins/digitaltwins/write",
  "operationVersion": "2020-10-31",
  "category": "DigitalTwinOperation",
  "resultType": "Success",
  "resultSignature": "200",
  "resultDescription": "",
  "durationMs": 8,
  "callerIpAddress": "13.68.244.*",
  "correlationId": "aaaa0000-bb11-2222-33cc-444444dddddd",
  "identity": {
    "claims": {
      "appId": "00001111-aaaa-2222-bbbb-3333cccc4444"
    }
  },
  "level": "4",
  "location": "southcentralus",
  "uri": "https://myinstancename.api.scus.digitaltwins.azure.net/digitaltwins/factory-58d81613-2e54-4faa-a930-d980e6e2a884?api-version=2020-10-31",
  "properties": {},
  "traceContext": {
    "traceId": "95ff77cfb300b04f80d83e64d13831e7",
    "spanId": "b630da57026dd046",
    "parentId": "9f0de6dadae85945",
    "traceFlags": "01",
    "tracestate": "k1=v1,k2=v2"
  }
}

ADTModelsOperation

{
  "time": "2020-10-29T21:12:24.2337302Z",
  "resourceId": "/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/MYRESOURCEGROUP/PROVIDERS/MICROSOFT.DIGITALTWINS/DIGITALTWINSINSTANCES/MYINSTANCENAME",
  "operationName": "Microsoft.DigitalTwins/models/write",
  "operationVersion": "2020-10-31",
  "category": "ModelsOperation",
  "resultType": "Success",
  "resultSignature": "201",
  "resultDescription": "",
  "durationMs": "80",
  "callerIpAddress": "13.68.244.*",
  "correlationId": "bbbb1111-cc22-3333-44dd-555555eeeeee",
  "identity": {
    "claims": {
      "appId": "00001111-aaaa-2222-bbbb-3333cccc4444"
    }
  },
  "level": "4",
  "location": "southcentralus",
  "uri": "https://myinstancename.api.scus.digitaltwins.azure.net/Models?api-version=2020-10-31",
  "properties": {},
  "traceContext": {
    "traceId": "95ff77cfb300b04f80d83e64d13831e7",
    "spanId": "b630da57026dd046",
    "parentId": "9f0de6dadae85945",
    "traceFlags": "01",
    "tracestate": "k1=v1,k2=v2"
  }
}

ADTQueryOperation

{
  "time": "2020-12-04T21:11:44.1690031Z",
  "resourceId": "/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/MYRESOURCEGROUP/PROVIDERS/MICROSOFT.DIGITALTWINS/DIGITALTWINSINSTANCES/MYINSTANCENAME",
  "operationName": "Microsoft.DigitalTwins/query/action",
  "operationVersion": "2020-10-31",
  "category": "QueryOperation",
  "resultType": "Success",
  "resultSignature": "200",
  "resultDescription": "",
  "durationMs": "314",
  "callerIpAddress": "13.68.244.*",
  "correlationId": "cccc2222-dd33-4444-55ee-666666ffffff",
  "identity": {
    "claims": {
      "appId": "00001111-aaaa-2222-bbbb-3333cccc4444"
    }
  },
  "level": "4",
  "location": "southcentralus",
  "uri": "https://myinstancename.api.scus.digitaltwins.azure.net/query?api-version=2020-10-31",
  "properties": {},
  "traceContext": {
    "traceId": "95ff77cfb300b04f80d83e64d13831e7",
    "spanId": "b630da57026dd046",
    "parentId": "9f0de6dadae85945",
    "traceFlags": "01",
    "tracestate": "k1=v1,k2=v2"
  }
}

ADTEventRoutesOperation

Berikut adalah contoh isi JSON untuk ADTEventRoutesOperation jenis yang tidak Microsoft.DigitalTwins/eventroutes/action berjenis (untuk informasi selengkapnya tentang skema tersebut, lihat bagian berikutnya, skema log Keluar).

  {
    "time": "2020-10-30T22:18:38.0708705Z",
    "resourceId": "/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/MYRESOURCEGROUP/PROVIDERS/MICROSOFT.DIGITALTWINS/DIGITALTWINSINSTANCES/MYINSTANCENAME",
    "operationName": "Microsoft.DigitalTwins/eventroutes/write",
    "operationVersion": "2020-10-31",
    "category": "EventRoutesOperation",
    "resultType": "Success",
    "resultSignature": "204",
    "resultDescription": "",
    "durationMs": 42,
    "callerIpAddress": "212.100.32.*",
    "correlationId": "dddd3333-ee44-5555-66ff-777777aaaaaa",
    "identity": {
      "claims": {
        "appId": "00001111-aaaa-2222-bbbb-3333cccc4444"
      }
    },
    "level": "4",
    "location": "southcentralus",
    "uri": "https://myinstancename.api.scus.digitaltwins.azure.net/EventRoutes/egressRouteForEventHub?api-version=2020-10-31",
    "properties": {},
    "traceContext": {
      "traceId": "95ff77cfb300b04f80d83e64d13831e7",
      "spanId": "b630da57026dd046",
      "parentId": "9f0de6dadae85945",
      "traceFlags": "01",
      "tracestate": "k1=v1,k2=v2"
    }
  },

Skema log Egress

Ini adalah skema untuk log ADTEventRoutesOperation khusus untuk nama operasi Microsoft.DigitalTwins/eventroutes/action. Contoh ini berisi detail yang berkaitan dengan pengecualian dan operasi API di sekitar titik akhir jalan keluar yang terhubung ke instans Azure Digital Twins.

Berikut adalah contoh badan JSON untuk ADTEventRoutesOperation jenis Microsoft.DigitalTwins/eventroutes/action tersebut.

{
  "time": "2020-11-05T22:18:38.0708705Z",
  "resourceId": "/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/MYRESOURCEGROUP/PROVIDERS/MICROSOFT.DIGITALTWINS/DIGITALTWINSINSTANCES/MYINSTANCENAME",
  "operationName": "Microsoft.DigitalTwins/eventroutes/action",
  "operationVersion": "",
  "category": "EventRoutesOperation",
  "resultType": "",
  "resultSignature": "",
  "resultDescription": "Unable to send EventHub message to [myPath] for event Id [f6f45831-55d0-408b-8366-058e81ca6089].",
  "durationMs": -1,
  "callerIpAddress": "",
  "correlationId": "dddd3333-ee44-5555-66ff-777777aaaaaa",
  "identity": {
    "claims": {
      "appId": "00001111-aaaa-2222-bbbb-3333cccc4444"
    }
  },
  "level": "4",
  "location": "southcentralus",
  "uri": "",
  "properties": {
    "endpointName": "myEventHub"
  },
  "traceContext": {
    "traceId": "95ff77cfb300b04f80d83e64d13831e7",
    "spanId": "b630da57026dd046",
    "parentId": "9f0de6dadae85945",
    "traceFlags": "01",
    "tracestate": "k1=v1,k2=v2"
  }
},

Langkah berikutnya

Baca selengkapnya tentang Azure Monitor dan kemampuannya dalam dokumentasi Azure Monitor.