Referência de dados de monitoramento do Hub IoT do Azure

Artigo
09/25/2024

Este artigo contém todas as informações de referência de monitoramento para este serviço.

Consulte Monitorar o Azure IoT para obter detalhes sobre os dados que você pode coletar para o Hub IoT e como usá-los.

Métrica

Esta seção lista todas as métricas da plataforma coletadas automaticamente para este serviço. Essas métricas também fazem parte da lista global de todas as métricas da plataforma com suporte no Azure Monitor.

Para obter informações sobre retenção de métricas, consulte Visão geral das métricas do Azure Monitor.

Métricas com suporte para Microsoft.Devices/IoTHubs

A tabela a seguir lista as métricas disponíveis para o tipo de recurso Microsoft.Devices/IoTHubs.

Nem todas as colunas podem estar presentes em todas as tabelas.
Algumas colunas podem estar além da área de visualização da página. Selecione Expandir tabela para exibir todas as colunas disponíveis.

Títulos de tabela

Categoria: o grupo ou classificação de métricas.
Métrica: o nome de exibição da métrica como aparece no portal do Azure.
Nome na API REST: o nome da métrica, conforme mencionado na API REST.
Unidade: unidade de medida
Agregação: o tipo de agregação padrão. Valores válidos: Médio (Méd.), Mínimo (Mín.), Máximo (Máx.), Total (Soma), Contagem.
Dimensões: as Dimensões disponíveis para a métrica.
Intervalos de agregação: os Intervalos em que a métrica é amostrada. Por exemplo, PT1M indica que a métrica é amostrada a cada minuto, PT30M a cada 30 minutos, PT1H a cada hora e assim por diante.
Exportação de DS: se a métrica é exportável para os Logs do Azure Monitor via configurações de diagnóstico. Para obter mais informações sobre exportação de métricas, consulte as Criar configurações de diagnóstico no Azure Monitor.

