Partilhar via


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

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étricas

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

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

Métricas suportadas 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 visualizar todas as colunas disponíveis.

Cabeçalhos de tabela

  • Categoria - O grupo ou classificação de métricas.
  • Métrica - O nome para exibição da métrica conforme aparece no portal do Azure.
  • Nome na API REST - O nome da métrica conforme referido na API REST.
  • Unidade - Unidade de medida.
  • Agregação - O tipo de agregação padrão. Valores válidos: Média (Média), Mínima (Mín), Máxima (Máx), Total (Soma), Contagem.
  • Dimensões - Dimensões disponíveis para a métrica.
  • Intervalos de grãos de - tempo 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.
  • DS Export- Se a métrica é exportável para os Logs do Azure Monitor por meio de configurações de diagnóstico. Para obter informações sobre como exportar métricas, consulte Criar configurações de diagnóstico no Azure Monitor.
Métrica Nome na API REST Unit Agregação Dimensões Grãos de tempo DS Exportação
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) <nenhum> PT1M Sim
Entregas de mensagens C2D concluídas

Número de entregas de mensagens da nuvem para o dispositivo concluídas com êxito pelo dispositivo
c2d.commands.egress.complete.success Count Média, Mínimo, Máximo, Total (Soma) <nenhum> 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) <nenhum> PT1M Sim
Invocações de método direto com falha

A contagem de todas as chamadas diretas de método com falha.
c2d.methods.failure Count Média, Mínimo, Máximo, Total (Soma) <nenhum> 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 direto bem-sucedidas.
c2d.methods.requestSize Bytes Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Tamanho da resposta das invocações diretas do método

A média, o mínimo e o máximo de todas as respostas diretas bem-sucedidas do método.
c2d.methods.responseSize Bytes Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Invocações diretas bem-sucedidas do método

A contagem de todas as chamadas diretas bem-sucedidas do método.
c2d.methods.success Count Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Leituras gêmeas com falha do back-end

A contagem de todos os gêmeos iniciados no back-end com falha é lida.
c2d.twin.read.failure Count Média, Mínimo, Máximo, Total (Soma) <nenhum> 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 iniciados no back-end bem-sucedidos.
c2d.twin.read.size Bytes Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Leituras gêmeas bem-sucedidas do back-end

A contagem de todos os gêmeos iniciados no back-end bem-sucedidos é lida.
c2d.twin.read.success Count Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Atualizações gêmeas com falha do back-end

A contagem de todas as atualizações gêmeas iniciadas no back-end com falha.
c2d.twin.update.failure Count Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Tamanho das atualizações gêmeas do back-end

O tamanho médio, mínimo e máximo de todas as atualizações gêmeas iniciadas com back-end bem-sucedidas.
c2d.twin.update.size Bytes Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Atualizações gêmeas bem-sucedidas do back-end

A contagem de todas as atualizações gêmeas iniciadas com back-end bem-sucedidas.
c2d.twin.update.success Count Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Mensagens C2D expiradas

Número de mensagens expiradas da nuvem para o dispositivo
C2DMessagesExpired Count Média, Mínimo, Máximo, Total (Soma) <nenhum> 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) <nenhum> PT1M Sim
Dispositivos conectados

Número de dispositivos conectados ao seu hub IoT
connectedDeviceCount Count Média, Máximo, Mínimo <nenhum> PT1M Não
Roteamento: mensagens entregues a mensagens/eventos

O número de vezes que o roteamento do Hub IoT entregou mensagens com êxito ao ponto de extremidade interno (mensagens/eventos).
d2c.endpoints.egress.builtIn.events Count Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Roteamento: mensagens entregues ao Hub de Eventos

O número de vezes que o roteamento do Hub IoT entregou mensagens com êxito aos pontos de extremidade do Hub de Eventos.
d2c.endpoints.egress.eventHubs Count Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Roteamento: mensagens entregues na fila do Service Bus

O número de vezes que o roteamento do Hub IoT entregou mensagens com êxito aos pontos de extremidade da fila do Barramento de Serviço.
d2c.endpoints.egress.serviceBusQueues Count Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Roteamento: mensagens entregues ao Service Bus Tópico

O número de vezes que o roteamento do Hub IoT entregou mensagens com êxito aos pontos de extremidade de tópico do Service Bus.
d2c.endpoints.egress.serviceBusTopics Count Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Roteamento: mensagens entregues ao armazenamento

O número de vezes que o roteamento do Hub IoT entregou mensagens com êxito aos pontos de extremidade de armazenamento.
d2c.endpoints.egress.storage Count Média, Mínimo, Máximo, Total (Soma) <nenhum> 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) <nenhum> PT1M Sim
Roteamento: dados entregues ao armazenamento

