Dela via


Övervaka Azure Digital Twins med mått, aviseringar och diagnostik

Azure Digital Twins integreras med Azure Monitor för att tillhandahålla mått och diagnostikinformation som du kan använda för att övervaka dina Azure Digital Twins-resurser. Mått är aktiverade som standard och ger dig information om tillståndet för Azure Digital Twins-resurser i din Azure-prenumeration. Aviseringar kan meddela dig proaktivt när vissa villkor finns i dina måttdata. Du kan också samla in diagnostikloggar för din tjänstinstans för att övervaka dess prestanda, åtkomst och andra data.

De här övervakningsfunktionerna kan hjälpa dig att utvärdera den övergripande hälsan för Azure Digital Twins-tjänsten och de resurser som är anslutna till den. Du kan använda dem för att förstå vad som händer i din Azure Digital Twins-instans och analysera rotorsaker till problem utan att behöva kontakta Azure-supporten.

De kan nås från Azure-portalen, grupperade under rubriken Övervakning för Azure Digital Twins-resursen.

Screenshot of the Azure portal showing the Monitoring options.

Mått och aviseringar

Allmän information om hur du visar Azure-resursmått finns i Komma igång med Metrics Explorer i Azure Monitor-dokumentationen. Allmän information om hur du konfigurerar aviseringar för Azure-mått finns i Skapa en ny aviseringsregel.

Resten av det här avsnittet beskriver de mått som spåras av varje Azure Digital Twins-instans och hur varje mått relaterar till den övergripande statusen för din instans.

Mått för att spåra tjänstbegränsningar

Du kan konfigurera dessa mått för att spåra när du närmar dig en publicerad tjänstgräns för någon aspekt av din lösning.

Om du vill konfigurera spårning använder du aviseringsfunktionen i Azure Monitor. Du kan definiera tröskelvärden för dessa mått så att du får en avisering när ett mått når en viss procentandel av den publicerade gränsen.

Metric Måttvisningsnamn Enhet Sammansättningstyp beskrivning Dimensioner
TwinCount Antal tvillingar (förhandsversion) Antal Totalt Totalt antal tvillingar i Azure Digital Twins-instansen. Använd det här måttet för att avgöra om du närmar dig tjänstgränsen för maximalt antal tvillingar som tillåts per instans. Ingen
ModelCount Antal modeller (förhandsversion) Antal Totalt Totalt antal modeller i Azure Digital Twins-instansen. Använd det här måttet för att avgöra om du närmar dig tjänstgränsen för maximalt antal modeller som tillåts per instans. Ingen

API-begärandemått

Mått som har att göra med API-begäranden:

Metric Måttvisningsnamn Enhet Sammansättningstyp beskrivning Dimensioner
ApiRequests API-begäranden Antal Totalt Antalet API-begäranden som gjorts för Digital Twins-läs-, skriv-, borttagnings- och frågeåtgärder. Autentisering
Drift
Protokollet
Statuskod,
Statuskodklass,
Statustext
ApiRequestsFailureRate Felfrekvens för API-begäranden Procent Genomsnitt Procentandelen API-begäranden som tjänsten tar emot för din instans som ger ett internt fel (500) svarskod för Digital Twins läs-, skriv-, borttagnings- och frågeåtgärder. Autentisering
Drift
Protokollet
Statuskod,
Statuskodklass,
Statustext
ApiRequestsLatency Svarstid för API-begäranden Millisekunder Genomsnitt Svarstiden för API-begäranden. Det här värdet refererar till tiden från det att begäran tas emot av Azure Digital Twins tills tjänsten skickar ett lyckat/misslyckat resultat för Digital Twins läs-, skriv-, borttagnings- och frågeåtgärder. Autentisering
Drift
Protokoll

Faktureringsmått

Mått som har att göra med fakturering:

Metric Måttvisningsnamn Enhet Sammansättningstyp beskrivning Dimensioner
BillingApiOperations API-åtgärder för fakturering Antal Totalt Faktureringsmått för antalet API-begäranden som görs mot Azure Digital Twins-tjänsten. Mätar-ID
BillingMessagesProcessed Bearbetade faktureringsmeddelanden Antal Totalt Faktureringsmått för antalet meddelanden som skickas från Azure Digital Twins till externa slutpunkter.