Métrica	Nome na API REST	Unidade	Agregação	Dimensões	Granularidade de tempo	Exportação de DS
Mensagens C2D abandonadas Número de mensagens da nuvem para o dispositivo abandonadas pelo dispositivo	`c2d.commands.egress.abandon.success`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Entregas de mensagens C2D concluídas Número de entregas de mensagens da nuvem para o dispositivo concluídas com sucesso pelo dispositivo	`c2d.commands.egress.complete.success`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Mensagens C2D rejeitadas Número de mensagens da nuvem para o dispositivo rejeitadas pelo dispositivo	`c2d.commands.egress.reject.success`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Chamadas de método direto com falha A contagem de todas as chamadas de método diretas com falhas.	`c2d.methods.failure`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Tamanho da solicitação de invocações diretas de método A média, o mínimo e o máximo de todas as solicitações de método diretas bem-sucedidas.	`c2d.methods.requestSize`	Bytes	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Tamanho da resposta de invocações diretas de método A média, o mínimo e o máximo de todas as respostas de método diretas bem-sucedidas.	`c2d.methods.responseSize`	Bytes	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Invocações de método direto bem-sucedidas A contagem de todas as chamadas de método diretas bem-sucedidas.	`c2d.methods.success`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Leituras gêmeas com falha do back-end A contagem de todas as falhas de leituras de gêmeos iniciadas pelo back-end.	`c2d.twin.read.failure`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Tamanho da resposta de leituras gêmeas do back-end A média, o mínimo e o máximo de todas as leituras de gêmeos bem-sucedidas iniciadas pelo back-end.	`c2d.twin.read.size`	Bytes	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Leituras gêmeas bem-sucedidas do back-end A contagem de todas as leituras de gêmeos bem-sucedidas iniciadas pelo back-end.	`c2d.twin.read.success`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Atualizações gêmeas com falha do back-end A contagem de todas as falhas de atualizações de gêmeos iniciadas pelo back-end.	`c2d.twin.update.failure`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Tamanho das atualizações gêmeas do back-end A média, o mínimo e o máximo de todas as atualizações de gêmeos iniciadas pelo back-end bem-sucedidas.	`c2d.twin.update.size`	Bytes	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Atualizações gêmeas bem-sucedidas do back-end A contagem de todas as atualizações de gêmeos iniciadas pelo back-end bem-sucedidas.	`c2d.twin.update.success`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Mensagens C2D expiradas Número de mensagens de nuvem para o dispositivo expiradas	`C2DMessagesExpired`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Métricas de configuração Métricas para operações de configuração	`configurations`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Dispositivos conectados Número de dispositivos registrados ao seu hub IoT	`connectedDeviceCount`	Count	Médio, Máximo, Mínimo	<none>	PT1M	Não
Roteamento: mensagens entregues a mensagens/eventos O número de vezes que o roteamento do Hub IoT entregou com êxito mensagens ao ponto de extremidade interno (mensagens/eventos).	`d2c.endpoints.egress.builtIn.events`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Roteamento: mensagens entregues ao Hub de Eventos O número de vezes que o roteamento do Hub IoT entregou com êxito mensagens aos pontos de extremidade do Hub de Eventos.	`d2c.endpoints.egress.eventHubs`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Roteamento: mensagens entregues à Fila do Barramento de Serviço O número de vezes que o roteamento do Hub IoT entregou com êxito mensagens aos pontos de extremidade da fila do Barramento de Serviço.	`d2c.endpoints.egress.serviceBusQueues`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Roteamento: mensagens entregues ao Tópico do Barramento de Serviço O número de vezes que o roteamento do Hub IoT entregou com êxito mensagens aos pontos de extremidade do tópico do Barramento de Serviço.	`d2c.endpoints.egress.serviceBusTopics`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Roteamento: mensagens entregues ao armazenamento O número de vezes que o roteamento do Hub IoT entregou com êxito mensagens aos pontos de extremidade de armazenamento.	`d2c.endpoints.egress.storage`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Roteamento: blobs entregues ao armazenamento O número de vezes que o roteamento do Hub IoT entregou blobs aos pontos de extremidade de armazenamento.	`d2c.endpoints.egress.storage.blobs`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Roteamento: dados entregues ao armazenamento A quantidade de dados (bytes) de roteamento do Hub IoT entregue aos pontos de extremidade de armazenamento.	`d2c.endpoints.egress.storage.bytes`	Bytes	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Roteamento: latência de mensagem para mensagens/eventos A latência média (milissegundos) entre a entrada da mensagem no Hub IoT e a entrada da mensagem de telemetria no ponto de extremidade interno (mensagens/eventos).	`d2c.endpoints.latency.builtIn.events`	MilliSeconds	Média, Mínimo, Máximo	<none>	PT1M	Sim
Roteamento: latência de mensagem para o Hub de Eventos A latência média (milissegundos) entre a entrada da mensagem no Hub IoT e a entrada da mensagem em um ponto de extremidade do Hub de Eventos.	`d2c.endpoints.latency.eventHubs`	MilliSeconds	Média, Mínimo, Máximo	<none>	PT1M	Sim
Roteamento: latência de mensagem para a Fila do Barramento de Serviço A latência média (milissegundos) entre a entrada da mensagem no Hub IoT e a entrada da mensagem de telemetria em um ponto de extremidade da fila do Barramento de Serviço.	`d2c.endpoints.latency.serviceBusQueues`	MilliSeconds	Média, Mínimo, Máximo	<none>	PT1M	Sim
Roteamento: latência de mensagem para o tópico do Barramento de Serviço A latência média (milissegundos) entre a entrada da mensagem no Hub IoT e a entrada da mensagem de telemetria em um ponto de extremidade do tópico do Barramento de Serviço.	`d2c.endpoints.latency.serviceBusTopics`	MilliSeconds	Média, Mínimo, Máximo	<none>	PT1M	Sim
Roteamento: latência de mensagem para armazenamento A latência média (milissegundos) entre a entrada da mensagem no Hub IoT e a entrada da mensagem de telemetria em um ponto de extremidade de armazenamento.	`d2c.endpoints.latency.storage`	MilliSeconds	Média, Mínimo, Máximo	<none>	PT1M	Sim
Roteamento: mensagens de telemetria descartadas O número de vezes que as mensagens foram removidas pelo roteamento do Hub IoT devido à inatividade dos pontos de extremidade. Esse valor não conta as mensagens entregues à rota de fallback, pois as mensagens removidas não são entregues.	`d2c.telemetry.egress.dropped`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Roteamento: mensagens entregues para fallback O número de vezes que o roteamento do Hub IoT entregou mensagens ao ponto de extremidade associado à rota de fallback.	`d2c.telemetry.egress.fallback`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Roteamento: mensagens de telemetria incompatíveis O número de vezes que o roteamento do Hub IoT não conseguiu entregar mensagens devido a uma incompatibilidade com o ponto de extremidade. Esse valor não inclui novas tentativas.	`d2c.telemetry.egress.invalid`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Roteamento: mensagens de telemetria órfãs O número de vezes que as mensagens ficaram órfãos do roteamento do Hub IoT porque não correspondiam a nenhuma regra de roteamento (incluindo a regra de fallback).	`d2c.telemetry.egress.orphaned`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Roteamento: mensagens de telemetria entregues O número de vezes que as mensagens foram entregues com êxito a todos os pontos de extremidade usando o roteamento do Hub IoT. Se uma mensagem é encaminhada para vários pontos de extremidade, esse valor aumenta em um para cada entrega bem-sucedida. Se uma mensagem é entregue ao mesmo ponto de extremidade várias vezes, esse valor aumenta em um para cada entrega bem-sucedida.	`d2c.telemetry.egress.success`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Tentativas de envio de mensagens de telemetria Número de tentativas de envio de mensagens de telemetria do dispositivo para nuvem para o hub IoT	`d2c.telemetry.ingress.allProtocol`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Número de erros de limitação Número de erros de limitação devido a limitações da taxa de transferência do dispositivo	`d2c.telemetry.ingress.sendThrottle`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Mensagens de telemetria enviadas Número de mensagens de telemetria do dispositivo para nuvem enviadas com êxito para o hub IoT	`d2c.telemetry.ingress.success`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Falhas nas leituras gêmeas dos dispositivos A contagem de todas as leituras de gêmeos iniciadas pelo dispositivo com falhas.	`d2c.twin.read.failure`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Tamanho da resposta de leituras gêmeas de dispositivos A média, o mínimo e o máximo de todas as leituras de gêmeos iniciadas pelo dispositivo bem-sucedidas.	`d2c.twin.read.size`	Bytes	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Leituras gêmeas bem-sucedidas de dispositivos A contagem de todas as leituras de gêmeos iniciadas pelo dispositivo bem-sucedidas.	`d2c.twin.read.success`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Atualizações gêmeas com falha de dispositivos A contagem de todas as atualizações de gêmeos iniciadas pelo dispositivo.	`d2c.twin.update.failure`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Tamanho das atualizações gêmeas de dispositivos A média, o mínimo e o máximo de todas as atualizações de gêmeos iniciadas pelo dispositivo bem-sucedidas.	`d2c.twin.update.size`	Bytes	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Atualizações gêmeas bem-sucedidas de dispositivos A contagem de todas as atualizações de gêmeos iniciadas pelo dispositivo bem-sucedidas.	`d2c.twin.update.success`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Número total de mensagens usadas Número total de mensagens usadas hoje	`dailyMessageQuotaUsed`	Count	Média, Mínimo, Máximo	<none>	PT1M	Sim
Uso total de dados do dispositivo Bytes transferidos entre todos os dispositivos conectados ao lotHub	`deviceDataUsage`	Bytes	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Uso total de dados do dispositivo (versão prévia) Bytes transferidos entre todos os dispositivos conectados ao lotHub	`deviceDataUsageV2`	Bytes	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Dispositivos conectados (descontinuado) Número de dispositivos registrados ao seu hub IoT	`devices.connectedDevices.allProtocol`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Total de dispositivos (preterido) Número de dispositivos registrados para o seu hub IoT	`devices.totalDevices`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Entregas da Grade de Eventos O número de eventos do Hub IoT publicados na grade de eventos. Use a dimensão de resultado para o número de solicitações bem-sucedidas e com falha. A dimensão EventType mostra o tipo de evento (https://aka.ms/ioteventgrid).	`EventGridDeliveries`	Count	Média, Mínimo, Máximo, Total (Soma)	`Result`, `EventType`	PT1M	Sim
Latência da Grade de Eventos A latência média (milissegundos) de quando o evento do Hub foi gerado para quando o evento foi publicado na grade de eventos. Esse número é uma média entre todos os tipos de evento. Use a dimensão EventType para ver a latência de um tipo específico de evento.	`EventGridLatency`	MilliSeconds	Média, Mínimo, Máximo	`EventType`	PT1M	Sim
Cancelamentos de trabalho com falha A contagem de todas as chamadas para cancelar um trabalho com falhas.	`jobs.cancelJob.failure`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Cancelamentos de trabalho bem-sucedidos A contagem de todas as chamadas para cancelar um trabalho bem-sucedidas.	`jobs.cancelJob.success`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Trabalhos concluídos A contagem de todos os trabalhos concluídos.	`jobs.completed`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Criações com falha de trabalhos de invocação de método A contagem de todas as criações de trabalhos de invocação de método direto com falhas.	`jobs.createDirectMethodJob.failure`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Criações bem-sucedidas de trabalhos de invocação de método A contagem de todas as criações de trabalhos de invocação de método direto bem-sucedidas.	`jobs.createDirectMethodJob.success`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Criações com falha de trabalhos de atualização de gêmeos A contagem de todos os trabalhos de criação de atualização de gêmeos com falhas.	`jobs.createTwinUpdateJob.failure`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Criações bem-sucedidas de trabalhos de atualização gêmeos A contagem de todos os trabalhos de criação de atualização de gêmeos bem-sucedidos.	`jobs.createTwinUpdateJob.success`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Trabalhos com falha A contagem de todos os trabalhos com falha.	`jobs.failed`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Chamadas com falha para listar trabalhos A contagem de todas as chamadas para listar trabalhos com falhas.	`jobs.listJobs.failure`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Chamadas bem-sucedidas para listar trabalhos A contagem de todas as chamadas para listar trabalhos bem-sucedidas.	`jobs.listJobs.success`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Consultas de trabalho com falha A contagem de todas as chamadas para consultas de trabalho com falhas.	`jobs.queryJobs.failure`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Consultas de trabalho bem-sucedidas A contagem de todas as chamadas para consultas de trabalho bem-sucedidas.	`jobs.queryJobs.success`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Tamanho da mensagem de entrega de roteamento em bytes (versão prévia) O tamanho total em bytes das mensagens entregues pelo hub IoT a um ponto de extremidade. Você pode usar as dimensões EndpointName e EndpointType para exibir o tamanho em bytes das mensagens entregues aos diferentes pontos de extremidade. O valor de métrica aumenta para cada mensagem entregue, incluindo se a mensagem é entregue a vários pontos de extremidade ou se a mensagem é entregue ao mesmo ponto de extremidade várias vezes.	`RoutingDataSizeInBytesDelivered`	Bytes	Média, Mínimo, Máximo, Total (Soma)	`EndpointType`, `EndpointName`, `RoutingSource`	PT1M	Sim
Entregas de roteiro (versão prévia) O número de vezes que o Hub IoT tentou entregar mensagens a todos os pontos de extremidade usando o roteamento. Para ver o número de tentativas com êxito ou com falha, use a dimensão Resultado. Para ver o motivo da falha, como inválida, removida ou órfã, use a dimensão FailureReasonCategory. Você também pode usar as dimensões EndpointName e EndpointType para entender quantas mensagens foram entregues aos diferentes pontos de extremidade. O valor de métrica aumenta em um para cada tentativa de entrega, incluindo se a mensagem é entregue a vários pontos de extremidade ou se a mensagem é entregue ao mesmo ponto de extremidade várias vezes.	`RoutingDeliveries`	Count	Média, Mínimo, Máximo, Total (Soma)	`EndpointType`, `EndpointName`, `FailureReasonCategory`, `Result`, `RoutingSource`	PT1M	Sim
Latência de entrega de roteamento (versão prévia) A latência média (milissegundos) entre a entrada da mensagem no Hub IoT e a entrada da mensagem de telemetria em um ponto de extremidade. Você pode usar as dimensões EndpointName e EndpointType para entender a latência para os pontos de extremidade diferentes.	`RoutingDeliveryLatency`	MilliSeconds	Média, Mínimo, Máximo	`EndpointType`, `EndpointName`, `RoutingSource`	PT1M	Sim
Total de dispositivos Número de dispositivos registrados para o seu hub IoT	`totalDeviceCount`	Count	Médio, Máximo, Mínimo	<none>	PT1M	Não
Consultas gêmeas com falha A contagem de todas as consultas de gêmeos com falhas.	`twinQueries.failure`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Tamanho do resultado de consultas gêmeas A média, o mínimo e o máximo do tamanho do resultado de todas as consultas de gêmeos bem-sucedidas.	`twinQueries.resultSize`	Bytes	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim
Consultas gêmeas bem-sucedidas A contagem de todas as consultas de gêmeos bem-sucedidas.	`twinQueries.success`	Count	Média, Mínimo, Máximo, Total (Soma)	<none>	PT1M	Sim

Agregações com suporte

A coluna Tipo de Agregação na tabela corresponde à agregação padrão usada quando a métrica é selecionada para um gráfico ou alerta.

Captura de tela mostrando a agregação de métricas.

Para a maioria das métricas, todos os tipos de agregação são válidos. Para métricas de contagem com um valor de coluna Unit de Count, apenas algumas agregações são válidas. As métricas de contagem podem ser de um dos dois tipos:

Para métricas de contagem de Ponto único, o Hub IoT registra um único ponto de dados (essencialmente um 1) cada vez que a operação medida ocorre. Azure Monitor soma esses pontos de dados sobre a granularidade especificada. Exemplos de métricas de ponto único são Mensagens de telemetria enviadas e entregas de mensagens C2D concluídas. Para essas métricas, o único tipo de agregação relevante é Total (Soma). O portal permite que você escolha mínimo, máximo e médio. Esses valores são sempre 1.
Para métricas de contagem de instantâneos, o Hub IoT registra uma contagem total quando ocorre a operação medida. Atualmente, há três métricas de instantâneo emitidas pelo Hub IoT: Número total de mensagens usadas, Total de dispositivose Dispositivos conectados. Como essas métricas apresentam uma quantidade "total" todas as vezes, somá-las na granularidade especificada não faz sentido. Azure Monitor limita a seleção de média, mínimo e máximo para o tipo de agregação para essas métricas.

Dimensões de métrica

Para obter mais informações sobre o que são dimensões de métrica, confira Métricas multidimensionais.

Este serviço tem as dimensões a seguir associadas a essas métricas.

Nome da dimensão	Descrição
EndpointName	O nome do ponto de extremidade
EndpointType	`eventHubs`, `serviceBusQueues`, `cosmosDB`, `serviceBusTopics`, `builtin` ou `blobStorage`
EventType	`Microsoft.Devices.DeviceCreated`, `Microsoft.Devices.DeviceDeleted`, `Microsoft.Devices.DeviceConnected`, `Microsoft.Devices.DeviceDisconnected` ou `Microsoft.Devices.DeviceTelemetry` Para obter mais informações, consulte Tipos de eventos.
FailureReasonCategory	Um dos seguintes valores: `invalid`, `dropped`, `orphaned`, ou `null`.
Resultado	`success` ou `failure`
RoutingSource	`Device Messages`, `Twin Change Events`, `Device Lifecycle Events`

Nome de exibição e agregação das métricas

As tabelas a seguir fornecem mais informações sobre as métricas descritas na tabela anterior. Eles mostram as métricas da plataforma do Hub IoT por categoria geral e listam as métricas por seu nome de exibição, conforme atribuído no portal do Azure.

Métricas de comando da nuvem para o dispositivo:

Nome de exibição da métrica	Métrica	Unidade	Descrição
Mensagens C2D expiradas	C2DMessagesExpired	Count	Número de mensagens de nuvem para o dispositivo expiradas
Entregas de mensagem C2D concluídas	c2d.commands.egress.complete.success	Count	Número de entregas de mensagens da nuvem para o dispositivo concluídas com sucesso pelo dispositivo
Mensagens C2D abandonadas	c2d.commands.egress.abandon.success	Count	Número de mensagens da nuvem para o dispositivo abandonadas pelo dispositivo
Mensagens C2D rejeitadas	c2d.commands.egress.reject.success	Count	Número de mensagens da nuvem para o dispositivo rejeitadas pelo dispositivo

Para métricas com um valor de contagem em Unidade, somente a agregação total (Soma) é válida. As agregações mínima, máxima e média sempre retornam 1. Para obter mais informações, confira Agregações suportadas.

Métricas de métodos diretos da nuvem para o dispositivo:

Nome de exibição da métrica	Métrica	Unidade	Descrição
Invocações de método diretas com falhas	c2d.methods.failure	Count	A contagem de todas as chamadas de método diretas com falhas.
Tamanho da solicitação das invocações de método diretas	c2d.methods.requestSize	Bytes	A contagem de todas as solicitações de método diretas bem-sucedidas.
Tamanho da resposta das invocações de método diretas	c2d.methods.responseSize	Bytes	A contagem de todas as respostas de método diretas bem-sucedidas.
Invocações de método diretas bem-sucedidas	c2d.methods.success	Count	A contagem de todas as chamadas de método diretas bem-sucedidas.

Métricas de operações da nuvem para o dispositivo gêmeo:

Nome de exibição da métrica	Métrica	Unidade	Descrição
Leituras de gêmeos de back-end com falhas	c2d.twin.read.failure	Count	A contagem de todas as falhas de leituras de gêmeos iniciadas pelo back-end.
Atualizações de gêmeos de back-end com falhas	c2d.twin.update.failure	Count	A contagem de todas as falhas de atualizações de gêmeos iniciadas pelo back-end.
Tamanho da resposta das leituras de gêmeos de back-end	c2d.twin.read.size	Bytes	A contagem de todas as leituras de gêmeos bem-sucedidas iniciadas pelo back-end.
Tamanho das atualizações de gêmeos de back-end	c2d.twin.update.size	Bytes	A contagem de todas as atualizações de gêmeos iniciadas pelo back-end bem-sucedidas.
Leituras de gêmeos de back-end bem-sucedidas	c2d.twin.read.success	Count	A contagem de todas as leituras de gêmeos bem-sucedidas iniciadas pelo back-end.
Atualizações de gêmeos de back-end bem-sucedidas	c2d.twin.update.success	Count	A contagem de todas as atualizações de gêmeos iniciadas pelo back-end bem-sucedidas.

Métricas de configurações:

Nome de exibição da métrica	Métrica	Unidade	Descrição
Métricas de configuração	configurações	Count	Número total de operações CRUD executadas para a configuração do dispositivo e implantação de IoT Edge em um conjunto de dispositivos de destino. Inclui o número de operações que modificam o dispositivo gêmeo ou o módulo gêmeo por causa dessas configurações.

Métricas de cota diária:

Nome de exibição da métrica	Métrica	Unidade	Descrição
Uso total de dados do dispositivo	deviceDataUsage	Bytes	Bytes transferidos entre todos os dispositivos conectados ao lotHub
Uso total de dados de dispositivos (versão prévia)	deviceDataUsageV2	Total	Bytes transferidos entre todos os dispositivos conectados ao lotHub
Número total de mensagens usadas	dailyMessageQuotaUsed	Count	Número total de mensagens utilizadas hoje. Um valor cumulativo que é reiniciado para zero em 00:00 UTC diariamente.

Para o Número total de mensagens usadas, apenas as agregações mínima, máxima e média têm suporte. Para obter mais informações, confira Agregações suportadas.

Métricas do dispositivo:

Nome de exibição da métrica	Métrica	Unidade	Descrição
Total de dispositivos (preterido)	devices.totalDevices	Count	Número de dispositivos registrados para o seu hub IoT
Dispositivos conectados (preteridos)	devices.connectedDevices.allProtocol	Count	Número de dispositivos registrados ao seu hub IoT
Total de dispositivos	totalDeviceCount	Count	Número de dispositivos registrados para o seu hub IoT
Dispositivos conectados	connectedDeviceCount	Count	Número de dispositivos registrados ao seu hub IoT

Para Dispositivos totais (preteridos) e dispositivos conectados (preteridos) , somente a agregação total (Soma) é válida. As agregações mínima, máxima e média sempre retornam 1. Para obter mais informações, confira Agregações suportadas.

Para Dispositivos totais e dispositivos conectados, somente as agregações mínima, máxima e média são válidas. Para obter mais informações, confira Agregações suportadas.

O total de dispositivos e os dispositivos conectados não são exportáveis por meio de configurações de diagnóstico.

Métricas de telemetria do dispositivo:

Nome de exibição da métrica	Métrica	Unidade	Descrição
Número de erros de limitação	d2c.telemetry.ingress.sendThrottle	Count	Número de erros de limitação devido a limitações da taxa de transferência do dispositivo
Tentativas de 'envio de mensagem' de telemetria	d2c.telemetry.ingress.allProtocol	Count	Número de tentativas de envio de mensagens de telemetria do dispositivo para nuvem para o hub IoT
Mensagens de telemetria enviadas	d2c.telemetry.ingress.success	Count	Número de mensagens de telemetria do dispositivo para nuvem enviadas com êxito para o hub IoT

Métricas de operações do dispositivo para o gêmeo da nuvem:

Nome de exibição da métrica	Métrica	Unidade	Descrição
Leituras de gêmeos dos dispositivos com falhas	d2c.twin.read.failure	Count	A contagem de todas as leituras de gêmeos iniciadas pelo dispositivo com falhas.
Atualizações de gêmeos dos dispositivos com falhas	d2c.twin.update.failure	Count	A contagem de todas as atualizações de gêmeos iniciadas pelo dispositivo.
Tamanho da resposta das leituras de gêmeos dos dispositivos	d2c.twin.read.size	Bytes	O número de todas as leituras de gêmeos iniciadas pelo dispositivo bem-sucedidas.
Tamanho das atualizações de gêmeos dos dispositivos	d2c.twin.update.size	Bytes	O tamanho total de todas as atualizações de gêmeos iniciadas pelo dispositivo bem-sucedidas.
Leituras de gêmeos dos dispositivos bem-sucedidas	d2c.twin.read.success	Count	A contagem de todas as leituras de gêmeos iniciadas pelo dispositivo bem-sucedidas.
Atualizações de gêmeos dos dispositivos bem-sucedidas	d2c.twin.update.success	Count	A contagem de todas as atualizações de gêmeos iniciadas pelo dispositivo bem-sucedidas.

Métricas da Grade de Eventos:

Nome de exibição da métrica	Métrica	Unidade	Descrição
Entregas da Grade de Eventos	EventGridDeliveries	Count	O número de eventos do Hub IoT publicados na grade de eventos. Use a dimensão de resultado para o número de solicitações bem-sucedidas e com falha. A dimensão EventType mostra o tipo de evento (https://aka.ms/ioteventgrid).
Latência da Grade de Eventos	EventGridLatency	Milissegundos	A latência média (milissegundos) de quando o evento do Hub foi gerado para quando o evento foi publicado na grade de eventos. Esse número é uma média entre todos os tipos de evento. Use a dimensão EventType para ver a latência de um tipo específico de evento.

Métricas de trabalhos:

Nome de exibição da métrica	Métrica	Unidade	Descrição
Trabalhos concluídos	jobs.completed	Count	A contagem de todos os trabalhos concluídos.
Chamadas para listar trabalhos com falhas	jobs.listJobs.failure	Count	A contagem de todas as chamadas para listar trabalhos com falhas.
Criações de trabalhos de invocação de método com falhas	jobs.createDirectMethodJob.failure	Count	A contagem de todas as criações de trabalhos de invocação de método direto com falhas.
Criações de trabalhos de atualização de gêmeos com falhas	jobs.createTwinUpdateJob.failure	Count	A contagem de todos os trabalhos de criação de atualização de gêmeos com falhas.
Cancelamentos de trabalho com falhas	jobs.cancelJob.failure	Count	A contagem de todas as chamadas para cancelar um trabalho com falhas.
Consultas de trabalho com falhas	jobs.queryJobs.failure	Count	A contagem de todas as chamadas para consultas de trabalho com falhas.
Trabalhos com falha	jobs.failed	Count	A contagem de todos os trabalhos com falha.
Chamadas para listar trabalhos bem-sucedidas	jobs.listJobs.success	Count	A contagem de todas as chamadas para listar trabalhos bem-sucedidas.
Criações de trabalhos de invocação de método bem-sucedidas	jobs.createDirectMethodJob.success	Count	A contagem de todas as criações de trabalhos de invocação de método direto bem-sucedidas.
Criações de trabalhos de atualização de gêmeos bem-sucedidas	jobs.createTwinUpdateJob. sucesso	Count	A contagem de todos os trabalhos de criação de atualização de gêmeos bem-sucedidos.
Cancelamentos de trabalho bem-sucedidos	jobs.cancelJob.success	Count	A contagem de todas as chamadas para cancelar um trabalho bem-sucedidas.
Consultas de trabalho bem-sucedidas	jobs.queryJobs.success	Count	A contagem de todas as chamadas para consultas de trabalho bem-sucedidas.

Métricas de roteamento:

Nome de exibição da métrica	Métrica	Unidade	Descrição
Entregas de roteamento (versão prévia)	RoutingDeliveries	Count	A métrica de entrega de roteamento. Use as dimensões para identificar o status de entrega para um ponto de extremidade específico ou para uma fonte de roteamento específica.
Tamanho das mensagens de entrega de roteamento em bytes (versão prévia)	RoutingDataSizeInBytesDelivered	Bytes	O número total de bytes roteados pelo Hub IoT para o ponto de extremidade personalizado e o ponto de extremidade interno. Use as dimensões para identificar o tamanho dos dados roteados para um ponto de extremidade específico ou para uma fonte de roteamento específica.
Latência da entrega de roteamento (versão prévia)	RoutingDeliveryLatency	Milissegundos	A métrica de latência de entrega de roteamento. Use as dimensões para identificar a latência para um ponto de extremidade específico ou para uma fonte de roteamento específica.
Roteamento: blobs entregues ao armazenamento	d2c.endpoints.egress.storage.blobs	Count	O número de vezes que o roteamento do Hub IoT entregou blobs aos pontos de extremidade de armazenamento.
Roteamento: dados entregues ao armazenamento	d2c.endpoints.egress.storage.bytes	Bytes	A quantidade de dados (bytes) de roteamento do Hub IoT entregue aos pontos de extremidade de armazenamento.
Roteamento: latência de mensagem para Hubs de Eventos	d2c.endpoints.latency.eventHubs	Milissegundos	A latência média (milissegundos) entre a entrada da mensagem no Hub IoT e a entrada da mensagem em um ponto de extremidade personalizado do tipo Hubs de Eventos. As rotas de mensagens para ponto de extremidade interno (eventos) não estão incluídas.
Roteamento: latência de mensagem para a Fila do Barramento de Serviço	d2c.endpoints.latency.serviceBusQueues	Milissegundos	A latência média (milissegundos) entre a entrada da mensagem no Hub IoT e a entrada da mensagem em um ponto de extremidade da fila do Barramento de Serviço.
Roteamento: latência de mensagem para o Tópico do Barramento de Serviço	d2c.endpoints.latency.serviceBusTopics	Milissegundos	A latência média (milissegundos) entre a entrada da mensagem no Hub IoT e a entrada da mensagem em um ponto de extremidade do tópico do Barramento de Serviço.
Roteamento: latência de mensagem para mensagens/eventos	d2c.Endpoints.Latency.builtIn.Events	Milissegundos	A latência média (milissegundos) entre a entrada da mensagem no Hub IoT e a entrada da mensagem no ponto de extremidade interno (mensagens/eventos) e rota de fallback.
Roteamento: latência de mensagem para armazenamento	d2c.endpoints.latency.storage	Milissegundos	A latência média (milissegundos) entre a entrada da mensagem no Hub IoT e a entrada da mensagem em um ponto de extremidade de armazenamento.
Roteamento: mensagens entregues aos Hubs de Eventos	d2c.endpoints.egress.eventHubs	Count	O número de vezes que o roteamento do Hub IoT entregou com êxito mensagens aos pontos de extremidade personalizados do tipo Hubs de Eventos. As rotas de mensagens para ponto de extremidade interno (eventos) não estão incluídas.
Roteamento: mensagens entregues à Fila do Barramento de Serviço	d2c.endpoints.egress.serviceBusQueues	Count	O número de vezes que o roteamento do Hub IoT entregou com êxito mensagens aos pontos de extremidade da fila do Barramento de Serviço.
Roteamento: mensagens entregues ao Tópico do Barramento de Serviço	d2c.endpoints.egress.serviceBusTopics	Count	O número de vezes que o roteamento do Hub IoT entregou com êxito mensagens aos pontos de extremidade do tópico do Barramento de Serviço.
Roteamento: mensagens entregues ao fallback	d2c.telemetry.egress.fallback	Count	O número de vezes que o roteamento do Hub IoT entregou mensagens ao ponto de extremidade associado à rota de fallback.
Roteamento: mensagens entregues a mensagens/eventos	d2c.endpoints.egress.builtIn.events	Count	O número de vezes que o roteamento do Hub IoT entregou com êxito mensagens ao ponto de extremidade interno (mensagens/eventos) e rota de fallback.
Roteamento: mensagens entregues ao armazenamento	d2c.endpoints.egress.storage	Count	O número de vezes que o roteamento do Hub IoT entregou com êxito mensagens aos pontos de extremidade de armazenamento.
Roteamento: mensagens de telemetria entregues	d2c.telemetry.egress.success	Count	O número de vezes que as mensagens foram entregues com êxito a todos os pontos de extremidade usando o roteamento do Hub IoT. Se uma mensagem é encaminhada para vários pontos de extremidade, esse valor aumenta em um para cada entrega bem-sucedida. Se uma mensagem é entregue ao mesmo ponto de extremidade várias vezes, esse valor aumenta em um para cada entrega bem-sucedida.
Roteamento: mensagens de telemetria descartadas	d2c.telemetry.egress.dropped	Count	O número de vezes que o roteamento do Hub IoT descarta mensagens devido a pontos de extremidade inativos. Esse valor não conta as mensagens entregues à rota de fallback, pois as mensagens removidas não são entregues.
Roteamento: mensagens de telemetria incompatíveis	d2c.telemetry.egress.invalid	Count	O número de vezes que o roteamento do Hub IoT não conseguiu entregar mensagens devido a uma incompatibilidade com o ponto de extremidade. Uma mensagem é incompatível com um ponto de extremidade quando o Hub IoT tenta entregar a mensagem a um ponto de extremidade e falha com um erro não transitório. Mensagens inválidas não são repetidas. Esse valor não inclui novas tentativas.
Roteamento: mensagens de telemetria órfãs	d2c.telemetry.egress.orphaned	Count	O número de vezes que o roteamento do Hub IoT envia mensagens órfãs porque elas não correspondem a nenhuma consulta de roteamento, quando a rota de fallback está desabilitada.

Métricas de consulta gêmea:

Nome de exibição da métrica	Métrica	Unidade	Descrição
Consultas de gêmeos com falhas	twinQueries.failure	Count	A contagem de todas as consultas de gêmeos com falhas.
Consultas de gêmeos bem-sucedidas	twinQueries.success	Count	A contagem de todas as consultas de gêmeos bem-sucedidas.
Tamanho do resultado das consultas de gêmeos	twinQueries.resultSize	Bytes	O tamanho total do resultado de todas as consultas de gêmeos bem-sucedidas.

Logs de recursos

Esta seção lista os tipos de logs de recursos que você pode coletar para o este serviço. A seção extrai da lista de todos os tipos de categoria de logs de recursos com suporte no Azure Monitor.

Logs de recursos com suporte para Microsoft.Devices/IotHubs

Categoria	Nome de exibição da categoria	Tabela de log	Com suporte a plano de log básico	Com suporte a transformações de tempo-ingestão	Consultas de exemplo	Custos de exportação
`C2DCommands`	Comandos C2C	AzureDiagnostics Logs de vários recursos do Azure.	Não	Não	Consultas	Não
`C2DTwinOperations`	Operações de Gêmeos C2D	AzureDiagnostics Logs de vários recursos do Azure.	Não	Não	Consultas	Não
`Configurations`	Configurações	AzureDiagnostics Logs de vários recursos do Azure.	Não	Não	Consultas	Não
`Connections`	conexões	AzureDiagnostics Logs de vários recursos do Azure.	Não	Não	Consultas	Não
`D2CTwinOperations`	D2CTwinOperations	AzureDiagnostics Logs de vários recursos do Azure.	Não	Não	Consultas	Não
`DeviceIdentityOperations`	Operações de Identidade do Dispositivo	AzureDiagnostics Logs de vários recursos do Azure.	Não	Não	Consultas	Não
`DeviceStreams`	Fluxos de dispositivo (versão prévia)	AzureDiagnostics Logs de vários recursos do Azure.	Não	Não	Consultas	Não
`DeviceTelemetry`	Telemetria de Dispositivo	AzureDiagnostics Logs de vários recursos do Azure.	Não	Não	Consultas	Não
`DirectMethods`	Métodos diretos	AzureDiagnostics Logs de vários recursos do Azure.	Não	Não	Consultas	Não
`DistributedTracing`	Rastreamento Distribuído (Versão Prévia)	AzureDiagnostics Logs de vários recursos do Azure.	Não	Não	Consultas	Não
`FileUploadOperations`	Operações de Upload de Arquivo	AzureDiagnostics Logs de vários recursos do Azure.	Não	Não	Consultas	Não
`JobsOperations`	Operações de Trabalhos	AzureDiagnostics Logs de vários recursos do Azure.	Não	Não	Consultas	Não
`Routes`	Rotas	AzureDiagnostics Logs de vários recursos do Azure.	Não	Não	Consultas	Não
`TwinQueries`	Consultas de Gêmeos	AzureDiagnostics Logs de vários recursos do Azure.	Não	Não	Consultas	Não

As seções a seguir listam os tipos de categoria de log de recursos e os esquemas coletados para o Hub IoT do Azure. Os eventos são emitidos somente para erros em algumas categorias.

Categoria de comandos da nuvem para o dispositivo

A categoria de comandos da nuvem para o dispositivo rastreia erros que ocorrem no Hub IoT e são relacionados ao pipeline de mensagem da nuvem para o dispositivo. Essa categoria inclui erros que ocorrem ao:

Enviar mensagens de nuvem para dispositivo (como erros de remetente não autorizado),
Receber mensagens da nuvem para dispositivo (como erros de contagem de entrega excedida), e
Receber comentários de mensagem da nuvem para dispositivo (como erros de comentário expirados).

Essa categoria não capturará erros quando a mensagem da nuvem para dispositivo for entregue com êxito, mas for manipulada incorretamente pelo dispositivo.

{
    "records":
    [
        {
            "time": " UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "messageExpired",
            "category": "C2DCommands",
            "level": "Error",
            "resultType": "Event status",
            "resultDescription": "MessageDescription",
            "properties": "{\"deviceId\":\"<deviceId>\",\"messageId\":\"<messageId>\",\"messageSizeInBytes\":\"<messageSize>\",\"protocol\":\"Amqp\",\"deliveryAcknowledgement\":\"<None, NegativeOnly, PositiveOnly, Full>\",\"deliveryCount\":\"0\",\"expiryTime\":\"<timestamp>\",\"timeInSystem\":\"<timeInSystem>\",\"ttl\":<ttl>, \"EventProcessedUtcTime\":\"<UTC timestamp>\",\"EventEnqueuedUtcTime\":\"<UTC timestamp>\", \"maskedIpAddress\": \"<maskedIpAddress>\", \"statusCode\": \"4XX\"}",
            "location": "Resource location"
        }
    ]
}

Categoria de operações gêmeas da nuvem para o dispositivo

A categoria de operações de gêmeos de nuvem para dispositivo rastreia eventos iniciados pelo serviço em dispositivos gêmeos. Essas operações podem incluir obter gêmeo, atualizar ou substituir marcas e atualizar ou substituir propriedades desejadas.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "read",
            "category": "C2DTwinOperations",
            "level": "Information",
            "durationMs": "1",
            "properties": "{\"deviceId\":\"<deviceId>\",\"sdkVersion\":\"<sdkVersion>\",\"messageSize\":\"<messageSize>\"}",
            "location": "Resource location"
        }
    ]
}