A quantidade de dados (bytes) de roteamento do Hub IoT entregues aos pontos de extremidade de armazenamento.
d2c.endpoints.egress.storage.bytes Bytes Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Roteamento: latência de mensagens para mensagens/eventos

A latência média (milissegundos) entre a entrada de mensagens no Hub IoT e a entrada de mensagens de telemetria no ponto de extremidade interno (mensagens/eventos).
d2c.endpoints.latency.builtIn.events Milissegundos Média, Mínimo, Máximo <nenhum> PT1M Sim
Roteamento: latência de mensagens para o Hub de Eventos

A latência média (milissegundos) entre a entrada de mensagens no Hub IoT e a entrada de mensagens em um ponto de extremidade do Hub de Eventos.
d2c.endpoints.latency.eventHubs Milissegundos Média, Mínimo, Máximo <nenhum> PT1M Sim
Roteamento: latência de mensagem para fila do Service Bus

A latência média (milissegundos) entre a entrada de mensagens no Hub IoT e a entrada de mensagens de telemetria em um ponto de extremidade de fila do Service Bus.
d2c.endpoints.latency.serviceBusQueues Milissegundos Média, Mínimo, Máximo <nenhum> PT1M Sim
Roteamento: latência de mensagem para o tópico do Service Bus

A latência média (milissegundos) entre a entrada de mensagens no Hub IoT e a entrada de mensagens de telemetria em um ponto de extremidade de tópico do Service Bus.
d2c.endpoints.latency.serviceBusTopics Milissegundos Média, Mínimo, Máximo <nenhum> PT1M Sim
Roteamento: latência de mensagens para armazenamento

A latência média (milissegundos) entre a entrada de mensagens no Hub IoT e a entrada de mensagens de telemetria em um ponto de extremidade de armazenamento.
d2c.endpoints.latency.storage Milissegundos Média, Mínimo, Máximo <nenhum> PT1M Sim
Roteamento: mensagens de telemetria descartadas

O número de vezes que as mensagens foram descartadas pelo roteamento do Hub IoT devido a pontos de extremidade mortos. Esse valor não conta as mensagens entregues na rota de fallback, pois as mensagens descartadas não são entregues lá.
d2c.telemetry.egress.dropped Count Média, Mínimo, Máximo, Total (Soma) <nenhum> 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) <nenhum> 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 tentativas.
d2c.telemetry.egress.invalid Count Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Roteamento: mensagens de telemetria órfãs

O número de vezes que as mensagens ficaram órfãs pelo 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) <nenhum> 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 for roteada para vários pontos de extremidade, esse valor aumentará em um para cada entrega bem-sucedida. Se uma mensagem for entregue ao mesmo ponto de extremidade várias vezes, esse valor aumentará em um para cada entrega bem-sucedida.
d2c.telemetry.egress.success Count Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Tentativas de envio de mensagens de telemetria

Número de mensagens de telemetria de dispositivo para nuvem que tentaram ser enviadas para seu hub IoT
d2c.telemetry.ingress.allProtocol Count Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Número de erros de limitação

Número de erros de limitação devido a aceleradores de taxa de transferência do dispositivo
d2c.telemetry.ingress.sendThrottle Count Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Mensagens de telemetria enviadas

Número de mensagens de telemetria de dispositivo para nuvem enviadas com êxito para seu hub IoT
d2c.telemetry.ingress.success Count Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Leituras gêmeas com falha de dispositivos

A contagem de todas as leituras gêmeas iniciadas por dispositivo com falha.
d2c.twin.read.failure Count Média, Mínimo, Máximo, Total (Soma) <nenhum> 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 gêmeas iniciadas por dispositivos bem-sucedidas.
d2c.twin.read.size Bytes Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Leituras gêmeas bem-sucedidas de dispositivos

A contagem de todos os gêmeos iniciados por dispositivos bem-sucedidos lê.
d2c.twin.read.success Count Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Atualizações gêmeas com falha de dispositivos

A contagem de todas as atualizações gêmeas iniciadas por dispositivo com falha.
d2c.twin.update.failure Count Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Tamanho das atualizações gêmeas dos dispositivos

O tamanho médio, mínimo e máximo de todas as atualizações gêmeas iniciadas pelo dispositivo com êxito.
d2c.twin.update.size Bytes Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Atualizações gêmeas bem-sucedidas de dispositivos

A contagem de todas as atualizações gêmeas iniciadas pelo dispositivo bem-sucedidas.
d2c.twin.update.success Count Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Número total de mensagens utilizadas

Número total de mensagens utilizadas atualmente
dailyMessageQuotaUsed Count Média, Mínimo, Máximo <nenhum> PT1M Sim
Utilização total de dados do dispositivo

