Ö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 Support.

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

Mått och aviseringar

Allmän information om hur du visar Azure-resursmått finns i Kom 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.

API-begärandemått

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

Faktureringsmått

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

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:

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:

Routningsmått

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

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.

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.

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är är en omfattande lista över de åtgärder och motsvarande REST API-anrop för Azure Digital Twins som loggas i varje kategori.

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.

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

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

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

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.

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

Nästa steg

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