Categoria de operações de gêmeo do dispositivo para a nuvem

A categoria de operações de gêmeos de dispositivo para nuvem rastreia eventos iniciados pelo dispositivo em dispositivos gêmeos. Essas operações podem incluir gêmeos, atualizar as propriedades relatadas e assinar as propriedades desejadas.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "update",
            "category": "D2CTwinOperations",
            "level": "Information",
            "durationMs": "1",
            "properties": "{\"deviceId\":\"<deviceId>\",\"protocol\":\"<protocol>\",\"authenticationType\":\"{\\\"scope\\\":\\\"device\\\",\\\"type\\\":\\\"sas\\\",\\\"issuer\\\":\\\"iothub\\\",\\\"acceptingIpFilterRule\\\":null}\"}",
            "location": "Resource location"
        }
    ]
}

Categoria Configurações

Os logs de configuração do Hub IoT rastreiam eventos e erros para o conjunto de recursos de gerenciamento automático de dispositivos.

{
    "records":
    [
         {
             "time": "2019-09-24T17:21:52Z",
             "resourceId": "Resource Id",
             "operationName": "ReadManyConfigurations",
             "category": "Configurations",
             "resultType": "",
             "resultDescription": "",
             "level": "Information",
             "durationMs": "17",
             "properties": "{\"configurationId\":\"\",\"sdkVersion\":\"2018-06-30\",\"messageSize\":\"0\",\"statusCode\":null}",
             "location": "southcentralus"
         }
    ]
}