Bytes transferidos de e para qualquer dispositivo conectado ao IotHub
deviceDataUsage Bytes Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Utilização total de dados do dispositivo (pré-visualização)

Bytes transferidos de e para qualquer dispositivo conectado ao IotHub
deviceDataUsageV2 Bytes Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Dispositivos conectados (preterido)

Número de dispositivos conectados ao seu hub IoT
devices.connectedDevices.allProtocol Count Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Total de dispositivos (preterido)

Número de dispositivos registados no seu hub IoT
devices.totalDevices Count Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Entregas da grelha de eventos

O número de eventos do Hub IoT publicados na Grade de Eventos. Use a dimensão 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) desde quando o evento do Hub Iot foi gerado até quando o evento foi publicado na Grade de Eventos. Este número é uma média entre todos os tipos de eventos. Use a dimensão EventType para ver a latência de um tipo específico de evento.
EventGridLatency Milissegundos Média, Mínimo, Máximo EventType PT1M Sim
Cancelamentos de trabalhos falhados

A contagem de todas as chamadas falhadas para cancelar um trabalho.
jobs.cancelJob.failure Count Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Cancelamentos de emprego bem-sucedidos

A contagem de todas as chamadas bem-sucedidas para cancelar um trabalho.
jobs.cancelJob.success Count Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Trabalhos concluídos

A contagem de todos os trabalhos concluídos.
jobs.completed Count Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Criações com falha de trabalhos de invocação de método

A contagem de todas as falhas na criação de trabalhos de invocação direta do método.
jobs.createDirectMethodJob.failure Count Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Criações bem-sucedidas de trabalhos de invocação de método

A contagem de todas as criações bem-sucedidas de trabalhos de invocação direta de métodos.
jobs.createDirectMethodJob.success Count Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Criações falhadas de trabalhos de atualização gêmeos

A contagem de todas as falhas na criação de trabalhos de atualização gêmeos.
jobs.createTwinUpdateJob.failure Count Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Criações bem-sucedidas de trabalhos de atualização gêmeos

A contagem de toda a criação bem-sucedida de empregos de atualização gêmeos.
jobs.createTwinUpdateJob.success Count Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Trabalhos com falha

A contagem de todos os trabalhos falhados.
jobs.failed Count Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Chamadas falhadas para listar trabalhos

A contagem de todas as chamadas falhadas para listar trabalhos.
jobs.listJobs.failure Count Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Chamadas bem-sucedidas para listar vagas

A contagem de todas as chamadas bem-sucedidas para listar trabalhos.
jobs.listJobs.success Count Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Consultas de trabalho com falha

A contagem de todas as chamadas com falha para consultar trabalhos.
jobs.queryJobs.failure Count Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Consultas de emprego bem-sucedidas

A contagem de todas as chamadas bem-sucedidas para trabalhos de consulta.
jobs.queryJobs.success Count Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Tamanho da mensagem de entrega de roteamento em bytes (visualização)

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 das mensagens em bytes entregues aos seus diferentes pontos de extremidade. O valor da métrica aumenta para cada mensagem entregue, inclusive se a mensagem for entregue a vários pontos de extremidade ou se a mensagem for entregue ao mesmo ponto de extremidade várias vezes.
RoutingDataSizeInBytesDelivered Bytes Média, Mínimo, Máximo, Total (Soma) EndpointType, EndpointName, RoutingSource PT1M Sim
Roteamento de entregas (visualização)

