Monitore os Gêmeos Digitais do Azure com métricas, alertas e diagnósticos

Os Gêmeos Digitais do Azure integram-se ao Azure Monitor para fornecer métricas e informações de diagnóstico que você pode usar para monitorar seus recursos dos Gêmeos Digitais do Azure. As métricas são habilitadas por padrão e fornecem informações sobre o estado dos recursos do Azure Digital Twins em sua assinatura do Azure. Os alertas podem notificá-lo proativamente quando determinadas condições forem encontradas em seus dados de métricas. Você também pode coletar logs de diagnóstico para sua instância de serviço para monitorar seu desempenho, acesso e outros dados.

Esses recursos de monitoramento podem ajudá-lo a avaliar a integridade geral do serviço Gêmeos Digitais do Azure e os recursos conectados a ele. Você pode usá-los para entender o que está acontecendo em sua instância do Azure Digital Twins e analisar as causas raiz dos problemas sem precisar entrar em contato com o suporte do Azure.

Eles podem ser acessados no portal do Azure, agrupados sob o título Monitoramento do recurso Gêmeos Digitais do Azure.

Métricas e alertas

Para obter informações gerais sobre como exibir métricas de recursos do Azure, consulte Introdução ao explorador de métricas na documentação do Azure Monitor. Para obter informações gerais sobre como configurar alertas para métricas do Azure, consulte Criar uma nova regra de alerta.

O restante desta seção descreve as métricas controladas por cada instância do Azure Digital Twins e como cada métrica se relaciona com o status geral da sua instância.

Métricas para acompanhar os limites de serviço

Você pode configurar essas métricas para acompanhar quando estiver se aproximando de um limite de serviço publicado para algum aspeto da sua solução.

Para configurar o acompanhamento, use o recurso de alertas no Azure Monitor. Você pode definir limites para essas métricas para receber um alerta quando uma métrica atingir uma determinada porcentagem de seu limite publicado.

Métricas de solicitação de API

Métricas que têm a ver com solicitações de API:

Métricas de faturamento

Métricas que têm a ver com faturamento:

Para obter mais informações sobre a forma como os Gêmeos Digitais do Azure são cobrados, consulte Preços dos Gêmeos Digitais do Azure.

Métricas de ingresso

Métricas que têm a ver com a entrada de dados:

Métricas de operação em massa (das APIs de trabalhos)

Métricas que têm a ver com operações em massa das APIs de trabalho:

Métricas de roteamento

Métricas que têm a ver com roteamento:

Dimensões métricas

As dimensões ajudam a identificar mais detalhes sobre as métricas. Algumas das métricas de roteamento fornecem informações por ponto de extremidade. A tabela abaixo lista os valores possíveis para essas dimensões.

Registos de diagnósticos

Para obter informações gerais sobre as configurações de diagnóstico do Azure, incluindo como habilitá-las, consulte Configurações de diagnóstico no Azure Monitor. Para obter informações sobre como consultar logs de diagnóstico usando o Log Analytics, consulte Visão geral do Log Analytics no Azure Monitor.

O restante desta seção descreve as categorias de log de diagnóstico que os Gêmeos Digitais do Azure podem coletar e seus esquemas.

Categorias de registo

Aqui estão mais detalhes sobre as categorias de logs que o Azure Digital Twins coleta.

Cada categoria de log consiste em operações de gravação, leitura, exclusão e ação. Essas categorias são mapeadas para chamadas de API REST da seguinte maneira:

Aqui está uma lista abrangente das operações e chamadas correspondentes da API REST do Azure Digital Twins que são registradas em cada categoria.

Esquemas de log

Cada categoria de log tem um esquema que define como os eventos nessa categoria são relatados. Cada entrada de registo individual é armazenada como texto e formatada como um blob JSON. Os campos no log e exemplos de corpos JSON são fornecidos para cada tipo de log abaixo.

ADTDigitalTwinsOperation, ADTModelsOperatione ADTQueryOperation use um esquema de log de API consistente. ADTEventRoutesOperation estende o esquema para conter um endpointName campo em propriedades.

Esquemas de log da API

Este esquema de log é consistente para ADTDigitalTwinsOperation, ADTModelsOperation, ADTQueryOperation. O mesmo esquema também é usado para ADTEventRoutesOperation, exceto o nome da Microsoft.DigitalTwins/eventroutes/action operação (para obter mais informações sobre esse esquema, consulte a próxima seção, Esquemas de log de saída).

O esquema contém informações pertinentes às chamadas de API para uma instância do Azure Digital Twins.

Aqui estão as descrições de campo e propriedade para logs de API.

Abaixo estão exemplos de corpos JSON para esses tipos de logs.

ADTDigitalTwinsOperação

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

Aqui está um exemplo de corpo JSON para um ADTEventRoutesOperation que não é do tipo (para obter mais informações sobre esse esquema, consulte a próxima seção, Esquemas de log de Microsoft.DigitalTwins/eventroutes/action saída).

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

Esquemas de log de saída

O exemplo a seguir é o esquema para ADTEventRoutesOperation logs específicos para o nome da Microsoft.DigitalTwins/eventroutes/action operação. Eles contêm detalhes relacionados a exceções e as operações de API em torno de pontos de extremidade de saída conectados a uma instância do Azure Digital Twins.

Aqui está um exemplo de Microsoft.DigitalTwins/eventroutes/action corpo JSON para um ADTEventRoutesOperation do tipo.

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

Próximos passos

Leia mais sobre o Azure Monitor e seus recursos na documentação do Azure Monitor.