Monitor Azure Digital Twins com métricas

As métricas descritas neste artigo dão-lhe informações sobre o estado dos recursos da Azure Digital Twins na sua assinatura Azure. As métricas Azure Digital Twins ajudam-no a avaliar a saúde geral do serviço Azure Digital Twins e os recursos que lhe estão ligados. Estas estatísticas viradas para o utilizador ajudam-no a ver o que se passa com as gémeas digitais Azure e ajudam a analisar as causas dos problemas sem precisar de contactar suporte do Azure.

As métricas são ativadas por padrão. Pode ver as métricas do Azure Digital Twins a partir do portal do Azure.

Ver as métricas

  1. Crie uma instância Azure Digital Twins. Pode encontrar instruções sobre como configurar uma instância Azure Digital Twins em Configurar um caso e autenticação.

  2. Encontre a sua instância Azure Digital Twins no portal do Azure (pode abrir a página para ela digitando o seu nome na barra de pesquisa do portal).

    A partir do menu do caso, selecione Metrics.

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

    Esta página apresenta as métricas para a sua instância Azure Digital Twins. Também pode criar vistas personalizadas das suas métricas selecionando as que deseja ver na lista.

  3. Pode optar por enviar os seus dados de métricas para um ponto final do Event Hubs ou uma conta Azure Armazenamento selecionando as definições de Diagnóstico do menu e, em seguida, Adicionar a definição de diagnóstico.

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

    Para obter mais informações sobre este processo, consulte Monitor com registos de diagnóstico.

  4. Pode optar por configurar alertas para os dados das suas métricas selecionando Alertas do menu e, em seguida, + Nova regra de alerta. Screenshot showing the Alerts page and button to add in the Azure portal.

    Para obter mais informações sobre este processo, consulte o Monitor com alertas.

Lista de métricas

A Azure Digital Twins fornece várias métricas para lhe dar uma visão geral da saúde do seu caso e dos seus recursos associados. Você também pode combinar informações de várias métricas para pintar uma imagem maior do estado do seu caso.

As tabelas a seguir descrevem as métricas rastreadas por cada instância Azure Digital Twins, e como cada métrica se relaciona com o estado geral do seu caso.

Métricas para rastreio de limites de serviço

Pode configurar estas métricas para acompanhar quando se aproxima de um limite de serviço publicado para algum aspeto da sua solução.

Para configurar o rastreio, utilize a função de alerta no Azure Monitor. Pode definir limiares para estas métricas para que receba um alerta quando uma métrica atinge uma determinada percentagem do seu limite publicado.

Metric Nome de exibição métrica Unidade Tipo de agregação Description Dimensões
TwinCount Contagem de Gémeos (Pré-visualização) de palavras Total Número total de gémeos no caso Azure Digital Twins. Use esta métrica para determinar se está a aproximar-se do limite de serviço para o número máximo de gémeos permitidos por exemplo. Nenhuma
ModelCount Contagem de modelos (Pré-visualização) de palavras Total Número total de modelos na instância Azure Digital Twins. Utilize esta métrica para determinar se está a aproximar-se do limite de serviço para o número máximo de modelos permitidos por exemplo. Nenhuma

Métricas de pedido da API

Métricas que têm a ver com pedidos de API:

Metric Nome de exibição métrica Unidade Tipo de agregação Description Dimensões
ApiRequests Pedidos da API de palavras Total O número de Pedidos de API feitos para Gémeos Digitais lêem, escrevem, apagam e consultam as operações. Autenticação,
Operação,
Protocolo,
Código de Estado,
Classe código de estado,
Texto de estado
ApiRequestsFailureRate Taxa de falha de pedidos de API Percentagem Média A percentagem de pedidos da API que o serviço recebe, para o seu exemplo, que dão um código de resposta de erro interno (500) para as Gémeas Digitais lerem, escreverem, eliminarem e consultarem as operações. Autenticação,
Operação,
Protocolo,
Código de Estado,
Classe código de estado,
Texto de estado
ApiRequestsLatency API solicita latência Milissegundos Média O tempo de resposta para pedidos de API. Este valor refere-se ao momento em que o pedido é recebido pela Azure Digital Twins até que o serviço envie um resultado de sucesso/falha para as operações de leitura, escrita, exclusão e consulta de Gémeos Digitais. Autenticação,
Operação,
Protocolo