O número de vezes que o Hub IoT tentou entregar mensagens para todos os pontos de extremidade usando roteamento. Para ver o número de tentativas bem-sucedidas ou falhadas, use a dimensão Resultado. Para ver o motivo da falha, como inválido, descartado ou órfão, use a dimensão FailureReasonCategory. Você também pode usar as dimensões EndpointName e EndpointType para entender quantas mensagens foram entregues aos seus diferentes pontos de extremidade. O valor da métrica aumenta em um para cada tentativa de entrega, inclusive se a mensagem for entregue a vários pontos de extremidade ou se a mensagem for 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 (visualizaçã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. Você pode usar as dimensões EndpointName e EndpointType para entender a latência de seus diferentes pontos de extremidade.
RoutingDeliveryLatency Milissegundos Média, Mínimo, Máximo EndpointType, EndpointName, RoutingSource PT1M Sim
Total de dispositivos

Número de dispositivos registados no seu hub IoT
totalDeviceCount Count Média, Máximo, Mínimo <nenhum> PT1M Não
Consultas gêmeas com falha

A contagem de todas as consultas gêmeas com falha.
twinQueries.failure Count Média, Mínimo, Máximo, Total (Soma) <nenhum> 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 gêmeas bem-sucedidas.
twinQueries.resultSize Bytes Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim
Consultas gêmeas bem-sucedidas

A contagem de todas as consultas gêmeas bem-sucedidas.
twinQueries.success Count Média, Mínimo, Máximo, Total (Soma) <nenhum> PT1M Sim

Agregações suportadas

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 para 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 Unidade de Contagem, apenas algumas agregações são válidas. As métricas de contagem podem ser de dois tipos:

  • Para métricas de contagem de ponto único, o Hub IoT registra um único ponto de dados (essencialmente um 1) toda vez que a operação medida ocorre. Em seguida, o 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. Estes valores são sempre 1.

  • Para métricas de contagem de instantâneos , o Hub IoT registra uma contagem total quando a operação medida ocorre. Atualmente, existem três métricas de instantâneo emitidas pelo Hub IoT: Número total de mensagens usadas, Total de dispositivos e Dispositivos conectados. Como essas métricas apresentam sempre uma quantidade "total", somá-las sobre a granularidade especificada não faz sentido. O Azure Monitor limita você a selecionar média, mínimo e máximo para o tipo de agregação para essas métricas.

Dimensões métricas

Para obter informações sobre o que são dimensões métricas, consulte Métricas multidimensionais.

Este serviço tem as seguintes dimensões associadas às suas métricas.

Nome da Dimensão Description
Nome do ponto de extremidade O nome do ponto de extremidade
Tipo de ponto de extremidade eventHubs, serviceBusQueues, , cosmosDB, builtinserviceBusTopics, oublobStorage
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.
Result Tanto success como failure
RoutingSource Device Messages, Twin Change Events, Device Lifecycle Events

Nome de exibição e agregação de 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 Hub IoT por categoria geral e listam métricas por seu nome para 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 Unit Description
Mensagens C2D expiradas C2DMessagesExpirado Count Número de mensagens expiradas da nuvem para o dispositivo
Entregas de mensagens C2D concluídas c2d.commands.egress.complete.success Count Número de entregas de mensagens da nuvem para o dispositivo concluídas com êxito 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 unitário de Contagem, apenas a agregação total (soma) é válida. As agregações mínimas, máximas e médias sempre retornam 1. Para obter mais informações, consulte Agregações suportadas.

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

Nome de exibição da métrica Métrica Unit Description
Invocações de método direto com falhas c2d.methods.failure Count A contagem de todas as chamadas diretas de método com falha.
Pedir tamanho de invocações de método direto c2d.methods.requestSize Bytes A contagem de todas as solicitações de método direto bem-sucedidas.
Tamanho da resposta de invocações de método direto c2d.methods.responseSize Bytes A contagem de todas as respostas diretas bem-sucedidas do método.
Invocações diretas bem-sucedidas do método c2d.methods.sucesso Count A contagem de todas as chamadas diretas bem-sucedidas do método.

Para métricas com um valor unitário de Contagem , apenas a agregação total (soma) é válida. As agregações mínimas, máximas e médias sempre retornam 1. Para obter mais informações, consulte Agregações suportadas.

Métricas de operações gêmeas de nuvem para dispositivo:

Nome de exibição da métrica Métrica Unit Description
Leituras duplas com falhas de back-end c2d.twin.read.failure Count A contagem de todos os gêmeos iniciados no back-end com falha é lida.
Atualizações duplas com falhas do back-end c2d.twin.update.failure Count A contagem de todas as atualizações gêmeas iniciadas no back-end com falha.
Tamanho da resposta de leituras duplas de back-end c2d.twin.read.size Bytes A contagem de todos os gêmeos iniciados no back-end bem-sucedidos é lida.
Tamanho das atualizações gêmeas do back-end c2d.twin.update.size Bytes O tamanho total de todas as atualizações gêmeas iniciadas com back-end bem-sucedidas.
Leituras de duplos do back-end com êxito c2d.twin.read.sucesso Count A contagem de todos os gêmeos iniciados no back-end bem-sucedidos é lida.
Atualizações duplas com êxito do back-end c2d.twin.update.success Count A contagem de todas as atualizações gêmeas iniciadas com back-end bem-sucedidas.

Para métricas com um valor unitário de Contagem, apenas a agregação total (soma) é válida. As agregações mínimas, máximas e médias sempre retornam 1. Para obter mais informações, consulte Agregações suportadas.

Métricas de configurações:

Nome de exibição da métrica Métrica Unit Description
Métricas de Configuração configurações Count Número total de operações CRUD realizadas para configuração de dispositivos e implantação do IoT Edge, em um conjunto de dispositivos de destino. Incluído está o número de operações que modificam o dispositivo gêmeo ou módulo gêmeo devido a essas configurações.

Para métricas com um valor unitário de Contagem, apenas a agregação total (soma) é válida. As agregações mínimas, máximas e médias sempre retornam 1. Para obter mais informações, consulte Agregações suportadas.

Métricas de cotas diárias:

Nome de exibição da métrica Métrica Unit Description
Utilização total dos dados do dispositivo deviceDataUsage Bytes Bytes transferidos de e para qualquer dispositivo conectado ao IotHub
Utilização total dos dados do dispositivo (pré-visualização) deviceDataUsageV2 Total Bytes transferidos de e para qualquer dispositivo conectado ao IotHub
Número total de mensagens utilizadas dailyMessageQuotaUsado Count Número total de mensagens utilizadas atualmente. Um valor acumulado que é redefinido para zero às 00:00 UTC todos os dias.

Para o número total de mensagens usadas, há suporte apenas para agregações mínimas, máximas e médias. Para obter mais informações, consulte Agregações suportadas.

Métricas do dispositivo:

Nome de exibição da métrica Métrica Unit Description
Total de dispositivos (preteridos) dispositivos.totalDispositivos Count Número de dispositivos registados no seu hub IoT
Dispositivos ligados (preteridos) devices.connectedDevices.allProtocolo Count Número de dispositivos conectados ao seu hub IoT
Total de dispositivos totalDeviceCount Count Número de dispositivos registados no seu hub IoT
Dispositivos ligados connectedDeviceCount Count Número de dispositivos conectados ao seu hub IoT

Para Dispositivos totais (obsoletos) e Dispositivos conectados (obsoletos), apenas a agregação total (soma) é válida. As agregações mínimas, máximas e médias sempre retornam 1. Para obter mais informações, consulte Agregações suportadas.

Para dispositivos totais e dispositivos conectados, apenas as agregações mínimas, máximas e médias são válidas. Para obter mais informações, consulte Agregações suportadas.

O total de dispositivos e os dispositivos conectados não podem ser exportados por meio de configurações de diagnóstico.

Métricas de telemetria do dispositivo:

Nome de exibição da métrica Métrica Unit Description
Número de erros de limitação d2c.telemetry.ingress.sendThrottle Count Número de erros de limitação devido a aceleradores de taxa de transferência do dispositivo
Tentativas de telemetria de 'envio de mensagens' d2c.telemetry.ingress.allProtocolo Count Número de mensagens de telemetria de dispositivo para nuvem que tentaram ser enviadas para seu hub IoT
Mensagens de telemetria enviadas d2c.telemetry.ingress.success Count Número de mensagens de telemetria de dispositivo para nuvem enviadas com êxito para seu hub IoT

Para métricas com um valor unitário de Contagem, apenas a agregação total (soma) é válida. As agregações mínimas, máximas e médias sempre retornam 1. Para obter mais informações, consulte Agregações suportadas.

Métricas de operações gêmeas de dispositivo para nuvem:

Nome de exibição da métrica Métrica Unit Description
Leituras duplas com falhas de dispositivos d2c.twin.read.failure Count A contagem de todas as leituras gêmeas iniciadas por dispositivo com falha.
Atualizações duplas com falhas dos dispositivos d2c.twin.update.failure Count A contagem de todas as atualizações gêmeas iniciadas por dispositivo com falha.
Tamanho da resposta de leituras duplas de dispositivos d2c.twin.read.size Bytes O número de todas as leituras gêmeas iniciadas por dispositivos bem-sucedidas.
Tamanho das atualizações gêmeas dos dispositivos d2c.twin.update.size Bytes O tamanho total de todas as atualizações gêmeas iniciadas pelo dispositivo com êxito.
Leituras de duplos dos dispositivos com êxito d2c.twin.read.success Count A contagem de todos os gêmeos iniciados por dispositivos bem-sucedidos lê.
Atualizações de duplos dos dispositivos com êxito d2c.twin.update.success Count A contagem de todas as atualizações gêmeas iniciadas pelo dispositivo bem-sucedidas.

Para métricas com um valor unitário de Contagem, apenas a agregação total (soma) é válida. As agregações mínimas, máximas e médias sempre retornam 1. Para obter mais informações, consulte Agregações suportadas.

Métricas da grade de eventos:

Nome de exibição da métrica Métrica Unit Description
Entregas da grelha de eventos EventGridEntregas Count O número de eventos do Hub IoT publicados na Grade de Eventos. Use a dimensão 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) desde quando o evento do Hub Iot foi gerado até quando o evento foi publicado na Grade de Eventos. Este número é uma média entre todos os tipos de eventos. Use a dimensão EventType para ver a latência de um tipo específico de evento.