Categoria Conexões

A categoria de conexões rastreia erros e eventos de conexão e desconexão de dispositivos de um Hub IoT. Esta categoria é útil para identificar tentativas de conexão não autorizadas e/ou alertas ao perder a conexão aos dispositivos.

Para obter o status de conexão confiável dos dispositivos, confira Monitorar o status da conexão do dispositivo.

{
   "records":
   [
        {
            "time": " UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "deviceConnect",
            "category": "Connections",
            "level": "Information",
            "properties": "{\"deviceId\":\"<deviceId>\",\"sdkVersion\":\"<sdkVersion>\",\"protocol\":\"<protocol>\",\"authType\":\"{\\\"scope\\\":\\\"device\\\",\\\"type\\\":\\\"sas\\\",\\\"issuer\\\":\\\"iothub\\\",\\\"acceptingIpFilterRule\\\":null}\",\"maskedIpAddress\":\"<maskedIpAddress>\"}",
            "location": "Resource location"
        }
    ]
}

Para obter informações detalhadas sobre como usar logs de conexões para monitorar a conectividade do dispositivo, confira Monitorar, diagnosticar e solucionar problemas de conectividade do dispositivo com o Hub IoT do Azure.

Categoria de operações de identidade do dispositivo

A categoria de operações de identidade do dispositivo rastreia erros que ocorrem quando você tenta criar, atualizar ou excluir uma entrada no registro de identidade do seu Hub IoT. O rastreamento dessa categoria é útil em cenários de provisionamento.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "get",
            "category": "DeviceIdentityOperations",
            "level": "Error",
            "resultType": "Event status",
            "resultDescription": "MessageDescription",
            "properties": "{\"maskedIpAddress\":\"<maskedIpAddress>\",\"deviceId\":\"<deviceId>\", \"statusCode\":\"4XX\"}",
            "location": "Resource location"
        }
    ]
}