För att betraktas som ett enda meddelande i faktureringssyfte får en nyttolast inte vara större än 1 KB. Nyttolaster som är större än den här gränsen räknas som ytterligare meddelanden i steg om 1 KB (så ett meddelande mellan 1 KB och 2 KB räknas som 2 meddelanden, mellan 2 KB och 3 KB blir 3 meddelanden och så vidare).
Den här begränsningen gäller även för svar, så ett anrop som returnerar 1,5 KB i svarstexten debiteras till exempel som två åtgärder.
Mätar-ID
BillingQueryUnits Frågeenheter för fakturering Antal Totalt Antalet frågeenheter, ett internt beräknat mått på användning av tjänstresurser, som förbrukas för att köra frågor. Det finns också ett hjälp-API för mätning av frågeenheter: QueryChargeHelper-klass Mätar-ID

Mer information om hur Azure Digital Twins faktureras finns i Prissättning för Azure Digital Twins.

Ingressmått

Mått som har att göra med data ingress:

Metric Måttvisningsnamn Enhet Sammansättningstyp beskrivning Dimensioner
IngressEvents Ingångshändelser Antal Totalt Antalet inkommande enhetstelemetrihändelser i Azure Digital Twins. Resultat
IngressEventsFailureRate Felfrekvens för inkommande händelser Procent Genomsnitt Procentandelen inkommande enhetstelemetrihändelser som tjänsten returnerar ett internt fel (500) svarskod för. Resultat
IngressEventsLatency Svarstid för ingresshändelser Millisekunder Genomsnitt Tiden från när en händelse kommer till när den är redo att tas ut av Azure Digital Twins, då tjänsten skickar ett resultat som lyckades/misslyckades. Resultat

Mått för massåtgärder (från jobb-API:erna)

Mått som har att göra med massåtgärder från jobb-API :erna:

Metric Måttvisningsnamn Enhet Sammansättningstyp beskrivning Dimensioner
ImportJobLatency Svarstid för importjobb Millisekunder Genomsnitt Total tid det tar för ett importjobb att slutföras. Drift
Autentisering
Protokoll
ImportJobEntityCount Antal importjobbsentiteter Antal Totalt Antalet tvillingar, modeller eller relationer som bearbetas av ett importjobb. Drift
Resultat
DeleteJobLatency Ta bort jobbsvarstid Millisekunder Genomsnitt Total tid det tar för ett borttagningsjobb att slutföras. Drift
Autentisering
Protokoll
DeleteJobEntityCount Ta bort jobbentitetsantal Antal Totalt Antalet modeller, tvillingar och/eller relationer som tagits bort som en del av ett borttagningsjobb. Drift
Resultat

Routningsmått

Mått som har att göra med routning:

Metric Måttvisningsnamn Enhet Sammansättningstyp beskrivning Dimensioner
MessagesRouted Meddelanden dirigerade Antal Totalt Antalet meddelanden som dirigeras till en Azure-slutpunktstjänst, till exempel Event Hubs, Service Bus eller Event Grid. Slutpunktstyp,
Resultat
RoutingFailureRate Felfrekvens för routning Procent Genomsnitt Procentandelen händelser som resulterar i ett fel när de dirigeras från Azure Digital Twins till en Azure-slutpunktstjänst som Event Hubs, Service Bus eller Event Grid. Slutpunktstyp,
Resultat
RoutingLatency Svarstid för routning Millisekunder Genomsnitt Tiden förflutit mellan en händelse som dirigeras från Azure Digital Twins till när den publiceras till Slutpunktstjänsten i Azure, till exempel Event Hubs, Service Bus eller Event Grid. Slutpunktstyp,
Resultat

Måttdimensioner

Dimensioner hjälper dig att identifiera mer information om måtten. Vissa routningsmått innehåller information per slutpunkt. Tabellen nedan visar möjliga värden för dessa dimensioner.

