Monitorování služby Azure Digital Twins s využitím metrik, upozornění a diagnostiky
Azure Digital Twins se integruje se službou Azure Monitor a poskytuje metriky a diagnostické informace, které můžete použít k monitorování prostředků Azure Digital Twins. Metriky jsou ve výchozím nastavení povolené a poskytují informace o stavu prostředků Azure Digital Twins ve vašem předplatném Azure. Výstrahy vás můžou aktivně informovat, když se v datech metrik nacházejí určité podmínky. Můžete také shromažďovat diagnostické protokoly pro vaši instanci služby, abyste mohli monitorovat jeho výkon, přístup a další data.
Tyto funkce monitorování vám můžou pomoct vyhodnotit celkový stav služby Azure Digital Twins a prostředky, které jsou k ní připojené. Můžete je použít k pochopení toho, co se děje v instanci služby Azure Digital Twins, a analyzovat původní příčiny problémů bez nutnosti kontaktovat podpora Azure.
K nim můžete přistupovat z webu Azure Portal seskupené pod nadpisem Monitorování pro prostředek Azure Digital Twins.
Metriky a upozornění
Obecné informace o zobrazení metrik prostředků Azure najdete v tématu Začínáme s Průzkumníkem metrik v dokumentaci ke službě Azure Monitor. Obecné informace o konfiguraci upozornění pro metriky Azure najdete v tématu Vytvoření nového pravidla upozornění.
Zbytek této části popisuje metriky sledované jednotlivými instancemi služby Azure Digital Twins a to, jak každá metrika souvisí s celkovým stavem vaší instance.
Metriky pro sledování limitů služby
Tyto metriky můžete nakonfigurovat tak, aby sledovaly, když se blížíte limitu publikovaných služeb pro určitý aspekt vašeho řešení.
Pokud chcete nastavit sledování, použijte funkci upozornění ve službě Azure Monitor. Pro tyto metriky můžete definovat prahové hodnoty, abyste dostali upozornění, když metrika dosáhne určitého procenta svého publikovaného limitu.
Metriky požadavků rozhraní API
Metriky, které se musí s požadavky rozhraní API provádět:
| Metrika | Zobrazovaný název metriky | Unit | Typ agregace | Popis | Dimenze |
|---|---|---|---|---|---|
| ApiRequests | Žádosti rozhraní API | Počet | Celkem | Počet požadavků rozhraní API provedených pro operace čtení, zápisu, odstranění a dotazování služby Digital Twins | Ověřování Operace Protokol Stavový kód, Třída stavového kódu, Text stavu |
| ApiRequestsFailureRate | Míra selhání požadavků rozhraní API | Procenta | Průměr | Procento požadavků rozhraní API, které služba obdrží pro vaši instanci, která poskytuje vnitřní kód odpovědi (500) pro operace čtení, zápisu, odstranění a dotazování služby Digital Twins. | Ověřování Operace Protokol Stavový kód, Třída stavového kódu, Text stavu |
| ApiRequestsLatency | Latence požadavků rozhraní API | Milisekundy | Průměr | Doba odezvy pro požadavky rozhraní API. Tato hodnota odkazuje na čas od přijetí požadavku službou Azure Digital Twins, dokud služba neodešle výsledek úspěšného nebo neúspěšného načtení, zápisu, odstranění a dotazování služby Digital Twins. | Ověřování Operace Protokol |
Metriky fakturace
Metriky, které je potřeba provést s fakturací:
| Metrika | Zobrazovaný název metriky | Unit | Typ agregace | Popis | Dimenze |
|---|---|---|---|---|---|
| BillingApiOperations | Operace rozhraní API pro fakturaci | Počet | Celkem | Metrika fakturace počtu všech požadavků rozhraní API provedených ve službě Azure Digital Twins | ID měření |
| BillingMessagesProcessed | Zpracované fakturační zprávy | Počet | Celkem | Metrika fakturace počtu zpráv odesílaných z Azure Digital Twins do externích koncových bodů Aby byla datová část považována za jednu zprávu pro účely fakturace, nesmí být datová část větší než 1 kB. Datové části větší, než je tento limit, se počítají jako další zprávy v přírůstcích 1 kB (takže zpráva mezi 1 kB a 2 kB se počítá jako 2 zprávy, mezi 2 kB a 3 kB budou 3 zprávy atd.). Toto omezení platí také pro odpovědi– takže volání, které v textu odpovědi vrátí 1,5 kB, se například bude účtovat jako 2 operace. |
ID měření |
| BillingQueryUnits | Jednotky dotazů fakturace | Počet | Celkem | Počet jednotek dotazů, interně vypočítaná míra využití prostředků služby, spotřebovaná ke spouštění dotazů. K dispozici je také pomocné rozhraní API pro měření jednotek dotazů: QueryChargeHelper – třída | ID měření |
Další informace o způsobu fakturace služby Azure Digital Twins najdete v cenách služby Azure Digital Twins.
Metriky příchozího přenosu dat
Metriky, které se musí s příchozím přenosem dat provádět:
| Metrika | Zobrazovaný název metriky | Unit | Typ agregace | Popis | Dimenze |
|---|---|---|---|---|---|
| IngressEvents | Události příchozího přenosu dat | Počet | Celkem | Počet příchozích událostí telemetrie zařízení do Služby Azure Digital Twins | Výsledek |
| IngressEventsFailureRate | Míra selhání událostí příchozího přenosu dat | Procenta | Průměr | Procento příchozích událostí telemetrie zařízení, pro které služba vrací vnitřní kód odpovědi (500). | Výsledek |
| IngressEventsLatency | Latence událostí příchozího přenosu dat | Milisekundy | Průměr | Čas od přijetí události do okamžiku, kdy je připravená k přenosu dat službou Azure Digital Twins, v tomto okamžiku služba odešle výsledek úspěchu nebo selhání. | Výsledek |
Metriky hromadné operace (z rozhraní API úloh)
Metriky, které se musí provádět s hromadnými operacemi z rozhraní API úloh:
| Metrika | Zobrazovaný název metriky | Unit | Typ agregace | Popis | Dimenze |
|---|---|---|---|---|---|
| ImportJobLatency | Latence úlohy importu | Milisekundy | Průměr | Celková doba potřebná k dokončení úlohy importu | Operace Ověřování Protokol |
| ImportJobEntityCount | Import počtu entit úlohy | Počet | Celkem | Počet dvojčat, modelů nebo relací zpracovaných úlohou importu | Operace Výsledek |
| DeleteJobLatency | Odstranění latence úlohy | Milisekundy | Průměr | Celková doba potřebná k dokončení úlohy odstranění | Operace Ověřování Protokol |
| DeleteJobEntityCount | Odstranit počet entit úlohy | Počet | Celkem | Počet modelů, dvojčat a/nebo relací odstraněných jako součást úlohy odstranění | Operace Výsledek |
Metriky směrování
Metriky, které se musí s směrováním dělat:
| Metrika | Zobrazovaný název metriky | Unit | Typ agregace | Popis | Dimenze |
|---|---|---|---|---|---|
| MessagesRouted | Zprávy směrované | Počet | Celkem | Počet zpráv směrovaných do služby Azure koncového bodu, jako je Event Hubs, Service Bus nebo Event Grid. | Typ koncového bodu Výsledek |
| RoutingFailureRate | Míra selhání směrování | Procenta | Průměr | Procento událostí, které vedou k chybě při směrování z Azure Digital Twins do koncového bodu služby Azure, jako jsou Event Hubs, Service Bus nebo Event Grid. | Typ koncového bodu Výsledek |
| RoutingLatency | Latence směrování | Milisekundy | Průměr | Čas uplynulý mezi událostí, která se směruje z Azure Digital Twins, do kdy se publikuje do služby Azure koncového bodu, jako jsou Event Hubs, Service Bus nebo Event Grid. | Typ koncového bodu Výsledek |
Rozměry metrik
Dimenze pomáhají identifikovat další podrobnosti o metrikách. Některé metriky směrování poskytují informace pro každý koncový bod. Následující tabulka uvádí možné hodnoty pro tyto dimenze.
| Dimenze | Hodnoty |
|---|---|
| Ověřování | OAuth |
| Operace (pro požadavky rozhraní API) | 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 |
| Typ koncového bodu | Event Grid, Event Hubs, Service Bus |
| Protokol | HTTPS |
| Výsledek | Úspěch Chyba |
| Kód stavu | 200, 404, 500 atd. |
| Třída stavového kódu | 2xx, 4xx, 5xx atd. |
| Text stavu | Vnitřní chyba serveru, nenalezena atd. |
Protokoly diagnostiky
Obecné informace o nastavení diagnostiky Azure, včetně toho, jak je povolit, najdete v tématu Nastavení diagnostiky ve službě Azure Monitor. Informace o dotazování diagnostických protokolů pomocí Log Analytics najdete v tématu Přehled služby Log Analytics ve službě Azure Monitor.
Zbytek této části popisuje kategorie diagnostických protokolů, které může Služba Azure Digital Twins shromažďovat, a jejich schémata.
Kategorie protokolů
Tady jsou další podrobnosti o kategoriích protokolů, které shromažďuje služba Azure Digital Twins.
| Kategorie protokolu | Popis |
|---|---|
| ADTModelsOperation | Protokolování všech volání rozhraní API souvisejících s modely |
| ADTQueryOperation | Protokolování všech volání rozhraní API souvisejících s dotazy |
| ADTEventRoutesOperation | Protokolování všech volání rozhraní API souvisejících s trasami událostí a odchozím přenosem událostí z Azure Digital Twins do služby koncového bodu, jako je Event Grid, Event Hubs a Service Bus |
| ADTDigitalTwinsOperation | Protokolování všech volání rozhraní API souvisejících s jednotlivými dvojčaty |
Každá kategorie protokolu se skládá z operací zápisu, čtení, odstranění a akce. Tyto kategorie se mapují na volání rozhraní REST API následujícím způsobem:
| Typ události | Operace rozhraní REST API |
|---|---|
| Zapsat | PUT a PATCH |
| Čteno | GET |
| Odstranění | DELETE |
| Akce | POST |
Tady je úplný seznam operací a odpovídajících volání rozhraní REST API služby Azure Digital Twins, která jsou zaznamenána v každé kategorii.
Poznámka:
Každá kategorie protokolů obsahuje několik operací nebo volání rozhraní REST API. V následující tabulce se každá kategorie protokolu mapuje na všechna volání operací nebo rozhraní REST API, dokud nebude uvedená další kategorie protokolu.
| Kategorie protokolu | Operace | Volání rozhraní REST API a další události |
|---|---|---|
| ADTModelsOperation | Microsoft.DigitalTwins/models/write | Rozhraní API pro aktualizaci modelů digitálních dvojčat |
| Microsoft.DigitalTwins/models/read | Modely služby Digital Twin Get By ID a List API | |
| Microsoft.DigitalTwins/models/delete | Rozhraní API pro odstranění modelů služby Digital Twin | |
| Microsoft.DigitalTwins/models/action | Přidání rozhraní API pro modely digitálních dvojčat | |
| ADTQueryOperation | Microsoft.DigitalTwins/query/action | Rozhraní API dvojčat dotazů |
| ADTEventRoutesOperation | Microsoft.DigitalTwins/eventroutes/write | Přidání rozhraní API pro trasy událostí |
| Microsoft.DigitalTwins/eventroutes/read | Trasy událostí – Získání podle ID a rozhraní API seznamu | |
| Microsoft.DigitalTwins/eventroutes/delete | Rozhraní API pro odstranění tras událostí | |
| Microsoft.DigitalTwins/eventroutes/action | Selhání při pokusu o publikování událostí do služby koncového bodu (ne volání rozhraní API) | |
| ADTDigitalTwinsOperation | Microsoft.DigitalTwins/digitaltwins/write | Přidání, přidání vztahu, aktualizace, aktualizace komponenty Digital Twins |
| Microsoft.DigitalTwins/digitaltwins/read | Digital Twins Get By ID, Get Component, Get Relationship by ID, List Incoming Relationships, List Relationships | |
| Microsoft.DigitalTwins/digitaltwins/delete | Odstranění, odstranění relace služby Digital Twins | |
| Microsoft.DigitalTwins/digitaltwins/action | Digitální dvojčata odesílají telemetrii komponent, odesílají telemetrii |
Schémata protokolů
Každá kategorie protokolu má schéma, které definuje, jak se hlásí události v dané kategorii. Každá individuální položka protokolu se ukládá jako text a formátuje se jako objekt blob JSON. Pole v protokolu a ukázkových tělech JSON jsou k dispozici pro každý následující typ protokolu.
ADTDigitalTwinsOperationADTQueryOperation a ADTModelsOperationpoužijte konzistentní schéma protokolu rozhraní API. ADTEventRoutesOperation rozšiřuje schéma tak, aby obsahovalo endpointName pole ve vlastnostech.
Schémata protokolů rozhraní API
Toto schéma protokolu je konzistentní pro ADTDigitalTwinsOperation, ADTModelsOperation, ADTQueryOperation. Stejné schéma se používá také pro ADTEventRoutesOperation, s výjimkou Microsoft.DigitalTwins/eventroutes/action názvu operace (další informace o tomto schématu naleznete v další části schématu protokolu výchozího přenosu dat).
Schéma obsahuje informace týkající se volání rozhraní API instance Služby Azure Digital Twins.
Tady jsou popisy polí a vlastností pro protokoly rozhraní API.
| Název pole | Datový typ | Popis |
|---|---|---|
Time |
DateTime | Datum a čas, kdy k této události došlo, v UTC |
ResourceId |
String | ID prostředku Azure Resource Manageru pro prostředek, ve kterém došlo k události |
OperationName |
String | Typ akce, která se provádí během události |
OperationVersion |
String | Verze rozhraní API používaná během události |
Category |
String | Typ vygenerovaného prostředku |
ResultType |
String | Výsledek události |
ResultSignature |
String | Stavový kód HTTP pro událost |
ResultDescription |
String | Další podrobnosti o události |
DurationMs |
String | Jak dlouho trvalo provedení události v milisekundách |
CallerIpAddress |
String | Maskovaná zdrojová IP adresa události |
CorrelationId |
Guid | Jedinečný identifikátor události |
ApplicationId |
Guid | ID aplikace použité při autorizaci nosné |
Level |
Int | Závažnost protokolování události |
Location |
String | Oblast, kde se událost uskutečnila |
RequestUri |
Identifikátor URI | Koncový bod použitý během události |
TraceId |
String | TraceId, jako součást kontextu trasování W3C. ID celého trasování, které se používá k jedinečné identifikaci distribuovaného trasování napříč systémy. |
SpanId |
String | SpanId jako součást kontextu trasování W3C. ID tohoto požadavku v trasování. |
ParentId |
String | ParentId jako součást kontextu trasování W3C. Požadavek bez nadřazeného ID je kořen trasování. |
TraceFlags |
String | TraceFlags jako součást kontextu trasování W3C. Řídí příznaky trasování, jako je vzorkování, úroveň trasování atd. |
TraceState |
String | TraceState jako součást kontextu trasování W3C. Další informace o identifikaci trasování specifické pro dodavatele, které se budou používat napříč různými distribuovanými systémy trasování. |
Níže jsou uvedeny příklady těl JSON pro tyto typy protokolů.
ADTDigitalTwinsOperation
{
"time": "2020-03-14T21:11:14.9918922Z",
"resourceId": "/SUBSCRIPTIONS/BBED119E-28B8-454D-B25E-C990C9430C8F/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": "2f6a8e64-94aa-492a-bc31-16b9f0b16ab3",
"identity": {
"claims": {
"appId": "872cd9fa-d31f-45e0-9eab-6e460a02d1f1"
}
},
"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/BBED119E-28B8-454D-B25E-C990C9430C8F/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": "9dcb71ea-bb6f-46f2-ab70-78b80db76882",
"identity": {
"claims": {
"appId": "872cd9fa-d31f-45e0-9eab-6e460a02d1f1"
}
},
"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/BBED119E-28B8-454D-B25E-C990C9430C8F/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": "1ee2b6e9-3af4-4873-8c7c-1a698b9ac334",
"identity": {
"claims": {
"appId": "872cd9fa-d31f-45e0-9eab-6e460a02d1f1"
}
},
"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
Tady je příklad textu JSON pro typ ADTEventRoutesOperation , který není typu Microsoft.DigitalTwins/eventroutes/action (další informace o tomto schématu najdete v další části Schémata protokolu výchozího přenosu dat).
{
"time": "2020-10-30T22:18:38.0708705Z",
"resourceId": "/SUBSCRIPTIONS/BBED119E-28B8-454D-B25E-C990C9430C8F/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": "7f73ab45-14c0-491f-a834-0827dbbf7f8e",
"identity": {
"claims": {
"appId": "872cd9fa-d31f-45e0-9eab-6e460a02d1f1"
}
},
"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"
}
},
Schémata protokolu výchozího přenosu dat
Následující příklad je schéma pro protokoly specifické pro ADTEventRoutesOperationMicrosoft.DigitalTwins/eventroutes/action název operace. Obsahují podrobnosti související s výjimkami a operacemi rozhraní API souvisejícími s výstupními koncovými body připojenými k instanci služby Azure Digital Twins.
| Název pole | Datový typ | Popis |
|---|---|---|
Time |
DateTime | Datum a čas, kdy k této události došlo, v UTC |
ResourceId |
String | ID prostředku Azure Resource Manageru pro prostředek, ve kterém došlo k události |
OperationName |
String | Typ akce, která se provádí během události |
Category |
String | Typ vygenerovaného prostředku |
ResultDescription |
String | Další podrobnosti o události |
CorrelationId |
Guid | Zákazník zadal jedinečný identifikátor události. |
ApplicationId |
Guid | ID aplikace použité při autorizaci nosné |
Level |
Int | Závažnost protokolování události |
Location |
String | Oblast, kde se událost uskutečnila |
TraceId |
String | TraceId, jako součást kontextu trasování W3C. ID celého trasování, které se používá k jedinečné identifikaci distribuovaného trasování napříč systémy. |
SpanId |
String | SpanId jako součást kontextu trasování W3C. ID tohoto požadavku v trasování. |
ParentId |
String | ParentId jako součást kontextu trasování W3C. Požadavek bez nadřazeného ID je kořen trasování. |
TraceFlags |
String | TraceFlags jako součást kontextu trasování W3C. Řídí příznaky trasování, jako je vzorkování, úroveň trasování atd. |
TraceState |
String | TraceState jako součást kontextu trasování W3C. Další informace o identifikaci trasování specifické pro dodavatele, které se budou používat napříč různými distribuovanými systémy trasování. |
EndpointName |
String | Název výstupního koncového bodu vytvořeného ve službě Azure Digital Twins |
Tady je příklad textu JSON pro ADTEventRoutesOperation daný typ Microsoft.DigitalTwins/eventroutes/action .
{
"time": "2020-11-05T22:18:38.0708705Z",
"resourceId": "/SUBSCRIPTIONS/BBED119E-28B8-454D-B25E-C990C9430C8F/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": "7f73ab45-14c0-491f-a834-0827dbbf7f8e",
"identity": {
"claims": {
"appId": "872cd9fa-d31f-45e0-9eab-6e460a02d1f1"
}
},
"level": "4",
"location": "southcentralus",
"uri": "",
"properties": {
"endpointName": "myEventHub"
},
"traceContext": {
"traceId": "95ff77cfb300b04f80d83e64d13831e7",
"spanId": "b630da57026dd046",
"parentId": "9f0de6dadae85945",
"traceFlags": "01",
"tracestate": "k1=v1,k2=v2"
}
},
Další kroky
Další informace o službě Azure Monitor a jejích možnostech najdete v dokumentaci ke službě Azure Monitor.