Categoria de fluxos de dispositivo (versão prévia)

A categoria fluxos de dispositivo rastreia as interações solicitação-resposta enviadas a dispositivos individuais.

{
    "records":
    [
         {
             "time": "2019-09-19T11:12:04Z",
             "resourceId": "Resource Id",
             "operationName": "invoke",
             "category": "DeviceStreams",
             "resultType": "",
             "resultDescription": "",    
             "level": "Information",
             "durationMs": "74",
             "properties": "{\"deviceId\":\"myDevice\",\"moduleId\":\"myModule\",\"sdkVersion\":\"2019-05-01-preview\",\"requestSize\":\"3\",\"responseSize\":\"5\",\"statusCode\":null,\"requestName\":\"myRequest\",\"direction\":\"c2d\"}",
             "location": "Central US"
         }
    ]
}

Categoria de telemetria do dispositivo

A categoria de telemetria de dispositivo rastreia erros que ocorrem no Hub IoT e estão relacionados ao pipeline de telemetria. Essa categoria inclui erros que ocorrem no envio de eventos de telemetria (como limitação) e no recebimento de eventos de telemetria (como leitor não autorizado). Essa categoria não pode capturar erros causados pelo código em execução no próprio dispositivo.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "ingress",
            "category": "DeviceTelemetry",
            "level": "Error",
            "resultType": "Event status",
            "resultDescription": "MessageDescription",
            "properties": "{\"deviceId\":\"<deviceId>\",\"batching\":\"0\",\"messageSizeInBytes\":\"<messageSizeInBytes>\",\"EventProcessedUtcTime\":\"<UTC timestamp>\",\"EventEnqueuedUtcTime\":\"<UTC timestamp>\",\"partitionId\":\"1\"}", 
            "location": "Resource location"
        }
    ]
}

