Ölçümler, uyarılar ve tanılamalarla Azure Digital Twins'i izleme
Azure Digital Twins, Azure Digital Twins kaynaklarınızı izlemek için kullanabileceğiniz ölçümler ve tanılama bilgileri sağlamak için Azure İzleyici ile tümleşir. Ölçümler varsayılan olarak etkinleştirilir ve Azure aboneliğinizdeki Azure Digital Twins kaynaklarının durumu hakkında bilgi verir. Uyarılar, ölçüm verilerinizde belirli koşullar bulunduğunda sizi proaktif olarak bilgilendirebilir. Ayrıca hizmet örneğinizin performansını, erişimini ve diğer verilerini izlemek için tanılama günlüklerini de toplayabilirsiniz.
Bu izleme özellikleri, Azure Digital Twins hizmetinin ve buna bağlı kaynakların genel durumunu değerlendirmenize yardımcı olabilir. Bunları kullanarak Azure Digital Twins örneğinizde neler olduğunu anlayabilir ve Azure desteği başvurmanıza gerek kalmadan sorunların kök nedenlerini analiz edebilirsiniz.
Bunlara Azure portalından erişilebilir ve Azure Digital Twins kaynağının İzleme başlığı altında gruplandırılır.
Azure kaynak ölçümlerini görüntüleme hakkında genel bilgi için Azure İzleyici belgelerindeki Ölçüm gezginini kullanmaya başlama bölümüne bakın. Azure ölçümleri için uyarıları yapılandırma hakkında genel bilgi için bkz. Yeni uyarı kuralı oluşturma.
Bu bölümün geri kalanında her Azure Digital Twins örneği tarafından izlenen ölçümler ve her ölçümün örneğinizin genel durumuyla ilişkisi açıklanmaktadır.
Bu ölçümleri, çözümünüzün bazı yönleri için yayımlanmış bir hizmet sınırına yaklaştığınızı izlemek üzere yapılandırabilirsiniz.
İzlemeyi ayarlamak için Azure İzleyici'deki uyarılar özelliğini kullanın. Bir ölçüm yayımlanan sınırın belirli bir yüzdesine ulaştığında uyarı almanız için bu ölçümler için eşikler tanımlayabilirsiniz.
API istekleriyle ilgili ölçümler:
Metric | Ölçüm görünen adı | Unit | Toplama türü | Açıklama | Boyutlar |
---|---|---|---|---|---|
ApiRequests | API İstekleri | Sayı | Toplam | Digital Twins okuma, yazma, silme ve sorgulama işlemleri için yapılan API İsteklerinin sayısı. | Kimlik doğrulama İşlem Protokol Durum Kodu, Durum Kodu Sınıfı, Durum Metni |
ApiRequestsFailureRate | API İstekleri Hata Oranı | Yüzde | Ortalama | Hizmetin örneğiniz için aldığı ve Digital Twins için okuma, yazma, silme ve sorgulama işlemleri için iç hata (500) yanıt kodu veren API isteklerinin yüzdesi. | Kimlik doğrulama İşlem Protokol Durum Kodu, Durum Kodu Sınıfı, Durum Metni |
ApiRequestsLatency | API İstekleri Gecikme Süresi | Milisaniye | Ortalama | API istekleri için yanıt süresi. Bu değer, isteğin Azure Digital Twins tarafından alındığı zamanı, hizmetin Digital Twins okuma, yazma, silme ve sorgulama işlemleri için başarılı/başarısız bir sonuç göndermesine kadar olan zamanı ifade eder. | Kimlik doğrulama İşlem Protokol |
Faturalamayla ilgili ölçümler:
Metric | Ölçüm görünen adı | Unit | Toplama türü | Açıklama | Boyutlar |
---|---|---|---|---|---|
BillingApiOperations | Faturalama API'leri İşlemleri | Sayı | Toplam | Azure Digital Twins hizmetinde yapılan tüm API isteklerinin sayısı için faturalama ölçümü. | Ölçüm Kimliği |
BillingMessagesprocessed | İşlenen Faturalama İletileri | Sayı | Toplam | Azure Digital Twins'den dış uç noktalara gönderilen ileti sayısı için faturalama ölçümü. Faturalama amacıyla tek bir ileti olarak kabul edilebilmesi için yükün 1 KB'tan büyük olmaması gerekir. Bu sınırdan büyük yükler 1 KB artımlı ek iletiler olarak sayılır (bu nedenle 1 KB ile 2 KB arasındaki bir ileti 2 ileti olarak sayılır, 2 KB ile 3 KB arasında bir ileti 3 ileti vb. olur). Bu kısıtlama yanıtlar için de geçerlidir; dolayısıyla yanıt gövdesinde 1,5 KB döndüren bir çağrı 2 işlem olarak faturalandırılır. |
Ölçüm Kimliği |
BillingQueryUnits | Faturalama Sorgu Birimleri | Sayı | Toplam | Sorguları yürütmek için kullanılan, dahili olarak hesaplanan bir hizmet kaynağı kullanımı ölçüsü olan Sorgu Birimlerinin sayısı. Sorgu Birimlerini ölçmeye yönelik bir yardımcı API de vardır: QueryChargeHelper Sınıfı | Ölçüm Kimliği |
Azure Digital Twins'in faturalandırılama şekli hakkında daha fazla bilgi için bkz . Azure Digital Twins fiyatlandırması.
Ölçümler veri girişiyle ilgili:
Metric | Ölçüm görünen adı | Unit | Toplama türü | Açıklama | Boyutlar |
---|---|---|---|---|---|
IngressEvents | Giriş Olayları | Sayı | Toplam | Azure Digital Twins'e gelen cihaz telemetrisi olaylarının sayısı. | Sonuç |
IngressEventsFailureRate | Giriş Olayları Hata Oranı | Yüzde | Ortalama | Hizmetin iç hata (500) yanıt kodu döndürdüğü gelen cihaz telemetrisi olaylarının yüzdesi. | Sonuç |
IngressEventsLatency | Giriş Olayları Gecikme Süresi | Milisaniye | Ortalama | Bir olayın azure digital twins tarafından çıkarılmaya hazır olduğu zamana kadar olan süre, hizmetin başarılı/başarısız bir sonuç göndermesi. | Sonuç |
İşler API'lerinden toplu işlemlerle ilgili ölçümler:
Metric | Ölçüm görünen adı | Unit | Toplama türü | Açıklama | Boyutlar |
---|---|---|---|---|---|
ImportJobLatency | İşi İçeri Aktarma Gecikme Süresi | Milisaniye | Ortalama | İçeri aktarma işinin tamamlanması için geçen toplam süre. | İşlem Kimlik doğrulama Protokol |
ImportJobEntityCount | İş Varlık Sayısını İçeri Aktar | Sayı | Toplam | İçeri aktarma işi tarafından işlenen ikizlerin, modellerin veya ilişkilerin sayısı. | İşlem Sonuç |
DeleteJobLatency | İş Gecikme Süresini Sil | Milisaniye | Ortalama | Silme işinin tamamlanması için geçen toplam süre. | İşlem Kimlik doğrulama Protokol |
DeleteJobEntityCount | İş Varlık Sayısını Sil | Sayı | Toplam | Silme işinin bir parçası olarak silinen modellerin, ikizlerin ve/veya ilişkilerin sayısı. | İşlem Sonuç |
Ölçümlerin yönlendirmeyle ilgili olması gerekir:
Metric | Ölçüm görünen adı | Unit | Toplama türü | Açıklama | Boyutlar |
---|---|---|---|---|---|
İletiler Yönlendirildi | Yönlendirilen İletiler | Sayı | Toplam | Event Hubs, Service Bus veya Event Grid gibi bir uç nokta Azure hizmetine yönlendirilen iletilerin sayısı. | Uç Nokta Türü, Sonuç |
RoutingFailureRate | Yönlendirme Hatası Oranı | Yüzde | Ortalama | Azure Digital Twins'den Event Hubs, Service Bus veya Event Grid gibi bir uç nokta Azure hizmetine yönlendirildikçe hatayla sonuçlanan olayların yüzdesi. | Uç Nokta Türü, Sonuç |
RoutingLatency | Yönlendirme Gecikme Süresi | Milisaniye | Ortalama | Azure Digital Twins'den event Hubs, Service Bus veya Event Grid gibi uç nokta Azure hizmetine gönderilen olaya yönlendirilen olay arasında geçen süre. | Uç Nokta Türü, Sonuç |
Boyutlar, ölçümler hakkında daha fazla ayrıntı belirlemeye yardımcı olur. Yönlendirme ölçümlerinden bazıları uç nokta başına bilgi sağlar. Aşağıdaki tabloda bu boyutlar için olası değerler listelenmiştir.
Boyut | Değerler |
---|---|
Kimlik Doğrulaması | OAuth |
İşlem (API İstekleri için) | Microsoft.DigitalTwins/digitaltwins/delete, Microsoft.DigitalTwins/digitaltwins/write, Microsoft.DigitalTwins/digitaltwins/read, Microsoft.DigitalTwins/eventroutes/read, Microsoft.DigitalTwins/eventroutes/write, Microsoft.DigitalTwins/eventroutes/delete, Microsoft.DigitalTwins/models/read, Microsoft.DigitalTwins/models/write, Microsoft.DigitalTwins/models/delete, Microsoft.DigitalTwins/query/action |
Uç Nokta Türü | Event Grid, Event Hubs, Service Bus |
Protokol | HTTPS |
Sonuç | Başarı Hata |
Durum Kodu | 200, 404, 500 vb. |
Durum Kodu Sınıfı | 2xx, 4xx, 5xx vb. |
Durum Metni | İç Sunucu Hatası, Bulunamadı vb. |
Bunların nasıl etkinleştirileceği de dahil olmak üzere Azure tanılama ayarları hakkında genel bilgi için bkz . Azure İzleyici'de tanılama ayarları. Log Analytics kullanarak tanılama günlüklerini sorgulama hakkında bilgi için bkz . Azure İzleyici'de Log Analytics'e genel bakış.
Bu bölümün geri kalanında Azure Digital Twins'in toplayabileceği tanılama günlüğü kategorileri ve bunların şemaları açıklanmaktadır.
Burada Azure Digital Twins'in topladığı günlük kategorileri hakkında daha fazla ayrıntı bulabilirsiniz.
Günlük kategorisi | Açıklama |
---|---|
ADTModelsOperation | Modeller ile ilgili tüm API çağrılarını günlüğe kaydetme |
ADTQueryOperation | Sorgular ile ilgili tüm API çağrılarını günlüğe kaydetme |
ADTEventRoutesOperation | Azure Digital Twins'den Event Grid, Event Hubs ve Service Bus gibi bir uç nokta hizmetine Olay Yolları ve olay çıkışıyla ilgili tüm API çağrılarını günlüğe kaydetme |
ADTDigitalTwinsOperation | Tek tek ikizler ile ilgili tüm API çağrılarını günlüğe kaydetme |
Her günlük kategorisi yazma, okuma, silme ve eylem işlemlerinden oluşur. Bu kategoriler rest API çağrılarına aşağıdaki gibi eşlenir:
Olay türü | REST API işlemleri |
---|---|
Write | PUT ve PATCH |
Oku | GET |
Delete | SİL |
Eylem | POST |
Aşağıda, her kategoride günlüğe kaydedilen işlemlerin ve buna karşılık gelen Azure Digital Twins REST API çağrılarının kapsamlı bir listesi verilmiştir.
Not
Her günlük kategorisi çeşitli işlemler/REST API çağrıları içerir. Aşağıdaki tabloda, bir sonraki günlük kategorisi listelenene kadar her günlük kategorisi altındaki tüm işlemler/REST API çağrıları ile eşlenir.
Günlük kategorisi | İşlem | REST API çağrıları ve diğer olaylar |
---|---|---|
ADTModelsOperation | Microsoft.DigitalTwins/models/write | Dijital İkiz Modelleri Güncelleştirme API'si |
Microsoft.DigitalTwins/models/read | Dijital İkiz Modelleri Get By Id ve List API'leri | |
Microsoft.DigitalTwins/models/delete | Dijital İkiz Modelleri API'sini Silme | |
Microsoft.DigitalTwins/models/action | Dijital İkiz Modelleri API Ekleme | |
ADTQueryOperation | Microsoft.DigitalTwins/query/action | Sorgu İkizleri API'si |
ADTEventRoutesOperation | Microsoft.DigitalTwins/eventroutes/write | Olay Yolları API Ekleme |
Microsoft.DigitalTwins/eventroutes/read | Event Routes Get By Id ve List API'leri | |
Microsoft.DigitalTwins/eventroutes/delete | Olay Yolları Silme API'si | |
Microsoft.DigitalTwins/eventroutes/action | Olayları bir uç nokta hizmetine yayımlamaya çalışırken hata oluştu (API çağrısı değil) | |
ADTDigitalTwinsOperation | Microsoft.DigitalTwins/digitaltwins/write | Digital Twins Ekleme, İlişki Ekleme, Güncelleştirme, Güncelleştirme Bileşeni |
Microsoft.DigitalTwins/digitaltwins/read | Digital Twins Get By ID, Get Component, Get Relationship by ID, List Incoming Relationships, List Relationships | |
Microsoft.DigitalTwins/digitaltwins/delete | Digital Twins İlişkiyi Sil, Sil | |
Microsoft.DigitalTwins/digitaltwins/action | Digital Twins Bileşen Telemetrisi Gönder, Telemetri Gönder |
Her günlük kategorisi, bu kategorideki olayların nasıl raporlandığını tanımlayan bir şemaya sahiptir. Tek tek günlük girdilerinin her biri metin olarak depolanır ve JSON blobu olarak biçimlendirilir. Günlükteki alanlar ve örnek JSON gövdeleri aşağıdaki her günlük türü için sağlanır.
ADTDigitalTwinsOperation
, ADTModelsOperation
ve ADTQueryOperation
tutarlı bir API günlük şeması kullanın. ADTEventRoutesOperation
şemayı özelliklerdeki bir endpointName
alanı içerecek şekilde genişletir.
Bu günlük şeması , , ADTModelsOperation
ADTQueryOperation
için ADTDigitalTwinsOperation
tutarlıdır. aynı şema, işlem adı dışında için ADTEventRoutesOperation
de kullanılır (bu şema hakkında daha fazla bilgi için çıkış günlüğü şemaları adlı sonraki bölüme bakın).Microsoft.DigitalTwins/eventroutes/action
Şema, Azure Digital Twins örneğine yapılan API çağrılarına ilişkin bilgileri içerir.
API günlükleri için alan ve özellik açıklamaları aşağıda verilmiştir.
Bu günlük türleri için örnek JSON gövdeleri aşağıda verilmiştir.
{
"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"
}
}
{
"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"
}
}
{
"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"
}
}
Aşağıda, türü olmayan Microsoft.DigitalTwins/eventroutes/action
bir için örnek bir ADTEventRoutesOperation
JSON gövdesi verilmiştir (bu şema hakkında daha fazla bilgi için çıkış günlüğü şemaları başlıklı sonraki bölüme bakın).
{
"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"
}
},
Aşağıdaki örnek, işlem adına özgü günlüklerin şemasıdır ADTEventRoutesOperation
Microsoft.DigitalTwins/eventroutes/action
. Bunlar, Azure Digital Twins örneğine bağlı çıkış uç noktalarındaki özel durumlarla ve API işlemleriyle ilgili ayrıntıları içerir.
Aşağıda, bu türde bir JSON gövdesi ADTEventRoutesOperation
örneği verilmiştır Microsoft.DigitalTwins/eventroutes/action
.
{
"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"
}
},
Azure İzleyici ve özellikleri hakkında daha fazla bilgiyi Azure İzleyici belgelerinde bulabilirsiniz.