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.
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 , builtin serviceBusTopics , 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/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 o roteamento de logs de recursos:
- Lista de códigos de erro do log de recursos de roteamento
- Lista de logs de recursos de roteamento operationNames
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.
Conteúdos relacionados
- Consulte Monitorar o Hub IoT do Azure para obter uma descrição do monitoramento do Hub IoT.
- Consulte Monitorar recursos do Azure com o Azure Monitor para obter detalhes sobre o monitoramento de recursos do Azure.