Monitorar os Gêmeos Digitais do Azure com métricas

As métricas descritas neste artigo mostram informações sobre o estado dos recursos dos Gêmeos Digitais do Azure em sua assinatura do Azure. As métricas dos Gêmeos Digitais do Azure ajudam a avaliar a integridade geral do serviço e dos recursos conectados a ele. Com essas estatísticas voltadas para usuários, você vê o que está acontecendo com os Gêmeos Digitais do Azure e analisa a causa raiz dos problemas, sem a necessidade de entrar em contato com o Suporte do Azure.

As métricas são habilitadas por padrão. Você pode ver as métricas dos Gêmeos Digitais do Azure no portal do Azure.

Exibir as métricas

  1. Crie uma instância dos Gêmeos Digitais do Azure. Você pode encontrar as instruções de configuração de uma instância dos Gêmeos Digitais do Azure em Configurar uma instância e autenticação.

  2. Localize a instância dos Gêmeos Digitais do Azure no portal do Azure (para abrir a página, digite o nome dela na barra de pesquisa do portal).

    No menu da instância, selecione Métricas.

    Screenshot showing the metrics page for Azure Digital Twins in the Azure portal.

    Esta página exibe as métricas da instância dos Gêmeos Digitais do Azure. Você também pode selecionar algumas métricas na lista para criar exibições personalizadas.

  3. Você pode enviar os dados de métricas a um ponto de extremidade dos Hubs de Eventos ou uma conta do Armazenamento do Microsoft Azure. Para isso, selecione Configurações de diagnóstico no menu e Adicionar configuração de diagnóstico.

    Screenshot showing the diagnostic settings page and button to add in the Azure portal.

    Para obter mais informações sobre esse processo, confira Monitoramento com logs de diagnóstico.

  4. Para configurar alertas para os dados de métricas, selecione Alertas no menu e + Nova regra de alerta. Screenshot showing the Alerts page and button to add in the Azure portal.

    Para obter mais informações sobre esse processo, confira Monitoramento com alertas.

Lista de métricas

Os Gêmeos Digitais do Azure oferecem várias métricas que apresentam uma visão geral da integridade de uma instância e dos recursos associados. Você também pode combinar informações de várias métricas para ter uma ideia mais ampla do estado da instância.

As tabelas a seguir contêm descrições das métricas controladas pelas instâncias dos Gêmeos Digitais do Azure e da relação de cada métrica com o status geral da instância.

Métricas para acompanhar limites de serviço

Você pode configurar essas métricas para saber quando está prestes a atingir um limite de serviço publicado de algum aspecto da solução.

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

Métrica Nome de exibição da métrica Unidade Tipo de agregação Descrição Dimensões
TwinCount Contagem de gêmeos (versão prévia) Contagem Total Número total de gêmeos na instância dos Gêmeos Digitais do Azure. Use essa métrica para saber se você está se aproximando do limite de serviço do número máximo de gêmeos permitidos por instância. Nenhum
ModelCount Contagem de modelos (versão prévia) Contagem Total Número total de modelos na instância dos Gêmeos Digitais do Azure. Use essa métrica para saber se você está se aproximando do limite de serviço do número máximo de modelos permitidos por instância. Nenhum

Métricas de solicitação de API

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

Métrica Nome de exibição da métrica Unidade Tipo de agregação Descrição Dimensões
ApiRequests Solicitações da API Contagem Total O número de solicitações de API feitas para operações de leitura, gravação, exclusão e consulta dos Gêmeos Digitais. Autenticação,
Operação,
Protocolo,
Código de status,
Classe do código de status,
Texto de status
ApiRequestsFailureRate Taxa de falhas das solicitações de API Porcentagem Média O percentual de solicitações de API da instância recebidas pelo serviço que resultam no código de resposta de erro interno (500), referentes a operações de leitura, gravação, exclusão e consulta dos Gêmeos Digitais. Autenticação,
Operação,
Protocolo,
Código de status,
Classe do código de status,
Texto de status
ApiRequestsLatency Latência das solicitações a API Milissegundos Média O tempo de resposta das solicitações de API. Esse valor se refere ao tempo desde o momento em que os Gêmeos Digitais do Azure recebem a solicitação de leitura, gravação, exclusão ou consulta, até o momento em que o serviço envia a mensagem de êxito/falha. Autenticação,
Operação,
Protocolo