Dimension Värden
Autentisering OAuth
Åtgärd (för API-begäranden) 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 av slutpunkt Event Grid,
Event Hubs,
Service Bus
Protokoll HTTPS
Resultat Framgång
Misslyckades
Statuskod 200, 404, 500 och så vidare.
Statuskodklass 2xx, 4xx, 5xx och så vidare.
Statustext Internt serverfel, hittades inte och så vidare.

Diagnostikloggar

Allmän information om Azure-diagnostikinställningar, inklusive hur du aktiverar dem, finns i Diagnostikinställningar i Azure Monitor. Information om hur du kör frågor mot diagnostikloggar med Log Analytics finns i Översikt över Log Analytics i Azure Monitor.

Resten av det här avsnittet beskriver de diagnostikloggkategorier som Azure Digital Twins kan samla in och deras scheman.

LOGGKATEGORIER

Här följer mer information om de kategorier av loggar som Azure Digital Twins samlar in.

Loggkategori beskrivning
ADTModelsOperation Logga alla API-anrop som är relaterade till modeller
ADTQueryOperation Logga alla API-anrop som är relaterade till frågor
ADTEventRoutesOperation Logga alla API-anrop relaterade till händelsevägar och utgående händelser från Azure Digital Twins till en slutpunktstjänst som Event Grid, Event Hubs och Service Bus
ADTDigitalTwinsOperation Logga alla API-anrop som är relaterade till enskilda tvillingar

Varje loggkategori består av åtgärder för skrivning, läsning, borttagning och åtgärd. De här kategorierna mappas till REST API-anrop på följande sätt:

Händelsetyp REST API-åtgärder
Skriv PUT och PATCH
Läs GET
Delete DELETE
Åtgärd POST

Här är en omfattande lista över de åtgärder och motsvarande REST API-anrop för Azure Digital Twins som loggas i varje kategori.

Kommentar

Varje loggkategori innehåller flera åtgärder/REST API-anrop. I tabellen nedan mappar varje loggkategori till alla åtgärder/REST API-anrop under den tills nästa loggkategori visas.

Loggkategori Åtgärd REST API-anrop och andra händelser
ADTModelsOperation Microsoft.DigitalTwins/models/write Uppdaterings-API för digitala tvillingmodeller
Microsoft.DigitalTwins/models/read Api:er för Digital Twin-modeller hämta efter ID och lista
Microsoft.DigitalTwins/models/delete Api för borttagning av digitala tvillingmodeller
Microsoft.DigitalTwins/models/action Digital Twin-modeller Lägg till API
ADTQueryOperation Microsoft.DigitalTwins/query/action Frågetvillings-API
ADTEventRoutesOperation Microsoft.DigitalTwins/eventroutes/write Lägg till API för händelsevägar
Microsoft.DigitalTwins/eventroutes/read Api:er för händelsevägar hämta efter ID och lista
Microsoft.DigitalTwins/eventroutes/delete Borttagnings-API för händelsevägar
Microsoft.DigitalTwins/eventroutes/action Fel vid försök att publicera händelser till en slutpunktstjänst (inte ett API-anrop)
ADTDigitalTwinsOperation Microsoft.DigitalTwins/digitaltwins/write Digital Twins Add, Add Relationship, Update, Update Component
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 Ta bort, Ta bort relation
Microsoft.DigitalTwins/digitaltwins/action Digital Twins Send Component Telemetry, Send Telemetry

Loggscheman

Varje loggkategori har ett schema som definierar hur händelser i den kategorin rapporteras. Varje enskild loggpost lagras som text och formateras som en JSON-blob. Fälten i loggen och JSON-exempelkropparna anges för varje loggtyp nedan.

ADTDigitalTwinsOperation, ADTModelsOperationoch ADTQueryOperation använder ett konsekvent API-loggschema. ADTEventRoutesOperation utökar schemat så att det innehåller ett endpointName fält i egenskaper.

API-loggscheman

Det här loggschemat är konsekvent för ADTDigitalTwinsOperation, ADTModelsOperation, ADTQueryOperation. Samma schema används också för ADTEventRoutesOperation, förutom åtgärdsnamnet Microsoft.DigitalTwins/eventroutes/action (mer information om schemat finns i nästa avsnitt, Utgående loggscheman).