Para métricas com um valor unitário de Contagem, apenas a agregação total (soma) é válida. As agregações mínimas, máximas e médias sempre retornam 1. Para obter mais informações, consulte Agregações suportadas.

Métricas de trabalho:

Nome de exibição da métrica Métrica Unit Description
Tarefas concluídas empregos.concluído Count A contagem de todos os trabalhos concluídos.
Chamadas com falhas para listar tarefas jobs.listJobs.falha Count A contagem de todas as chamadas falhadas para listar trabalhos.
Criações com falhas de tarefas de invocação de método jobs.createDirectMethodJob.failure Count A contagem de todas as falhas na criação de trabalhos de invocação direta do método.
Criações com falhas de tarefas de atualização duplas jobs.createTwinUpdateJob.falha Count A contagem de todas as falhas na criação de trabalhos de atualização gêmeos.
Cancelamentos de tarefas com falhas jobs.cancelJob.failure Count A contagem de todas as chamadas falhadas para cancelar um trabalho.
Consultas de tarefa com falhas jobs.queryJobs.falha Count A contagem de todas as chamadas com falha para consultar trabalhos.
Tarefas com falhas jobs.falhou Count A contagem de todos os trabalhos falhados.
Chamadas bem-sucedidas para listar vagas jobs.listJobs.sucesso Count A contagem de todas as chamadas bem-sucedidas para listar trabalhos.
Criações bem-sucedidas de trabalhos de invocação de método jobs.createDirectMethodJob.success Count A contagem de todas as criações bem-sucedidas de trabalhos de invocação direta de métodos.
Criações bem-sucedidas de trabalhos de atualização gêmeos jobs.createTwinUpdateJob.
exito
Count A contagem de toda a criação bem-sucedida de empregos de atualização gêmeos.
Cancelamentos de emprego bem-sucedidos jobs.cancelJob.success Count A contagem de todas as chamadas bem-sucedidas para cancelar um trabalho.
Consultas de emprego bem-sucedidas jobs.queryJobs.success Count A contagem de todas as chamadas bem-sucedidas para trabalhos de consulta.