Métricas de cobrança

Métricas que têm a ver com a cobrança:

Métrica Nome de exibição da métrica Unidade Tipo de agregação Descrição Dimensões
BillingApiOperations Operações da API de cobrança Contagem Total Métrica de cobrança da contagem de todas as solicitações de API feitas no serviço de Gêmeos Digitais do Azure. ID de Medidor
BillingMessagesProcessed Mensagens de cobrança processadas Contagem Total Métrica de cobrança do número de mensagens enviadas dos Gêmeos Digitais do Azure a pontos de extremidade externos.

Para ser considerado uma mensagem para fins de cobrança, o conteúdo deve ter menos de 1 KB. Conteúdos maiores que esse limite serão contados como mensagens adicionais em incrementos de 1 KB (portanto, uma mensagem entre 1 KB e 2 KB será contada como duas mensagens, entre 2 KB e 3 KB serão três mensagens e assim por diante).
Essa restrição também se aplica a respostas, portanto, uma chamada que retorna 1,5 KB no corpo da resposta, por exemplo, será cobrada como duas operações.
ID de Medidor
BillingQueryUnits Unidades de consulta de cobrança Contagem Total O número de unidades de consulta, uma medida de uso de recursos de serviço calculada internamente, consumidas para executar consultas. Também há uma API auxiliar disponível para medir as unidades de consulta: classe QueryChargeHelper ID de Medidor

Para obter mais informações sobre a cobrança dos Gêmeos Digitais do Azure, confira Preço dos Gêmeos Digitais do Azure.

Métricas de entrada

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

Métrica Nome de exibição da métrica Unidade Tipo de agregação Descrição Dimensões
IngressEvents Eventos de entrada Contagem Total O número de eventos de telemetria de entrada nos Gêmeos Digitais do Azure. Resultado
IngressEventsFailureRate Taxa de falha de eventos de entrada Porcentagem Média O percentual de eventos de telemetria de entrada para os quais o serviço retornou um código de resposta de erro interno (500). Resultado
IngressEventsLatency Latência de eventos de entrada Milissegundos Média O tempo entre a chegada do evento e o momento quando ele está pronto para sair dos Gêmeos Digitais do Azure, momento no qual o serviço envia o resultado êxito/falha. Resultado

Métricas de roteamento

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

Métrica Nome de exibição da métrica Unidade Tipo de agregação Descrição Dimensões
MessagesRouted Mensagens roteadas Contagem Total O número de mensagens roteadas para um serviço do Azure de ponto de extremidade, como Hubs de Eventos, Barramento de Serviço ou Grade de Eventos. Tipo de ponto de extremidade,
Resultado
RoutingFailureRate Taxa de falha de roteamento Porcentagem Média O percentual de eventos que resultam em erro durante o roteamento dos Gêmeos Digitais do Azure até um serviço do Azure de ponto de extremidade, como os Hubs de Eventos, o Barramento de Serviço ou a Grade de Eventos. Tipo de ponto de extremidade,
Resultado
RoutingLatency Latência de roteamento Milissegundos Média O tempo entre o roteamento do evento nos Gêmeos Digitais do Azure até a publicação dele no serviço do Azure de ponto de extremidade, como os Hubs de Eventos, o Barramento de Serviço ou a Grade de Eventos. Tipo de ponto de extremidade,
Resultado

Dimensões

As dimensões ajudam a identificar mais detalhes sobre as métricas. Algumas das métricas de roteamento apresentam informações por ponto de extremidade. A tabela a seguir contém os valores possíveis dessas dimensões.

Dimensão Valores
Autenticação OAuth
Operação (para solicitações de 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
Tipo de Ponto de Extremidade Grade de Eventos,
Hubs de Eventos,
Barramento de Serviço
Protocolo HTTPS
Resultado Êxito,
Falha
Código de status 200, 404, 500 e assim por diante.
Classe do código de status 2xx, 4xx, 5xx e assim por diante.
Texto de status Erro interno do servidor, não encontrado e assim por diante.

Próximas etapas

Para saber mais sobre o gerenciamento das métricas registradas dos Gêmeos Digitais do Azure, confira Monitoramento com logs de diagnóstico.