Categoria de métodos diretos

A categoria de métodos diretos rastreia as interações solicitação-resposta enviadas a dispositivos individuais. Essas solicitações são iniciadas na nuvem.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "send",
            "category": "DirectMethods",
            "level": "Information",
            "durationMs": "1",
            "properties": "{\"deviceId\":<messageSize>, \"RequestSize\": 1, \"ResponseSize\": 1, \"sdkVersion\": \"2017-07-11\"}",
            "location": "Resource location"
        }
    ]
}

Categoria de rastreamento distribuído (versão prévia)

A categoria de rastreamento distribuído rastreia as IDs de correlação para mensagens que carregam o cabeçalho de contexto de rastreamento. Para habilitar completamente esses logs, o código do cliente deve ser atualizado seguindo Analisar e diagnosticar aplicativos IoT de ponta a ponta com rastreamento distribuído do Hub IoT (versão prévia).

O correlationId está em conformidade com a proposta Contexto de Rastreamento do W3C, em que ele contém trace-id e um span-id.

Logs D2C do Hub IoT (dispositivo para nuvem)

O Hub IoT registra esse log quando uma mensagem que contém propriedades de rastreamento válidas chega ao Hub IoT.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "DiagnosticIoTHubD2C",
            "category": "DistributedTracing",
            "correlationId": "00-8cd869a412459a25f5b4f31311223344-0144d2590aacd909-01",
            "level": "Information",
            "resultType": "Success",
            "resultDescription":"Receive message success",
            "durationMs": "",
            "properties": "{\"messageSize\": 1, \"deviceId\":\"<deviceId>\", \"callerLocalTimeUtc\": : \"2017-02-22T03:27:28.633Z\", \"calleeLocalTimeUtc\": \"2017-02-22T03:27:28.687Z\"}",
            "location": "Resource location"
        }
    ]
}