Métricas de faturação

Métricas que têm a ver com faturação:

Metric Nome de exibição métrica Unidade Tipo de agregação Description Dimensões
Operações BillingApi Operações de Faturação da API de palavras Total Métrica de faturação para a contagem de todos os pedidos da API feitos contra o serviço Azure Digital Twins. ID do Medidor
BillingMessagesProcessado Mensagens de faturação processadas de palavras Total Métrica de faturação para o número de mensagens enviadas da Azure Digital Twins para pontos finais externos.

Para ser considerada uma única mensagem para efeitos de faturação, uma carga útil não deve ser superior a 1 KB. As cargas superiores a este limite serão contadas como mensagens adicionais em incrementos de 1 KB (por isso, uma mensagem entre 1 KB e 2 KB será contada como 2 mensagens, entre 2 KB e 3 KB serão 3 mensagens, e assim por diante).
Esta restrição também se aplica às respostas, pelo que uma chamada que devolve 1,5 KB no organismo de resposta, por exemplo, será faturada como 2 operações.
ID do Medidor
BillingQueryUnits Unidades de consulta de faturação de palavras Total O número de Unidades de Consulta, uma medida internamente calculada de utilização de recursos de serviço, consumido para executar consultas. Há também um API ajudante disponível para medir Unidades de Consulta: Classe QueryChargeHelper ID do Medidor

Para mais informações sobre a forma como a Azure Digital Twins é faturada, consulte os preços da Azure Digital Twins.

Métricas de ingress

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

Metric Nome de exibição métrica Unidade Tipo de agregação Description Dimensões
IngresssEvents Eventos Ingress de palavras Total O número de eventos de telemetria a entrar em Azure Digital Twins. Resultado
IngressEventsFailureRate Taxa de ingresss Percentagem Média A percentagem de eventos de telemetria de entrada para os quais o serviço devolve um código de resposta de erro interno (500). Resultado
IngresssEventsLatency Ingresss Eventos Latência Milissegundos Média O momento em que um evento chega até quando está pronto para ser expulso pela Azure Digital Twins, altura em que o serviço envia um resultado de sucesso/falha. Resultado

Métricas de encaminhamento

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

Metric Nome de exibição métrica Unidade Tipo de agregação Description Dimensões
Mensagens Remedidas Mensagens encaminhadas de palavras Total O número de mensagens encaminhada para um serviço Azure de ponto final, como Os Centros de Eventos, Service Bus ou Grade de Eventos. Tipo ponto final,
Resultado
EncaminhamentoFailureRate Taxa de falha de encaminhamento Percentagem Média A percentagem de eventos que resultam num erro ao serem encaminhados da Azure Digital Twins para um serviço Azure de ponto final, como Os Centros de Eventos, Service Bus ou Grade de Eventos. Tipo ponto final,
Resultado
Encaminhamento Latência de encaminhamento Milissegundos Média O tempo decorreu entre um evento que foi encaminhado de Azure Digital Twins para quando é publicado no serviço Azure de ponto final, como Event Hubs, Service Bus ou Event Grid. Tipo ponto final,
Resultado

Dimensões

As dimensões ajudam a identificar mais detalhes sobre as métricas. Algumas das métricas de encaminhamento fornecem informações por ponto final. O quadro abaixo lista valores possíveis para estas dimensões.

Dimensão Valores
Autenticação OAuth
Operação (para Pedidos 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/modelos/read,
Microsoft.DigitalTwins/modelos/write,
Microsoft.DigitalTwins/models/delete,
Microsoft.DigitalTwins/consulta/ação
Tipo de ponto final Grelha de Eventos,
Centros de Eventos,
Service Bus
Protocolo HTTPS
Resultado Sucesso,
Falha
Código de Estado 200, 404, 500, e assim por diante.
Classe código de estado 2xx, 4xx, 5xx, e assim por diante.
Texto de estado Erro interno do servidor, não encontrado, e assim por diante.

Passos seguintes

Para saber mais sobre a gestão das métricas gravadas para a Azure Digital Twins, consulte o Monitor com registos de diagnósticos.