Para métricas com um valor unitário de Contagem, apenas a agregação total (soma) é válida. As agregações mínimas, máximas e médias sempre retornam 1. Para obter mais informações, consulte Agregações suportadas.

Métricas de roteamento:

Nome de exibição da métrica Métrica Unit Description
Roteamento de entregas (visualização) RoteamentoEntregas 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 da mensagem de entrega de roteamento em bytes (visualização) RoutingDataSizeInBytesDelivered Bytes O número total de bytes roteados pelo Hub IoT para ponto de extremidade personalizado e 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 de entrega de roteamento (visualização) RoutingDeliveryLatency Milissegundos A métrica de latência de entrega de roteamento. Use as dimensões para identificar a latência de um ponto de extremidade específico ou de uma fonte de roteamento específica.
Encaminhamento: 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.
Encaminhamento: dados entregues ao armazenamento d2c.endpoints.egress.storage.bytes Bytes A quantidade de dados (bytes) de roteamento do Hub IoT entregues aos pontos de extremidade de armazenamento.
Roteamento: latência de mensagens para Hubs de Eventos d2c.endpoints.latency.eventHubs Milissegundos A latência média (milissegundos) entre a entrada de mensagens no Hub IoT e a entrada de mensagens em pontos de extremidade personalizados do tipo Hubs de Eventos. As rotas de mensagens para o ponto de extremidade interno (eventos) não estão incluídas.
Encaminhamento: latência de mensagem para a Fila do Service Bus d2c.endpoints.latency.serviceBusQueues Milissegundos A latência média (milissegundos) entre a entrada de mensagens no Hub IoT e a entrada de mensagens em um ponto de extremidade de fila do Service Bus.
Roteamento: latência de mensagem para o tópico do Service Bus d2c.endpoints.latency.serviceBusTopics Milissegundos A latência média (milissegundos) entre a entrada de mensagens no Hub IoT e a entrada de mensagens em um ponto de extremidade de tópico do Service Bus.
Roteamento: latência de mensagens para mensagens/eventos d2c.endpoints.latency.builtIn.events Milissegundos A latência média (milissegundos) entre a entrada de mensagens no Hub IoT e a entrada de mensagens no ponto de extremidade interno (mensagens/eventos) e na rota de fallback.
Roteamento: latência de mensagens para armazenamento d2c.endpoints.latency.storage Milissegundos A latência média (milissegundos) entre a entrada de mensagens no Hub IoT e a entrada de mensagens 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 mensagens com êxito a pontos de extremidade personalizados do tipo Hubs de Eventos. As rotas de mensagens para o ponto de extremidade interno (eventos) não estão incluídas.
Roteamento: mensagens entregues na fila do Service Bus d2c.endpoints.egress.serviceBusQueues Count O número de vezes que o roteamento do Hub IoT entregou mensagens com êxito aos pontos de extremidade da fila do Barramento de Serviço.
Roteamento: mensagens entregues ao Service Bus Tópico d2c.endpoints.egress.serviceBusTopics Count O número de vezes que o roteamento do Hub IoT entregou mensagens com êxito aos pontos de extremidade de tópico do Service Bus.
Roteamento: mensagens entregues para fallback d2c.telemetria.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 mensagens com êxito 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 mensagens com êxito aos pontos de extremidade de armazenamento.
Roteamento: mensagens de telemetria entregues d2c.telemetria.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 for roteada para vários pontos de extremidade, esse valor aumentará em um para cada entrega bem-sucedida. Se uma mensagem for entregue ao mesmo ponto de extremidade várias vezes, esse valor aumentará em um para cada entrega bem-sucedida.
Roteamento: mensagens de telemetria descartadas d2c.telemetria.egress.dropped Count O número de vezes que o roteamento do Hub IoT descarta mensagens devido a pontos de extremidade mortos. Esse valor não conta as mensagens entregues na rota de fallback, pois as mensagens descartadas não são entregues lá.
Roteamento: mensagens de telemetria incompatíveis d2c.telemetria.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 Iot Hub tenta entregar a mensagem a um ponto de extremidade e falha com um erro não transitório. As mensagens inválidas não são repetidas. Esse valor não inclui tentativas.
Roteamento: mensagens de telemetria órfãs d2c.telemetria.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.