Aqui, durationMs não é calculado, uma vez que o relógio do Hub IoT não pode ser sincronizado com o relógio do dispositivo e, portanto, um cálculo de duração pode ser enganoso. Recomendamos gravar escrever lógica usando carimbos de data/hora na seção properties para capturar os picos na latência de dispositivo para nuvem.

Propriedade	Type	Descrição
messageSize	Integer	O tamanho da mensagem de dispositivo para nuvem em bytes
deviceId	Cadeia de caracteres alfanumérica ASCII de 7 bits	A identidade do dispositivo
callerLocalTimeUtc	Carimbo de data/hora UTC	A hora de criação da mensagem conforme relatada pelo relógio local do dispositivo
calleeLocalTimeUtc	Carimbo de data/hora UTC	A hora de chegada da mensagem no gateway do Hub IoT conforme relatado pelo relógio do lado do serviço de Hub IoT

Logs de entrada do Hub IoT

O Hub IoT registra esse log quando a mensagem que contém as propriedades de rastreamento válido grava nos Hubs de Eventos interno ou integrado.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "DiagnosticIoTHubIngress",
            "category": "DistributedTracing",
            "correlationId": "00-8cd869a412459a25f5b4f31311223344-349810a9bbd28730-01",
            "level": "Information",
            "resultType": "Success",
            "resultDescription":"Ingress message success",
            "durationMs": "10",
            "properties": "{\"isRoutingEnabled\": \"true\", \"parentSpanId\":\"0144d2590aacd909\"}",
            "location": "Resource location"
        }
    ]
}

Na seção properties, esse log contém informações adicionais sobre a entrada da mensagem.

Propriedade	Type	Descrição
isRoutingEnabled	String	Verdadeiro ou falso, indica se o roteamento de mensagens está ou não habilitado no Hub IoT
parentSpanId	String	A ID do span da mensagem pai, que seria, neste caso, o rastreamento de mensagens D2C

Logs de saída do Hub IoT

O Hub IoT registra esse log quando roteamento está habilitado e a mensagem é gravada para um ponto de extremidade. Se o roteamento não estiver habilitado, o Hub IoT não registrará esse log.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "DiagnosticIoTHubEgress",
            "category": "DistributedTracing",
            "correlationId": "00-8cd869a412459a25f5b4f31311223344-98ac3578922acd26-01",
            "level": "Information",
            "resultType": "Success",
            "resultDescription":"Egress message success",
            "durationMs": "10",
            "properties": "{\"endpointType\": \"EventHub\", \"endpointName\": \"myEventHub\", \"parentSpanId\":\"349810a9bbd28730\"}",
            "location": "Resource location"
        }
    ]
}

Na seção properties, esse log contém informações adicionais sobre a entrada da mensagem.

Propriedade	Type	Descrição
endpointName	String	O nome do ponto de extremidade de roteamento
endpointType	String	O tipo de roteamento o ponto de extremidade
parentSpanId	String	A ID do span da mensagem pai, que seria, neste caso, o rastreamento de mensagens de entrada do Hub IoT