Schemat innehåller information som är relevant för API-anrop till en Azure Digital Twins-instans.

Här är fält- och egenskapsbeskrivningar för API-loggar.

Fältnamn Datatyp beskrivning
Time Datum/tid Datum och tid då den här händelsen inträffade i UTC
ResourceId String Resurs-ID:t för Azure Resource Manager för resursen där händelsen ägde rum
OperationName String Vilken typ av åtgärd som utförs under händelsen
OperationVersion String API-versionen som användes under händelsen
Category String Vilken typ av resurs som genereras
ResultType String Resultatet av händelsen
ResultSignature String Http-statuskod för händelsen
ResultDescription String Ytterligare information om händelsen
DurationMs String Hur lång tid det tog att utföra händelsen i millisekunder
CallerIpAddress String En maskerad käll-IP-adress för händelsen
CorrelationId GUID Unik identifierare för händelsen
ApplicationId GUID Program-ID som används i ägarauktorisering
Level Int Händelsens allvarlighetsgrad för loggning
Location String Regionen där händelsen ägde rum
RequestUri Uri Slutpunkten som användes under händelsen
TraceId String TraceId, som en del av W3C:s spårningskontext. ID:t för hela spårningen som används för att unikt identifiera en distribuerad spårning mellan system.
SpanId String SpanId som en del av W3C:s spårningskontext. ID:t för den här begäran i spårningen.
ParentId String ParentId som en del av W3C:s spårningskontext. En begäran utan ett överordnat ID är roten för spårningen.
TraceFlags String TraceFlags som en del av W3C:s spårningskontext. Styr spårningsflaggor som sampling, spårningsnivå och så vidare.
TraceState String TraceState som en del av W3C:s spårningskontext. Ytterligare leverantörsspecifik spårningsidentifieringsinformation som sträcker sig över olika distribuerade spårningssystem.

Nedan visas exempel på JSON-organ för dessa typer av loggar.

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

Här är ett exempel på JSON-brödtext för en ADTEventRoutesOperation som inte är av Microsoft.DigitalTwins/eventroutes/action typen (mer information om schemat finns i nästa avsnitt, Utgående loggscheman).

  {
    "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"
    }
  },

Utgående loggscheman

Följande exempel är schemat för loggar som är specifika för ADTEventRoutesOperation åtgärdsnamnet Microsoft.DigitalTwins/eventroutes/action . Dessa innehåller information om undantag och API-åtgärder kring utgående slutpunkter som är anslutna till en Azure Digital Twins-instans.

Fältnamn Datatyp beskrivning
Time Datum/tid Datum och tid då den här händelsen inträffade i UTC
ResourceId String Resurs-ID:t för Azure Resource Manager för resursen där händelsen ägde rum
OperationName String Vilken typ av åtgärd som utförs under händelsen
Category String Vilken typ av resurs som genereras
ResultDescription String Ytterligare information om händelsen
CorrelationId GUID Kunden har angett unik identifierare för händelsen
ApplicationId GUID Program-ID som används i ägarauktorisering
Level Int Händelsens allvarlighetsgrad för loggning
Location String Regionen där händelsen ägde rum
TraceId String TraceId, som en del av W3C:s spårningskontext. ID:t för hela spårningen som används för att unikt identifiera en distribuerad spårning mellan system.
SpanId String SpanId som en del av W3C:s spårningskontext. ID:t för den här begäran i spårningen.
ParentId String ParentId som en del av W3C:s spårningskontext. En begäran utan ett överordnat ID är roten för spårningen.
TraceFlags String TraceFlags som en del av W3C:s spårningskontext. Styr spårningsflaggor som sampling, spårningsnivå och så vidare.
TraceState String TraceState som en del av W3C:s spårningskontext. Ytterligare leverantörsspecifik spårningsidentifieringsinformation som sträcker sig över olika distribuerade spårningssystem.
EndpointName String Namnet på utgående slutpunkt som skapats i Azure Digital Twins

Här är ett exempel på en JSON-brödtext för den ADTEventRoutesOperation typen 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"
  }
},

Nästa steg

Läs mer om Azure Monitor och dess funktioner i Azure Monitor-dokumentationen.