Para métricas com um valor unitário de Contagem, apenas a agregação total (soma) é válida. As agregações mínimas, máximas e médias sempre retornam 1. Para obter mais informações, consulte Agregações suportadas.

Métricas de consulta gêmeas:

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

Para métricas com um valor unitário de Contagem, apenas a agregação total (soma) é válida. As agregações mínimas, máximas e médias sempre retornam 1. Para obter mais informações, consulte Agregações suportadas.

Registos do recurso

Esta seção lista os tipos de logs de recursos que você pode coletar para 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 suportados para Microsoft.Devices/IotHubs

Categoria Nome de exibição da categoria Tabela de registo Suporta plano de log básico Suporta a transformação do tempo de ingestão Consultas de exemplo Custos de exportação
C2DCommands Comandos C2D AzureDiagnostics

Logs de vários recursos do Azure.

No Não Consultas Não
C2DTwinOperations Operações C2D Twin AzureDiagnostics

Logs de vários recursos do Azure.

No Não Consultas Não
Configurations Configurações AzureDiagnostics

Logs de vários recursos do Azure.

No Não Consultas Não
Connections Ligações AzureDiagnostics

Logs de vários recursos do Azure.

No Não Consultas Não
D2CTwinOperations D2CTwinOperações AzureDiagnostics

Logs de vários recursos do Azure.

No Não Consultas Não
DeviceIdentityOperations Operações de identidade do dispositivo AzureDiagnostics

Logs de vários recursos do Azure.

No Não Consultas Não
DeviceStreams Fluxos de dispositivos (visualização) AzureDiagnostics

Logs de vários recursos do Azure.

No Não Consultas Não
DeviceTelemetry Telemetria do Dispositivo AzureDiagnostics

Logs de vários recursos do Azure.

No Não Consultas Não
DirectMethods Métodos Diretos AzureDiagnostics

Logs de vários recursos do Azure.

No Não Consultas Não
DistributedTracing Rastreamento distribuído (visualização) No No Não
FileUploadOperations Operações de carregamento de ficheiros AzureDiagnostics

Logs de vários recursos do Azure.

No Não Consultas Não
JobsOperations Operações de Empregos AzureDiagnostics

Logs de vários recursos do Azure.

No Não Consultas Não
Routes Rotas AzureDiagnostics

Logs de vários recursos do Azure.

No Não Consultas Não
TwinQueries Consultas gêmeas AzureDiagnostics

Logs de vários recursos do Azure.

No Não Consultas Não

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

Categoria de comandos da nuvem para o dispositivo

A categoria de comandos nuvem-para-dispositivo rastreia erros que ocorrem no hub IoT e estão relacionados ao pipeline de mensagens nuvem-para-dispositivo. Esta categoria inclui erros que ocorrem de:

  • Envio de mensagens da nuvem para o dispositivo (como erros de remetente não autorizado),
  • Receber mensagens da nuvem para o dispositivo (como erros de contagem de entregas excedidos) e
  • Receber feedback de mensagens da nuvem para o dispositivo (como erros de feedback expirados).

Esta categoria não deteta erros quando a mensagem da nuvem para o dispositivo é entregue com êxito, mas depois 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 gêmeas da nuvem para o dispositivo rastreia eventos iniciados pelo serviço em gêmeos de dispositivo. Essas operações podem incluir obter gêmeos, atualizar ou substituir tags e atualizar ou substituir as 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 gêmeas de dispositivo para nuvem