Categoria de operações de upload de arquivo

A categoria de carregamento de arquivo rastreia erros que ocorrem no Hub IoT e estão relacionados à funcionalidade de carregamento de arquivo. Essa categoria inclui:

Erros que ocorrem com o URI de SAS, como quando ele expirar antes que um dispositivo notifique o hub de um carregamento concluído.
Carregamentos com falha relatados pelo dispositivo.
Erros que ocorrem quando um arquivo não for encontrado no armazenamento durante a criação de mensagem de notificação do Hub IoT.

Essa categoria não pode capturar erros que ocorrem diretamente enquanto o dispositivo está carregando um arquivo no armazenamento.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "ingress",
            "category": "FileUploadOperations",
            "level": "Error",
            "resultType": "Event status",
            "resultDescription": "MessageDescription",
            "durationMs": "1",
            "properties": "{\"deviceId\":\"<deviceId>\",\"protocol\":\"<protocol>\",\"authType\":\"{\\\"scope\\\":\\\"device\\\",\\\"type\\\":\\\"sas\\\",\\\"issuer\\\":\\\"iothub\\\",\\\"acceptingIpFilterRule\\\":null}\",\"blobUri\":\"http//bloburi.com\"}",
            "location": "Resource location"
        }
    ]
}

Categoria de operações de trabalhos

A categoria de operações de trabalhos relata sobre solicitações de trabalho para atualizar dispositivos gêmeos ou invocar métodos diretos em vários dispositivos. Essas solicitações são iniciadas na nuvem.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "jobCompleted",
            "category": "JobsOperations",
            "level": "Information",
            "durationMs": "1",
            "properties": "{\"jobId\":\"<jobId>\", \"sdkVersion\": \"<sdkVersion>\",\"messageSize\": <messageSize>,\"filter\":\"DeviceId IN ['1414ded9-b445-414d-89b9-e48e8c6285d5']\",\"startTimeUtc\":\"Wednesday, September 13, 2017\",\"duration\":\"0\"}",
            "location": "Resource location"
        }
    ]
}

Categoria de rotas

A categoria roteamento de mensagem acompanha os erros que ocorrem durante a avaliação da rota da mensagem e da integridade do ponto de extremidade, conforme visto pelo Hub IoT. Essa categoria inclui eventos, como:

Uma regra é avaliada como "indefinida"
Hub IoT marca um ponto de extremidade como morto
Quaisquer erros recebidos de um ponto de extremidade

Essa categoria não inclui erros específicos sobre as próprias mensagens (como erros de limitação de dispositivo), que são relatados na categoria "telemetria de dispositivo".

{
    "records":
    [
        {
            "time":"2019-12-12T03:25:14Z",
            "resourceId":"/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/ANON-TEST/PROVIDERS/MICROSOFT.DEVICES/IOTHUBS/ANONHUB1",
            "operationName":"endpointUnhealthy",
            "category":"Routes",
            "level":"Error",
            "resultType":"403004",
            "resultDescription":"DeviceMaximumQueueDepthExceeded",
            "properties":"{\"deviceId\":null,\"endpointName\":\"anon-sb-1\",\"messageId\":null,\"details\":\"DeviceMaximumQueueDepthExceeded\",\"routeName\":null,\"statusCode\":\"403\"}",
            "location":"westus"
        }
    ]
}

Aqui estão mais detalhes sobre os logs de recursos de roteamento:

Categoria de consultas gêmeas

A categoria de consultas de gêmeos relata sobre solicitações de consulta para dispositivos gêmeos que são iniciados na nuvem.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "query",
            "category": "TwinQueries",
            "level": "Information",
            "durationMs": "1",
            "properties": "{\"query\":\"<twin query>\",\"sdkVersion\":\"<sdkVersion>\",\"messageSize\":\"<messageSize>\",\"pageSize\":\"<pageSize>\", \"continuation\":\"<true, false>\", \"resultSize\":\"<resultSize>\"}",
            "location": "Resource location"
        }
    ]
}

Tabelas de Logs do Azure Monitor

Esta seção lista todas as tabelas dos Logs do Azure Monitor relevantes para este serviço e disponíveis para consulta pela análise de logs usando o Kusto. As tabelas contêm dados de log de recursos e possivelmente mais, dependendo do que é coletado e roteado para elas.

IoT Hub Microsoft.Devices/IotHubs

Log de atividades

A tabela vinculada lista as operações que podem ser registradas no log de atividades desse serviço. Essas operações são um subconjunto de todas as operações do provedor de recursos possíveis no log de atividades.

Para obter mais informações sobre o esquema de entradas do log de atividades, confira Esquema do log de atividades.

Operações do provedor de recursos Microsoft.Devices

Consulte Monitorar o Hub IoT do Azure para obter uma descrição do monitoramento do Hub IoT.
Confira Monitorar recursos do Azure com o Azure Monitor para ver informações detalhadas sobre o monitoramento dos recursos do Azure.

Compartilhar via

Referência de dados de monitoramento do Hub IoT do Azure

Métrica

Métricas com suporte para Microsoft.Devices/IoTHubs

Agregações com suporte

Dimensões de métrica

Nome de exibição e agregação das métricas

Logs de recursos

Logs de recursos com suporte para Microsoft.Devices/IotHubs

Categoria de comandos da nuvem para o dispositivo

Categoria de operações gêmeas da nuvem para o dispositivo

Categoria de operações de gêmeo do dispositivo para a nuvem

Categoria Configurações

Categoria Conexões

Categoria de operações de identidade do dispositivo

Categoria de fluxos de dispositivo (versão prévia)

Categoria de telemetria do dispositivo

Categoria de métodos diretos

Categoria de rastreamento distribuído (versão prévia)

Logs D2C do Hub IoT (dispositivo para nuvem)

Logs de entrada do Hub IoT

Logs de saída do Hub IoT

Categoria de operações de upload de arquivo

Categoria de operações de trabalhos

Categoria de rotas

Categoria de consultas gêmeas

Tabelas de Logs do Azure Monitor

IoT Hub Microsoft.Devices/IotHubs

Log de atividades

Comentários

Recursos adicionais

Compartilhar via

Referência de dados de monitoramento do Hub IoT do Azure

Métrica

Métricas com suporte para Microsoft.Devices/IoTHubs

Agregações com suporte

Dimensões de métrica

Nome de exibição e agregação das métricas

Logs de recursos

Logs de recursos com suporte para Microsoft.Devices/IotHubs

Categoria de comandos da nuvem para o dispositivo

Categoria de operações gêmeas da nuvem para o dispositivo

Categoria de operações de gêmeo do dispositivo para a nuvem

Categoria Configurações

Categoria Conexões

Categoria de operações de identidade do dispositivo

Categoria de fluxos de dispositivo (versão prévia)

Categoria de telemetria do dispositivo

Categoria de métodos diretos

Categoria de rastreamento distribuído (versão prévia)

Logs D2C do Hub IoT (dispositivo para nuvem)

Logs de entrada do Hub IoT

Logs de saída do Hub IoT

Categoria de operações de upload de arquivo

Categoria de operações de trabalhos

Categoria de rotas

Categoria de consultas gêmeas

Tabelas de Logs do Azure Monitor

IoT Hub Microsoft.Devices/IotHubs

Log de atividades

Conteúdo relacionado

Comentários

Recursos adicionais