A categoria de operações de gêmeos de dispositivo para nuvem rastreia eventos iniciados por dispositivo em gêmeos de dispositivo. Essas operações podem incluir obter gêmeos, atualizar 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 de 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 eventos de conexão e desconexão de dispositivos de um hub IoT e erros. Esta categoria é útil para identificar tentativas de conexão não autorizadas e/ou alertar quando você perde a conexão com dispositivos.

Para obter um estado de ligação fiável dos dispositivos, consulte Monitorizar o estado da ligaçã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, consulte 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 de dispositivo rastreia erros que ocorrem quando você tenta criar, atualizar ou excluir uma entrada no registro de identidade do hub IoT. O acompanhamento dessa categoria é útil para 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 dispositivos (visualização)

A categoria de fluxos de dispositivos rastreia as interações de solicitação-resposta enviadas para 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. Esta categoria inclui erros que ocorrem ao enviar eventos de telemetria (como limitação) e ao receber eventos de telemetria (como leitor não autorizado). Esta categoria não pode detetar erros causados por 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 para 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 rastreio distribuído (pré-visualização)

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 totalmente esses logs, o código do lado do cliente deve ser atualizado seguindo Analisar e diagnosticar aplicativos IoT de ponta a ponta com rastreamento distribuído do Hub IoT (visualização).

O correlationId está em conformidade com a proposta W3C Trace Context , onde contém a trace-id e a span-id.

Logs do Hub IoT D2C (do dispositivo para a nuvem)

O Hub IoT registra esse log quando uma mensagem contendo 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, não é calculado, durationMs pois o relógio do Hub IoT pode não estar em sincronia com o relógio do dispositivo e, portanto, um cálculo de duração pode ser enganoso. Recomendamos escrever lógica usando os carimbos de data/hora na seção para capturar picos de latência do dispositivo para a properties nuvem.

Propriedade Type Description
messageSize Número inteiro O tamanho da mensagem do dispositivo para a nuvem em bytes
deviceId Cadeia de caracteres alfanuméricos ASCII de 7 bits A identidade do dispositivo
chamadorLocalTimeUtc Carimbo de data/hora UTC A hora de criação da mensagem, conforme informado pelo relógio local do dispositivo
calleeLocalTimeUtc Carimbo de data/hora UTC A hora de chegada da mensagem ao gateway do Hub IoT, conforme relatado pelo relógio lateral do serviço do Hub IoT

Logs de entrada do Hub IoT

O Hub IoT registra esse log quando uma mensagem contendo propriedades de rastreamento válidas grava em Hubs de Eventos internos ou internos.

{
    "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 , esse log contém informações adicionais sobre a properties entrada de mensagens.

Propriedade Type Description
isRoutingEnabled String True ou false, indica se o roteamento de mensagens está habilitado ou não no Hub IoT
parentSpanId String O span-id da mensagem pai, que seria o rastreamento de mensagem D2C neste caso

Logs de saída do Hub IoT

O Hub IoT registra esse log quando o roteamento está habilitado e a mensagem é gravada em 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 , esse log contém informações adicionais sobre a properties entrada de mensagens.

Propriedade Type Description
endpointName String O nome do ponto de extremidade de roteamento
endpointType String O tipo de ponto de extremidade de roteamento
parentSpanId String O span-id da mensagem pai, que seria o rastreamento de mensagem de entrada do Hub IoT neste caso

Categoria de operações de carregamento de ficheiros

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

  • Erros que ocorrem com o URI SAS, como quando ele expira 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 é encontrado no armazenamento durante a criação da mensagem de notificação do Hub IoT.

Esta categoria não pode detetar erros que ocorrem diretamente enquanto o dispositivo está carregando um arquivo para o 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 trabalho

A categoria de operações de trabalhos relata solicitações de trabalho para atualizar gêmeos de dispositivo 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 de roteamento de mensagens rastreia erros que ocorrem durante a avaliação da rota de mensagens e a integridade do ponto de extremidade conforme percebido pelo Hub IoT. Esta categoria inclui eventos como:

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

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

{
    "records":
    [
        {
            "time":"2019-12-12T03:25:14Z",
            "resourceId":"/SUBSCRIPTIONS/91R34780-3DEC-123A-BE2A-213B5500DFF0/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 o roteamento de logs de recursos:

Categoria de consultas gêmeas

A categoria de consultas gêmeas relata solicitações de consulta para gêmeos de dispositivo 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 as tabelas de Logs do Azure Monitor relevantes para este serviço, que estão disponíveis para consulta pelo Log Analytics usando consultas 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

Registo 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 possíveis do provedor de recursos no log de atividades.

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