Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Este artigo contém todas as informações de referência de monitoramento para este serviço.
Consulte Monitor IoT do Azure para obter detalhes sobre os dados que você pode coletar para Hub IoT e como usá-los.
Métricas
Esta seção lista todas as métricas da plataforma coletadas automaticamente para este serviço. Essas métricas também fazem parte da lista global de todas as métricas de plataforma com suporte no Azure Monitor.
Para obter informações sobre retenção de métrica, consulte Azure Monitor Visão geral das métricas.
Métricas com suporte para Microsoft. Dispositivos/IoTHubs
A tabela a seguir lista as métricas disponíveis para o Microsoft. Tipo de recurso Devices/IoTHubs.
Important
O catálogo por tipos de recurso não é uma matriz de suporte a recursos para cada perfil de conexão. Para hubs com o perfil de conexão MQTT v5, leia os dados de perfil neste artigo e verifique as capacidades do MQTT v5. Roteamento de endpoint embutido, roteamento de backup, tarefas, configurações automáticas de dispositivos e mensagens em fila de nuvem para dispositivo não são suportados nesta prévia. As métricas deles não são aplicáveis, mesmo que apareçam definições ou valores. Métodos diretos e operações gêmeas são separados das mensagens em fila da nuvem para o dispositivo.
- Nem todas as colunas podem estar presentes em todas as tabelas.
- Algumas colunas podem estar além da área de visualização da página. Selecione Expandir tabela para exibir todas as colunas disponíveis.
Títulos de tabela
- Categoria - O grupo ou classificação de métricas.
- Métrica: o nome de exibição da métrica como aparece no portal do Azure.
- Nome na API REST - O nome da métrica referido na API REST.
- Unidade: unidade de medida
- Agregação – o tipo de agregação padrão. Valores válidos: Médio (Méd.), Mínimo (Mín.), Máximo (Máx.), Total (Soma), Contagem.
- Dimensões - Dimensões disponíveis para a métrica.
-
Granularidades de tempo - Intervalos em que a métrica é amostrada. Por exemplo,
PT1Mindica que a métrica é amostrada a cada minuto,PT30Ma cada 30 minutos,PT1Ha cada hora e assim por diante. - DS Export - Se a métrica pode ser exportada para o Azure Monitor Logs via configurações de diagnóstico. Para obter informações sobre como exportar métricas, consulte Create configurações de diagnóstico em Azure Monitor.
| Métrica | Nome na API REST | Métricas avançadas de plataforma | Unidade | Agregação | Dimensões | Intervalos de Tempo | Exportação de DS |
|---|---|---|---|---|---|---|---|
|
Mensagens C2D abandonadas Número de mensagens da nuvem para o dispositivo abandonadas pelo dispositivo |
c2d.commands.egress.abandon.success |
Não | Contagem | 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 sucesso pelo dispositivo |
c2d.commands.egress.complete.success |
Não | Contagem | 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 |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Invocações diretas de métodos falhadas A contagem de todas as chamadas de método diretas com falhas. |
c2d.methods.failure |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Tamanho da solicitação das invocações diretas de métodos A média, o mínimo e o máximo de todas as solicitações de método diretas bem-sucedidas. |
c2d.methods.requestSize |
Não | Bytes | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Tamanho da resposta das invocações diretas de métodos A média, o mínimo e o máximo de todas as respostas bem-sucedidas de método direto. |
c2d.methods.responseSize |
Não | Bytes | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Invocações diretas bem-sucedidas de métodos A contagem de todas as chamadas de método diretas bem-sucedidas. |
c2d.methods.success |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Falha na leitura dos gêmeos do backend A contagem de todas as falhas de leituras de gêmeos iniciadas pelo back-end. |
c2d.twin.read.failure |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Tamanho da resposta das leituras duplas do backend A média, o mínimo e o máximo de todas as leituras de gêmeos bem-sucedidas iniciadas pelo back-end. |
c2d.twin.read.size |
Não | Bytes | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Leituras gêmeas bem-sucedidas do backend A contagem de todas as leituras de gêmeos bem-sucedidas iniciadas pelo back-end. |
c2d.twin.read.success |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Falhas nas atualizações gêmeas do backend A contagem de todas as falhas de atualizações de gêmeos iniciadas pelo back-end. |
c2d.twin.update.failure |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Tamanho das atualizações gêmeas do backend A média, o mínimo e o máximo de todas as atualizações de gêmeos iniciadas pelo back-end bem-sucedidas. |
c2d.twin.update.size |
Não | Bytes | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Atualizações de gêmeos bem-sucedidas a partir do back-end A contagem de todas as atualizações de gêmeos iniciadas pelo back-end bem-sucedidas. |
c2d.twin.update.success |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Mensagens C2D Expiradas Número de mensagens de nuvem para o dispositivo expiradas |
C2DMessagesExpired |
Não | Contagem | 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 |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Conexões bem-sucedidas Conexões bem-sucedidas com o IoTHub |
connect.success |
Não | Contagem | Soma (Total) |
ApiType, Protocol, , TLSVersionTLSCipher |
PT1M | Sim |
|
Dispositivos conectados Número de dispositivos registrados ao seu hub IoT |
connectedDeviceCount |
Não | Contagem | Médio, Máximo, Mínimo | <nenhum> | PT1M | Não |
|
Roteamento: mensagens entregues para mensagens/eventos O número de vezes Hub IoT o roteamento de mensagens entregues com êxito ao ponto de extremidade interno (mensagens/eventos). |
d2c.endpoints.egress.builtIn.events |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Roteamento: mensagens entregues ao Event Hub O número de vezes Hub IoT o roteamento de mensagens entregues com êxito aos pontos de extremidade do Hub de Eventos. |
d2c.endpoints.egress.eventHubs |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Roteamento: mensagens entregues para a Fila do Barramento de Serviço O número de vezes Hub IoT o roteamento de mensagens entregues com êxito para Barramento de Serviço pontos de extremidade de fila. |
d2c.endpoints.egress.serviceBusQueues |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Roteamento: mensagens entregues para o Tópico Barramento de Serviço O número de vezes Hub IoT o roteamento de mensagens entregues com êxito para Barramento de Serviço pontos de extremidade de tópico. |
d2c.endpoints.egress.serviceBusTopics |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Roteamento: mensagens entregues ao armazenamento O número de vezes Hub IoT roteamento de mensagens entregues com êxito aos pontos de extremidade de armazenamento. |
d2c.endpoints.egress.storage |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Roteamento: blobs entregues ao armazenamento O número de vezes que Hub IoT roteamento entregou blobs para pontos de extremidade de armazenamento. |
d2c.endpoints.egress.storage.blobs |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Roteamento: dados entregues ao armazenamento A quantidade de dados (bytes) Hub IoT roteamento entregue aos pontos de extremidade de armazenamento. |
d2c.endpoints.egress.storage.bytes |
Não | Bytes | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Roteamento: latência de mensagem para mensagens/eventos A latência média (milissegundos) entre a entrada da mensagem para Hub IoT e a entrada da mensagem de telemetria no ponto de extremidade interno (mensagens/eventos). |
d2c.endpoints.latency.builtIn.events |
Não | Milissegundos | Média, Mínimo, Máximo | <nenhum> | PT1M | Sim |
|
Roteamento: latência de mensagem para o Event Hub A latência média (milissegundos) entre a entrada da mensagem para Hub IoT e a entrada da mensagem em um ponto de extremidade do Hub de Eventos. |
d2c.endpoints.latency.eventHubs |
Não | Milissegundos | Média, Mínimo, Máximo | <nenhum> | PT1M | Sim |
|
Roteamento: latência de mensagem para a fila Barramento de Serviço A latência média (milissegundos) entre a entrada da mensagem para Hub IoT e a entrada da mensagem de telemetria em um ponto de extremidade de fila Barramento de Serviço. |
d2c.endpoints.latency.serviceBusQueues |
Não | Milissegundos | Média, Mínimo, Máximo | <nenhum> | PT1M | Sim |
|
Roteamento: latência de mensagem para o tópico Barramento de Serviço A latência média (milissegundos) entre a entrada da mensagem para Hub IoT e a entrada da mensagem de telemetria em um ponto de extremidade de tópico Barramento de Serviço. |
d2c.endpoints.latency.serviceBusTopics |
Não | Milissegundos | Média, Mínimo, Máximo | <nenhum> | PT1M | Sim |
|
Roteamento: latência de mensagem para armazenamento A latência média (milissegundos) entre a entrada da mensagem para Hub IoT e a entrada da mensagem de telemetria em um ponto de extremidade de armazenamento. |
d2c.endpoints.latency.storage |
Não | 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 por Hub IoT roteamento devido a pontos de extremidade mortos. Esse valor não conta as mensagens entregues à rota de fallback, pois as mensagens removidas não são entregues. |
d2c.telemetry.egress.dropped |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Roteamento: mensagens entregues para o Fallback O número de vezes Hub IoT roteamento de mensagens entregues ao ponto de extremidade associado à rota de fallback. |
d2c.telemetry.egress.fallback |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Roteamento: mensagens de telemetria incompatíveis O número de vezes que Hub IoT roteamento falhou ao entregar mensagens devido a uma incompatibilidade com o ponto de extremidade. Esse valor não inclui novas tentativas. |
d2c.telemetry.egress.invalid |
Não | Contagem | 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 por Hub IoT roteamento porque não correspondia a nenhuma regra de roteamento (incluindo a regra de fallback). |
d2c.telemetry.egress.orphaned |
Não | Contagem | 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 Hub IoT roteamento. Se uma mensagem é encaminhada para vários pontos de extremidade, esse valor aumenta em um para cada entrega bem-sucedida. Se uma mensagem é entregue ao mesmo ponto de extremidade várias vezes, esse valor aumenta em um para cada entrega bem-sucedida. |
d2c.telemetry.egress.success |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Tentativas de envio de mensagem de telemetria Número de tentativas de envio de mensagens de telemetria do dispositivo para a nuvem em seu hub IoT |
d2c.telemetry.ingress.allProtocol |
Não | Contagem | 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 limitações da taxa de transferência do dispositivo |
d2c.telemetry.ingress.sendThrottle |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Mensagens de telemetria enviadas Número de mensagens de telemetria do dispositivo para nuvem enviadas com êxito para o hub IoT |
d2c.telemetry.ingress.success |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Falha nas leituras gêmeas de dispositivos A contagem de todas as leituras de gêmeos iniciadas pelo dispositivo com falhas. |
d2c.twin.read.failure |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Tamanho da resposta das leituras duplas dos dispositivos A média, o mínimo e o máximo de todas as leituras de gêmeos iniciadas pelo dispositivo bem-sucedidas. |
d2c.twin.read.size |
Não | Bytes | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Leituras gêmeas bem-sucedidas de dispositivos A contagem de todas as leituras de gêmeos iniciadas pelo dispositivo bem-sucedidas. |
d2c.twin.read.success |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Falhas em atualizações gêmeas de dispositivos A contagem de todas as atualizações de gêmeos iniciadas pelo dispositivo. |
d2c.twin.update.failure |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Tamanho das atualizações gêmeas dos dispositivos A média, o mínimo e o máximo de todas as atualizações de gêmeos iniciadas pelo dispositivo bem-sucedidas. |
d2c.twin.update.size |
Não | 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 de gêmeos iniciadas pelo dispositivo bem-sucedidas. |
d2c.twin.update.success |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Número total de mensagens usadas Número total de mensagens usadas hoje |
dailyMessageQuotaUsed |
Não | Contagem | Média, Mínimo, Máximo | <nenhum> | PT1M | Sim |
|
Uso total de dados do dispositivo Bytes transferidos para e de qualquer dispositivo conectado ao IoTHub |
deviceDataUsage |
Não | Bytes | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Uso total de dados do dispositivo (prévia) Bytes transferidos para e de qualquer dispositivo conectado ao IoTHub |
deviceDataUsageV2 |
Não | Bytes | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Dispositivos conectados (obsoletos) Número de dispositivos registrados ao seu hub IoT |
devices.connectedDevices.allProtocol |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Total de dispositivos (obsoleto) Número de dispositivos registrados para o seu hub IoT |
devices.totalDevices |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Entregas em Grade de Eventos O número de eventos Hub IoT publicados na Grade de Eventos. Utilize a dimensão de Resultado para o número de solicitações bem-sucedidas e mal-sucedidas. A dimensão EventType mostra o tipo de evento (https://aka.ms/ioteventgrid). |
EventGridDeliveries |
Não | Contagem | 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 IoT Hub foi gerado até quando o evento foi publicado no Event Grid. Esse número é uma média entre todos os tipos de evento. Use a dimensão EventType para ver a latência de um tipo específico de evento. |
EventGridLatency |
Não | Milissegundos | Média, Mínimo, Máximo | EventType |
PT1M | Sim |
|
Cancelamentos de tarefas com falha A contagem de todas as chamadas para cancelar um trabalho com falhas. |
jobs.cancelJob.failure |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Cancelamentos de emprego bem-sucedidos A contagem de todas as chamadas para cancelar um trabalho bem-sucedidas. |
jobs.cancelJob.success |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Trabalhos concluídos A contagem de todos os trabalhos concluídos. |
jobs.completed |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Falhas na criação de tarefas de invocação de métodos A contagem de todas as criações de trabalhos de invocação de método direto com falhas. |
jobs.createDirectMethodJob.failure |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Criações bem-sucedidas de tarefas de invocação de métodos A contagem de todas as criações de trabalhos de invocação de método direto bem-sucedidas. |
jobs.createDirectMethodJob.success |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Falhas na criação de tarefas de atualização gêmeas A contagem de todos os trabalhos de criação de atualização de gêmeos com falhas. |
jobs.createTwinUpdateJob.failure |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Criações bem-sucedidas de empregos de atualização gêmeos A contagem de todos os trabalhos de criação de atualização de gêmeos bem-sucedidos. |
jobs.createTwinUpdateJob.success |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Empregos fracassados A contagem de todos os trabalhos com falha. |
jobs.failed |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Falhas nas chamadas para listar vagas A contagem de todas as chamadas para listar trabalhos com falhas. |
jobs.listJobs.failure |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Chamadas bem-sucedidas para listar vagas A contagem de todas as chamadas para listar trabalhos bem-sucedidas. |
jobs.listJobs.success |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Consultas de tarefas falhadas A contagem de todas as chamadas para consultas de trabalho com falhas. |
jobs.queryJobs.failure |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Consultas de emprego bem-sucedidas A contagem de todas as chamadas para consultas de trabalho bem-sucedidas. |
jobs.queryJobs.success |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Roteamento do tamanho da mensagem de entrega em bytes (prévia) O tamanho total em bytes das mensagens entregues pelo hub IoT a um endpoint. Você pode usar as dimensões EndpointName e EndpointType para exibir o tamanho em bytes das mensagens entregues aos diferentes pontos de extremidade. O valor de métrica aumenta para cada mensagem entregue, incluindo se a mensagem é entregue a vários pontos de extremidade ou se a mensagem é entregue ao mesmo ponto de extremidade várias vezes. |
RoutingDataSizeInBytesDelivered |
Não | Bytes | Média, Mínimo, Máximo, Total (Soma) |
EndpointType
EndpointName
RoutingSource
|
PT1M | Sim |
|
Roteamento de Entregas (prévia) O número de vezes que Hub IoT tentou entregar mensagens a todos os pontos de extremidade usando o roteamento. Para ver o número de tentativas com êxito ou com falha, use a dimensão Resultado. Para ver o motivo da falha, como inválida, removida ou órfã, use a dimensão FailureReasonCategory. Você também pode usar as dimensões EndpointName e EndpointType para entender quantas mensagens foram entregues aos diferentes endpoints. O valor de métrica aumenta em um para cada tentativa de entrega, incluindo se a mensagem é entregue a vários pontos de extremidade ou se a mensagem é entregue ao mesmo ponto de extremidade várias vezes. |
RoutingDeliveries |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) |
EndpointType, EndpointName, FailureReasonCategory, , ResultRoutingSource |
PT1M | Sim |
|
Latência de Roteamento de Entrega (prévia) A latência média (milissegundos) entre a entrada da mensagem para Hub IoT e a entrada da mensagem de telemetria em um ponto de extremidade. Você pode usar as dimensões EndpointName e EndpointType para entender a latência para seus diferentes pontos de extremidade. |
RoutingDeliveryLatency |
Não | Milissegundos | Média, Mínimo, Máximo |
EndpointType
EndpointName
RoutingSource
|
PT1M | Sim |
|
Número de solicitações limitadas Número de solicitações limitadas por tipos de restrição |
throttledRequests |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | ThrottleType |
PT1M | Sim |
|
Total de dispositivos Número de dispositivos registrados para o seu hub IoT |
totalDeviceCount |
Não | Contagem | Médio, Máximo, Mínimo | <nenhum> | PT1M | Não |
|
Consultas gêmeas falhadas A contagem de todas as consultas de gêmeos com falhas. |
twinQueries.failure |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Tamanho do resultado das consultas gêmeas A média, o mínimo e o máximo do tamanho do resultado de todas as consultas de gêmeos bem-sucedidas. |
twinQueries.resultSize |
Não | Bytes | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
|
Consultas gêmeas bem-sucedidas A contagem de todas as consultas de gêmeos bem-sucedidas. |
twinQueries.success |
Não | Contagem | Média, Mínimo, Máximo, Total (Soma) | <nenhum> | PT1M | Sim |
Investigue roteamento e limitação juntos
Use Número de solicitações limitadas (throttledRequests) com sua dimensão Tipo de Aceleração (ThrottleType) para identificar quais operações estão sendo limitadas. Filtre ou divida essa métrica por tipo de maneta de controle e, em seguida, correlacione os resultados com evidências de roteamento e destino na mesma janela UTC.
A dimensão identifica a categoria de operação, não um destino de roteamento ou um código de erro.
A métrica e sua dimensão de tipo Throttle estão disponíveis tanto para hubs IoT de perfil clássico quanto para hubs usando o perfil de conexão MQTT v5.
Observação
MQTT v5: Selecione a ThrottleType para uma operação suportada pelo perfil de conexão. Correlacione a métrica com respostas de serviço, erros do SDK e logs de recursos na mesma janela UTC. Uma série ausente não é evidência de que não houve limitação, e a contagem de limitação de pedidos não é uma medida do direito de throughput do hub.
| Propriedade métrica | Valor |
|---|---|
| Nome da API | throttledRequests |
| Nome de exibição | Número de solicitações limitadas |
| Unidade | Contagem |
| Agregação padrão | Total |
| Agregações suportadas | Média, Mínimo, Máximo, Total |
| Nome da API de dimensão | ThrottleType |
| Nome de exibição da dimensão | Tipo de acelerador |
Use Total para investigar o número de solicitações limitadas durante a janela selecionada. A métrica inclui falhas de limitação de solicitação suportadas, não apenas a limitação de entrada por telemetria. Solicitações com atraso bem-sucedido não são contadas apenas porque aguardaram a capacidade acumulada.
As categorias de operações reportadas incluem:
Valor de ThrottleType |
Categoria de operação |
|---|---|
DeviceEvent |
Envios de telemetria de dispositivo para nuvem |
C2DSend, C2DReceive |
Mensagem Cloud-to-device envia e recebe |
Crud |
Operações de registro de identidade de dispositivo |
AmqpLinkOpen, MqttConnect |
O link AMQP é aberto e tentativas de conexão MQTT |
JobCrud |
Operações de gestão de cargos |
FileUpload, FileUploadCompletion |
Solicitações de upload de arquivos e notificações de conclusão |
TwinGet, TwinWrite |
Twin lê e escreve |
TwinDeviceMethod |
Invocações diretas de métodos |
Query |
Queries |
DeviceStreams |
Solicitações de fluxo de dispositivos |
CredentialManagement |
Operações de gerenciamento de credenciais |
Cada hub informa os tipos de aceleração para as operações suportadas pelo seu perfil de conexão.
Use o nome da API, unidade, agregação suportada e dimensões da métrica, em vez de inferir o comportamento a partir do nome de exibição. Os seguintes sinais já aparecem nesta referência e fornecem evidências complementares; eles não são uma lista de novas métricas para esta versão:
| Nome da API métrica | Unidade | Investigação |
|---|---|---|
d2c.telemetry.ingress.sendThrottle |
Contagem | Correlacione sinais de limitação de telemetria com erros do SDK e taxa de tentativa de publicação. Veja interpretação de telemetria MQTT v5. |
RoutingDeliveries |
Contagem | Quais resultados de entrega são reportados para o destino e a fonte de roteamento selecionados? Para avisos de contagem do MQTT v5, veja interpretação de roteamento do MQTT v5. |
RoutingDataSizeInBytesDelivered |
Bytes | Quanto dados roteados é entregue? Não equiparar bytes roteados a uma contagem de mensagens únicas de dispositivos. |
RoutingDeliveryLatency |
Milissegundos | A latência de entrega está aumentando para o endpoint ou fonte relevante? Não faça soma de amostras de latência. |
Descubra as definições do hub real antes de configurar uma consulta ou alerta:
$hubId = "/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.Devices/IotHubs/<hub-name>"
az monitor metrics list-definitions --resource $hubId --output json
Selecione dimensões retornadas para essa métrica, como um endpoint ou fonte de roteamento onde for suportado. Não presuma que toda métrica suporta todas as dimensões da lista de serviço completo. Compare entradas, resultados de entrega e observações de destino na mesma janela UTC.
Limitação de entrada e falha na entrega de destino não são intercambiáveis. Da mesma forma, uma métrica agregada em todos os endpoints pode ocultar uma falha em um endpoint. Verifique o aplicativo receptor para uma mensagem identificada de forma única antes de declarar sucesso de ponta a ponta.
Uma série ausente não é um valor zero. Verifique o suporte para operação/perfil, intervalo de tempo, filtros, permissões e atraso na ingestão. Para MQTT v5, use as considerações de perfil de conexão em vez de assumir que o catálogo geral completo de métricas se aplica.
Para uma investigação orientada por evidências com ferramentas suportadas, consulte Solucionar problemas com o Azure MCP Server.
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 Unit de Count, apenas algumas agregações são válidas. As métricas de contagem podem ser de dois tipos:
Para métricas de contagem Single-point, Hub IoT registra um único ponto de dados (essencialmente um 1) sempre que a operação medida ocorre. Azure Monitor soma esses pontos de dados sobre a granularidade especificada. Exemplos de métricas de ponto único são mensagens de telemetria enviadas e entregas de mensagens C2D concluídas. Para essas métricas, o único tipo de agregação relevante é Total (Soma). O portal permite que você escolha mínimo, máximo e médio. Esses valores são sempre 1.
Para métricas de contagem Snapshot, Hub IoT registra uma contagem total quando a operação medida ocorre. Atualmente, há três métricas Snapshot emitidas por Hub IoT: número Total de mensagens usadasTotal devices e Connected devices. Como essas métricas apresentam uma quantidade "total" todas as vezes, somá-las na granularidade especificada não faz sentido. Azure Monitor limita a seleção da média, do mínimo e do máximo para o tipo de agregação dessas métricas.
Dimensões de métrica
Para obter mais informações sobre o que são dimensões de métrica, confira Métricas multidimensionais.
Este serviço tem as dimensões a seguir associadas a essas métricas.
| Nome da dimensão | Descrição |
|---|---|
| Nome do ponto de extremidade | O nome do ponto de extremidade |
| Tipo de Ponto de Extremidade |
eventHubs, serviceBusQueues, cosmosDB, serviceBusTopics, builtin, , ou blobStorage |
| Tipo de Evento |
Microsoft.Devices.DeviceCreated, Microsoft.Devices.DeviceDeleted, Microsoft.Devices.DeviceConnected, Microsoft.Devices.DeviceDisconnectedou Microsoft.Devices.DeviceTelemetry Para obter mais informações, consulte Tipos de evento. |
| FailureReasonCategory | Um dos seguintes valores: invalid, dropped, orphaned, ou null. |
| Resultado |
success ou failure |
| Origem do roteamento |
Device Messages
Twin Change Events
Device Lifecycle Events
|
| ThrottleType | A categoria de operação para a throttledRequests métrica, como DeviceEvent, MqttConnect, TwinGet, ou TwinWrite. Os valores disponíveis dependem das operações suportadas pelo perfil de conexão do hub. Para as categorias de operação, consulte Investigar roteamento e limitação juntos. |
Nome de exibição e agregação das métricas
As tabelas a seguir fornecem mais informações sobre as métricas descritas na tabela anterior. Eles mostram as métricas da plataforma Hub IoT por categoria geral e listam as métricas pelo nome de exibição, conforme atribuído no portal Azure.
Métricas de comando da nuvem para o dispositivo:
| Nome de exibição da métrica | Métrica | Unidade | Descrição |
|---|---|---|---|
| Mensagens C2D expiradas | C2DMessagesExpirado | Contagem | Número de mensagens de nuvem para o dispositivo expiradas |
| Entregas de mensagem C2D concluídas | c2d.commands.egress.complete.success | Contagem | Número de entregas de mensagens da nuvem para o dispositivo concluídas com sucesso pelo dispositivo |
| Mensagens C2D abandonadas | c2d.commands.egress.abandon.success | Contagem | Número de mensagens da nuvem para o dispositivo abandonadas pelo dispositivo |
| Mensagens C2D rejeitadas | c2d.commands.egress.reject.success | Contagem | Número de mensagens da nuvem para o dispositivo rejeitadas pelo dispositivo |
Para métricas com um valor de Unidade de Contagem, somente 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 com suporte.
Métricas de métodos diretos da nuvem para o dispositivo:
Observação
MQTT v5: Os c2d.methods.success contadores e c2d.methods.failure descrevem invocações de métodos diretos, não entrega em fila da nuvem para o dispositivo.
Correlacione-os com o resultado da invocação do serviço e a resposta do dispositivo.
c2d.methods.requestSize e c2d.methods.responseSize descreva tamanhos em bytes, não contagens de invocação; use a agregação exposta para cada métrica.
| Nome de exibição da métrica | Métrica | Unidade | Descrição |
|---|---|---|---|
| Invocações de método diretas com falhas | c2d.methods.failure | Contagem | A contagem de todas as chamadas de método diretas com falhas. |
| Tamanho da solicitação das invocações de método diretas | c2d.methods.requestSize | Bytes | A contagem de todas as solicitações de método direto bem-sucedidas. |
| Tamanho da resposta das invocações de método diretas | c2d.methods.responseSize | Bytes | A contagem de todas as respostas diretas bem-sucedidas do método. |
| Invocações de método diretas bem-sucedidas | c2d.methods.success | Contagem | A contagem de todas as chamadas de método diretas bem-sucedidas. |
Para métricas com um valor de Unidade de Contagem , somente 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 com suporte.
Métricas de operações da nuvem para o dispositivo gêmeo:
Observação
MQTT v5: As c2d.twin.read.* métricas e c2d.twin.update.* descrevem operações gêmeas iniciadas pelo serviço. Não os use para contar solicitações gêmeas MQTT iniciadas pelo dispositivo. Correlacione contadores de sucesso e falha com a resposta HTTP do serviço e verifique o estado gêmeo resultante separadamente. As .size métricas medem bytes, não o número de operações.
| Nome de exibição da métrica | Métrica | Unidade | Descrição |
|---|---|---|---|
| Leituras de gêmeos de back-end com falhas | c2d.twin.read.failure | Contagem | A contagem de todas as falhas de leituras de gêmeos iniciadas pelo back-end. |
| Atualizações de gêmeos de back-end com falhas | c2d.twin.update.failure | Contagem | A contagem de todas as falhas de atualizações de gêmeos iniciadas pelo back-end. |
| Tamanho da resposta das leituras de gêmeos de back-end | c2d.twin.read.size | Bytes | A contagem de todas as leituras de gêmeos bem-sucedidas iniciadas pelo back-end. |
| Tamanho das atualizações de gêmeos de back-end | c2d.twin.update.size | Bytes | O tamanho total de todas as atualizações gêmeas iniciadas por back-end bem-sucedidas. |
| Leituras de gêmeos de back-end bem-sucedidas | c2d.twin.read.success | Contagem | A contagem de todas as leituras de gêmeos bem-sucedidas iniciadas pelo back-end. |
| Atualizações de gêmeos de back-end bem-sucedidas | c2d.twin.update.success | Contagem | A contagem de todas as atualizações de gêmeos iniciadas pelo back-end bem-sucedidas. |
Para métricas com um valor de Unidade de Contagem, somente 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 com suporte.
Métricas de configurações:
| Nome de exibição da métrica | Métrica | Unidade | Descrição |
|---|---|---|---|
| Métricas de configuração | configurações | Contagem | Número total de operações CRUD executadas para configuração de dispositivo e implantação de 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 o módulo gêmeo devido a essas configurações. |
Para métricas com um valor de Unidade de Contagem, somente 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 com suporte.
Métricas de cota diária:
| Nome de exibição da métrica | Métrica | Unidade | Descrição |
|---|---|---|---|
| Uso total de dados do dispositivo | deviceDataUsage | Bytes | Bytes transferidos para e de qualquer dispositivo conectado ao IoTHub |
| Uso total de dados de dispositivos (versão prévia) | deviceDataUsageV2 | Total | Bytes transferidos para e de qualquer dispositivo conectado ao IoTHub |
| Número total de mensagens usadas | dailyMessageQuotaUsed | Contagem | Número total de mensagens usadas hoje. Um valor cumulativo que é redefinido para zero às 00:00 UTC todos os dias. |
Para Número total de mensagens usadas, somente agregações mínimas, máximas e médias são suportadas. Para obter mais informações, consulte Agregações com suporte.
Observação
MQTT v5: Valores preenchidos deviceDataUsagedeviceDataUsageV2 não estabelecem atribuição de faturamento por operação nem valor de fatura.
dailyMessageQuotaUsed é o medidor legado de quota de mensagens diárias, não uma validação de um medidor de faturamento por consumo MQTT v5. Não derive faturação MQTT v5, direitos de throughput ou limites de escala suportados a partir desses valores.
Métricas do dispositivo:
| Nome de exibição da métrica | Métrica | Unidade | Descrição |
|---|---|---|---|
| Total de dispositivos (preterido) | dispositivos.totalDevices | Contagem | Número de dispositivos registrados para o seu hub IoT |
| Dispositivos conectados (preteridos) | devices.connectedDevices.allProtocol | Contagem | Número de dispositivos registrados ao seu hub IoT |
| Total de dispositivos | totalDeviceCount | Contagem | Número de dispositivos registrados para o seu hub IoT |
| Dispositivos ligados | connectedDeviceCount | Contagem | Número de dispositivos registrados ao seu hub IoT |
Para Total de dispositivos (preterido) e Dispositivos conectados (preterido), somente 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 com suporte.
Para dispositivos totais e dispositivos conectados, somente as agregações mínima, máxima e média são válidas. Para obter mais informações, consulte Agregações com suporte.
O total de dispositivos e dispositivos conectados não são exportáveis via configurações de diagnóstico.
Conexão MQTT v5 e interpretação de inventário
| Nome da API métrica | Interpretação MQTT v5 |
|---|---|
connect.success |
Inspecione as dimensões de operação e protocolo antes de tratar um agregado como contagem de conexão de dispositivos. Atividade HTTP do serviço e eventos de conexão MQTT do dispositivo não são intercambiáveis. Correlacione a série selecionada com o estado da sessão do SDK do dispositivo. |
connectedDeviceCount |
A média de uma janela pode ser fracionária quando um dispositivo está conectado apenas por parte da janela. Não é um dispositivo fracionário, nem a contagem atual, nem o pico. Inspecione a série temporal e a agregação suportada, e correlacione com o estado da sessão do SDK. |
totalDeviceCount |
Uma média de janela pode oscilar entre contagens de estoque quando os dispositivos são criados ou excluídos durante o intervalo. Use o registro para verificar o estoque atual; não interprete o resumo do gráfico como uma contagem exata de correntes. |
devices.connectedDevices.allProtocol, devices.totalDevices |
São variantes obsoletas. Preferência connectedDeviceCount e totalDeviceCount para novo monitoramento. Não transfira suposições de agregação entre as métricas obsoletas e atuais nem use um resumo na janela do gráfico como inventário atual. |
Métricas de telemetria do dispositivo:
| Nome de exibição da métrica | Métrica | Unidade | Descrição |
|---|---|---|---|
| Número de erros de limitação | d2c.telemetry.ingress.sendThrottle | Contagem | Número de erros de limitação devido a limitações da taxa de transferência do dispositivo |
| Tentativas de 'envio de mensagem' de telemetria | d2c.telemetry.ingress.allProtocol | Contagem | Número de tentativas de envio de mensagens de telemetria do dispositivo para a nuvem em seu hub IoT |
| Mensagens de telemetria enviadas | d2c.telemetry.ingress.success | Contagem | Número de mensagens de telemetria do dispositivo para nuvem enviadas com êxito para o hub IoT |
Interpretação de telemetria MQTT v5
| Nome da API métrica | Callout MQTT v5 |
|---|---|
d2c.telemetry.ingress.allProtocol |
Distingua tentativas de publicação de publicações e mensagens entregues aceitas. Correlacione a métrica com a taxa de publicação tentada do dispositivo e com os resultados do SDK, em vez de usar apenas um valor de gráfico para determinar a atividade do dispositivo. |
d2c.telemetry.ingress.success |
O sucesso do ingresso não é prova de roteamento ou recebimento da solicitação. Compare resultados de publicação, resultados de roteamento e mensagens identificadas de forma independente no destino durante o mesmo intervalo. |
d2c.telemetry.ingress.sendThrottle |
Distinga a limitação de envio de telemetria de falhas em autenticação, autorização de tópicos e roteamento. Correlacione com respostas do SDK; não infira um limite de fiscalização por corretor a partir de uma contagem zero ou de um teste de publicação limitada bem-sucedido. |
Para uma verificação de ponta a ponta, consulte Monitorar uma execução de teste.
Para métricas com um valor de Unidade de Contagem, somente 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 com suporte.
Métricas de operações do dispositivo para o gêmeo da nuvem:
Observação
MQTT v5: Use d2c.twin.read.success e d2c.twin.read.failure para leituras iniciadas pelo dispositivo, e d2c.twin.update.successd2c.twin.update.failure para atualizações de propriedades reportadas iniciadas pelo dispositivo.
Uma leitura falhada pode ser registrada pelo serviço sem uma resposta de erro correspondente ao dispositivo. Correlacione tempos de espera do SDK ou respostas ausentes com logs de recursos; não presuma que a ausência de resposta por erro significa sucesso.
d2c.twin.read.size e d2c.twin.update.size medir bytes, não contagens de operações. Verifique o estado gêmeo resultante ao testar uma atualização.
| Nome de exibição da métrica | Métrica | Unidade | Descrição |
|---|---|---|---|
| Leituras de gêmeos dos dispositivos com falhas | d2c.twin.read.failure | Contagem | A contagem de todas as leituras de gêmeos iniciadas pelo dispositivo com falhas. |
| Atualizações de gêmeos dos dispositivos com falhas | d2c.twin.update.failure | Contagem | A contagem de todas as atualizações de gêmeos iniciadas pelo dispositivo. |
| Tamanho da resposta das leituras de gêmeos dos dispositivos | d2c.twin.read.size | Bytes | O número de todas as leituras gêmeas iniciadas pelo dispositivo bem-sucedidas. |
| Tamanho das atualizações de gêmeos dos dispositivos | d2c.twin.update.size | Bytes | O tamanho total de todas as atualizações gêmeas iniciadas pelo dispositivo bem-sucedidas. |
| Leituras de gêmeos dos dispositivos bem-sucedidas | d2c.twin.read.success | Contagem | A contagem de todas as leituras de gêmeos iniciadas pelo dispositivo bem-sucedidas. |
| Atualizações de gêmeos dos dispositivos bem-sucedidas | d2c.twin.update.success | Contagem | A contagem de todas as atualizações de gêmeos iniciadas pelo dispositivo bem-sucedidas. |
Para métricas com um valor de Unidade de Contagem, somente 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 com suporte.
Métricas da Grade de Eventos:
Observação
MQTT v5:EventGridDeliveries e EventGridLatency descreva a integração separada do Hub IoT Event Grid, não a MQTT Broker publicada. Sem uma assinatura de evento aplicável, não se espera nenhum dado. Não interprete essa ausência como falta de telemetria MQTT v5, nem infira suporte a um cenário de Grade de Eventos apenas pela definição da métrica.
| Nome de exibição da métrica | Métrica | Unidade | Descrição |
|---|---|---|---|
| Entregas da Grade de Eventos | EventGridDeliveries | Contagem | O número de eventos Hub IoT publicados na Grade de Eventos. Utilize a dimensão de Resultado para o número de solicitações bem-sucedidas e mal-sucedidas. A dimensão EventType mostra o tipo de evento (https://aka.ms/ioteventgrid). |
| Latência da Grade de Eventos | EventGridLatency | Milissegundos | A latência média (milissegundos) de quando o evento Hub IoT foi gerado para quando o evento foi publicado na Grade de Eventos. Esse número é uma média entre todos os tipos de evento. Use a dimensão EventType para ver a latência de um tipo específico de evento. |
Para métricas com um valor de Unidade de Contagem, somente 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 com suporte.
Métricas de trabalhos:
| Nome de exibição da métrica | Métrica | Unidade | Descrição |
|---|---|---|---|
| Trabalhos concluídos | trabalhos.concluído | Contagem | A contagem de todos os trabalhos concluídos. |
| Chamadas para listar trabalhos com falhas | jobs.listJobs.failure | Contagem | A contagem de todas as chamadas para listar trabalhos com falhas. |
| Criações de trabalhos de invocação de método com falhas | jobs.createDirectMethodJob.failure | Contagem | A contagem de todas as criações de trabalhos de invocação de método direto com falhas. |
| Criações de trabalhos de atualização de gêmeos com falhas | jobs.createTwinUpdateJob.failure | Contagem | A contagem de todos os trabalhos de criação de atualização de gêmeos com falhas. |
| Cancelamentos de trabalho com falhas | jobs.cancelJob.failure | Contagem | A contagem de todas as chamadas para cancelar um trabalho com falhas. |
| Consultas de trabalho com falhas | jobs.queryJobs.failure | Contagem | A contagem de todas as chamadas para consultas de trabalho com falhas. |
| Trabalhos com falha | jobs.failed | Contagem | A contagem de todos os trabalhos com falha. |
| Chamadas para listar trabalhos bem-sucedidas | jobs.listJobs.success | Contagem | A contagem de todas as chamadas para listar trabalhos bem-sucedidas. |
| Criações de trabalhos de invocação de método bem-sucedidas | jobs.createDirectMethodJob.success | Contagem | A contagem de todas as criações de trabalhos de invocação de método direto bem-sucedidas. |
| Criações de trabalhos de atualização de gêmeos bem-sucedidas | jobs.createTwinUpdateJob. êxito |
Contagem | A contagem de todos os trabalhos de criação de atualização de gêmeos bem-sucedidos. |
| Cancelamentos de trabalho bem-sucedidos | jobs.cancelJob.success | Contagem | A contagem de todas as chamadas para cancelar um trabalho bem-sucedidas. |
| Consultas de trabalho bem-sucedidas | jobs.queryJobs.success | Contagem | A contagem de todas as chamadas para consultas de trabalho bem-sucedidas. |
Para métricas com um valor de Unidade de Contagem, somente 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 com suporte.
Métricas de roteamento:
Observação
MQTT v5: As métricas de endpoint embutidas e de roteamento de fallback na tabela compartilhada não são aplicáveis a este perfil. Use destinos compatíveis configurados explicitamente. As seguintes notas de interpretação não alteram esses limites de suporte.
| Nome de exibição da métrica | Métrica | Unidade | Descrição |
|---|---|---|---|
| Entregas de roteiro (versão prévia) | RoteamentoEntregas | Contagem | A métrica de entrega de roteamento. Use as dimensões para identificar o status de entrega de um endpoint específico ou de uma origem de roteamento específica. |
| Tamanho da mensagem de entrega de roteamento em bytes (versão prévia) | RoutingDataSizeInBytesDelivered | Bytes | O número total de bytes roteados por Hub IoT para o ponto de extremidade personalizado e o ponto de extremidade interno. Use as dimensões para identificar o tamanho dos dados roteados para um endpoint específico ou para uma fonte de roteamento específica. |
| Latência de entrega de roteamento (versão prévia) | RoteamentoDeliveryLatência | Milissegundos | A métrica de latência de entrega de roteamento. Use as dimensões para identificar a latência de um endpoint específico ou de uma origem de roteamento específica. |
| Roteamento: blobs entregues ao armazenamento | d2c.endpoints.egress.storage.blobs | Contagem | O número de vezes que Hub IoT roteamento entregou blobs para pontos de extremidade de armazenamento. |
| Roteamento: dados entregues ao armazenamento | d2c.endpoints.egress.storage.bytes | Bytes | A quantidade de dados (bytes) Hub IoT roteamento entregue aos pontos de extremidade de armazenamento. |
| Roteamento: latência de mensagem para Hubs de Eventos | d2c.endpoints.latency.eventHubs | Milissegundos | A latência média (milissegundos) entre a entrada da mensagem para 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. |
| Roteamento: latência de mensagem para fila de Barramento de Serviço | d2c.endpoints.latency.serviceBusQueues | Milissegundos | A latência média (milissegundos) entre a entrada da mensagem para Hub IoT e a entrada da mensagem em um ponto de extremidade de fila Barramento de Serviço. |
| Roteamento: latência de mensagem para Barramento de Serviço Tópico | d2c.endpoints.latency.serviceBusTopics | Milissegundos | A latência média (milissegundos) entre a entrada da mensagem para Hub IoT e a entrada da mensagem em um ponto de extremidade de tópico Barramento de Serviço. |
| Roteamento: latência de mensagem para mensagens/eventos | d2c.Endpoints.Latency.builtIn.Events | Milissegundos | A latência média (milissegundos) entre a entrada da mensagem para Hub IoT e a entrada da mensagem no ponto de extremidade interno (mensagens/eventos) e a rota de fallback. |
| Roteamento: latência de mensagem para armazenamento | d2c.endpoints.latency.storage | Milissegundos | A latência média (milissegundos) entre a entrada da mensagem para 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 | Contagem | O número de vezes Hub IoT o roteamento de mensagens entregues com êxito para 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 à fila de Barramento de Serviço | d2c.endpoints.egress.serviceBusQueues | Contagem | O número de vezes Hub IoT o roteamento de mensagens entregues com êxito para Barramento de Serviço pontos de extremidade de fila. |
| Roteamento: mensagens entregues ao Tópico Barramento de Serviço | d2c.endpoints.egress.serviceBusTopics | Contagem | O número de vezes Hub IoT o roteamento de mensagens entregues com êxito para Barramento de Serviço pontos de extremidade de tópico. |
| Roteamento: mensagens entregues ao fallback | d2c.telemetry.egress.fallback | Contagem | O número de vezes Hub IoT roteamento de mensagens entregues ao ponto de extremidade associado à rota de fallback. |
| Roteamento: mensagens entregues a mensagens/eventos | d2c.endpoints.egress.builtIn.events | Contagem | O número de vezes que Hub IoT o roteamento entregou mensagens com êxito ao ponto de extremidade interno (mensagens/eventos) e à rota de fallback. |
| Roteamento: mensagens entregues ao armazenamento | d2c.endpoints.egress.storage | Contagem | O número de vezes Hub IoT roteamento de mensagens entregues com êxito aos pontos de extremidade de armazenamento. |
| Roteamento: mensagens de telemetria entregues | d2c.telemetry.egress.success | Contagem | O número de vezes que as mensagens foram entregues com êxito a todos os pontos de extremidade usando Hub IoT roteamento. Se uma mensagem é encaminhada para vários pontos de extremidade, esse valor aumenta em um para cada entrega bem-sucedida. Se uma mensagem é entregue ao mesmo ponto de extremidade várias vezes, esse valor aumenta em um para cada entrega bem-sucedida. |
| Roteamento: mensagens de telemetria descartadas | d2c.telemetry.egress.dropped | Contagem | O número de vezes Hub IoT roteamento descarta mensagens devido a pontos de extremidade sem saída. Esse valor não conta as mensagens entregues à rota de fallback, pois as mensagens descartadas não são entregues lá. |
| Roteamento: mensagens de telemetria incompatíveis | d2c.telemetry.egress.invalid | Contagem | O número de vezes que Hub IoT roteamento falhou ao entregar mensagens devido a uma incompatibilidade com o ponto de extremidade. Uma mensagem é incompatível com um ponto de extremidade quando Hub IoT tenta entregar a mensagem a um ponto de extremidade e falha com um erro não transitório. Mensagens inválidas não são repetidas. Esse valor não inclui novas tentativas. |
| Roteamento: mensagens de telemetria órfãs | d2c.telemetry.egress.orphaned | Contagem | O número de vezes Hub IoT roteamento de mensagens órfãs porque elas não correspondem a nenhuma consulta de roteamento, quando a rota de fallback é desabilitada. |
Interpretação de roteamento MQTT v5
| Nome da API métrica | Callout MQTT v5 |
|---|---|
d2c.telemetry.egress.success, RoutingDeliveries |
Conte os resultados da entrega do endpoint, não as publicações de dispositivos únicos. Uma publicação roteada para múltiplos destinos pode contribuir com múltiplas cópias. Dividido pelas dimensões de endpoint, origem, resultado e falha disponíveis para que o sucesso de um destino não esconda o fracasso de outro. |
RoutingDeliveryLatency |
Interprete a latência para o endpoint e a fonte de roteamento selecionados. Não some amostras de latência nem compare um agregado de destino misto com a latência de um único endpoint. |
RoutingDataSizeInBytesDelivered |
Mede bytes entregues nos caminhos de entrega selecionados. O fan-out pode aumentar esse valor sem aumentar as publicações exclusivas de dispositivos; não o use como contagem de mensagens de entrada ou valor de faturamento. |
d2c.telemetry.egress.invalid |
Uma publicação aceita pelo corretor ainda pode ser incompatível com um destino. Uma única publicação pode gerar um resultado inválido para cada cópia de endpoint afetada. Verifique os limites de destino e os logs de roteamento em vez de classificar isso como uma rejeição de corretor. |
d2c.telemetry.egress.dropped |
Descreve quedas de roteamento associadas a falha de endpoint, não publicações rejeitadas pelo corretor. Inspecionar a saúde do endpoint e os erros de destino; um endpoint com falha não implica que todos os outros destinos falharam. |
d2c.telemetry.egress.orphaned, RoutingDeliveries com um resultado de fracasso órfão |
Investigue mensagens que não correspondem a uma rota habilitada. O MQTT v5 não tem rota de backup. Compare as condições de rota salvas com mensagens de teste identificáveis e evidências de recebimento independentes; não use um agregado sozinho para contabilizar cada mensagem. |
d2c.endpoints.egress.eventHubs, d2c.endpoints.latency.eventHubs |
Descreva a entrega para endpoints personalizados de Event Hubs. Essas não são métricas de entrada de corretores MQTT nem evidências de suporte embutido a endpoints. Correlacione com o recebimento no destino configurado dos Event Hubs. |
d2c.endpoints.egress.serviceBusQueues, d2c.endpoints.latency.serviceBusQueues |
Descreva a entrega para endpoints configurados da fila do Barramento de Serviço. Correlacione com a fila de recepção; a aceitação pelo corretor não garante compatibilidade com a configuração dessa fila. |
d2c.endpoints.egress.serviceBusTopics, d2c.endpoints.latency.serviceBusTopics |
Descreva a entrega para endpoints de tópicos de Barramento de Serviço configurados. Verifique o recebimento através da assinatura pretendida, levando em conta seus filtros; a entrega de tópicos não é prova de processamento da solicitação. |
d2c.endpoints.egress.storage, d2c.endpoints.egress.storage.bytes, , d2c.endpoints.egress.storage.blobsd2c.endpoints.latency.storage |
As métricas de armazenamento refletem a saída comprometida, não cada upload intermediário de blocos. Permita lotamento e atraso de compromisso. Distinga cópias de mensagens confirmadas, bytes, contagem de blobs e latência; Inspecione os dados armazenados antes de declarar a entrega concluída. |
Para validação exata, use um conjunto conhecido de identificadores de mensagem e um intervalo de teste limitado. Considere fan-outs e retentativas ao comparar registros de destino com publicações de dispositivos. Use as orientações específicas do destino ao interpretar a entrega para outros tipos de endpoint.
Para métricas com um valor de Unidade de Contagem, somente 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 com suporte.
Métricas de consulta gêmea:
Observação
MQTT v5:twinQueries.success e twinQueries.failure descreve operações de consulta gêmea do lado do serviço, não as solicitações gêmeas GET do dispositivo MQTT.
Uma consulta bem-sucedida não pode retornar dispositivos correspondentes. Inspecione a resposta antes de interpretar twinQueries.resultSize; os bytes de resultado não correspondem à contagem de inventário de dispositivos.
| Nome de exibição da métrica | Métrica | Unidade | Descrição |
|---|---|---|---|
| Consultas de gêmeos com falhas | twinQueries.failure | Contagem | A contagem de todas as consultas de gêmeos com falhas. |
| Consultas de gêmeos bem-sucedidas | twinQueries.success | Contagem | A contagem de todas as consultas de gêmeos bem-sucedidas. |
| Tamanho do resultado das consultas de gêmeos | twinQueries.resultSize | Bytes | O total do tamanho do resultado de todas as consultas gêmeas bem-sucedidas. |
Para métricas com um valor de Unidade de Contagem, somente 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 com suporte.
Logs de recursos
Esta seção lista os tipos de logs de recursos que você pode coletar para o este serviço. A seção extrai da lista de tipos de categoria todos os logs de recursos com suporte no Azure Monitor.
Logs de recursos com suporte para Microsoft. Devices/IotHubs
| Categoria | Custos de exportação | Tabela de log | Suporta o plano básico de logs | Suporta transformação no tempo de ingestão | Consultas de exemplo |
|---|---|---|---|---|---|
| C2DCommands | Não |
AzureDiagnostics Logs de vários recursos de Azure. |
Não | Não | Queries |
| C2DTwinOperations | Não |
AzureDiagnostics Logs de vários recursos de Azure. |
Não | Não | Queries |
| Configurações | Não |
AzureDiagnostics Logs de vários recursos de Azure. |
Não | Não | Queries |
| Conexões | Não |
AzureDiagnostics Logs de vários recursos de Azure. |
Não | Não | Queries |
| D2CTwinOperations | Não |
AzureDiagnostics Logs de vários recursos de Azure. |
Não | Não | Queries |
| DeviceIdentityOperations | Não |
AzureDiagnostics Logs de vários recursos de Azure. |
Não | Não | Queries |
| DeviceStreams | Não |
AzureDiagnostics Logs de vários recursos de Azure. |
Não | Não | Queries |
| DeviceTelemetry | Não |
AzureDiagnostics Logs de vários recursos de Azure. |
Não | Não | Queries |
| DirectMethods | Não |
AzureDiagnostics Logs de vários recursos de Azure. |
Não | Não | Queries |
| DistributedTracing | Não |
AzureDiagnostics Logs de vários recursos de Azure. |
Não | Não | Queries |
| FileUploadOperations | Não |
AzureDiagnostics Logs de vários recursos de Azure. |
Não | Não | Queries |
| JobsOperations | Não |
AzureDiagnostics Logs de vários recursos de Azure. |
Não | Não | Queries |
| Rotas | Não |
AzureDiagnostics Logs de vários recursos de Azure. |
Não | Não | Queries |
| TwinQueries | Não |
AzureDiagnostics Logs de vários recursos de Azure. |
Não | Não | Queries |
As seções a seguir listam os tipos de categoria de log de recursos e os esquemas coletados para 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 de nuvem para dispositivo rastreia erros que ocorrem no hub IoT e estão relacionados ao pipeline de mensagens da nuvem para o dispositivo. Essa categoria inclui erros que ocorrem de:
- Envio de mensagens da nuvem para o dispositivo (como erros de remetente não autorizados),
- Receber mensagens da nuvem para o dispositivo (como erros de contagem de entrega excedida) e
- Recebendo feedback de mensagens da nuvem para o dispositivo (como erros de feedback expirado).
Essa categoria não captura erros quando a mensagem da nuvem para o dispositivo é entregue com êxito, mas tratada incorretamente pelo dispositivo.
{
"records":
[
{
"time": " UTC timestamp",
"resourceId": "Resource Id",
"operationName": "messageExpired",
"category": "C2DCommands",
"level": "Error",
"resultType": "Event status",
"resultDescription": "MessageDescription",
"properties": "{\"deviceId\":\"<deviceId>\",\"messageId\":\"<messageId>\",\"messageSizeInBytes\":\"<messageSize>\",\"protocol\":\"Amqp\",\"deliveryAcknowledgement\":\"<None, NegativeOnly, PositiveOnly, Full>\",\"deliveryCount\":\"0\",\"expiryTime\":\"<timestamp>\",\"timeInSystem\":\"<timeInSystem>\",\"ttl\":<ttl>, \"EventProcessedUtcTime\":\"<UTC timestamp>\",\"EventEnqueuedUtcTime\":\"<UTC timestamp>\", \"maskedIpAddress\": \"<maskedIpAddress>\", \"statusCode\": \"4XX\"}",
"location": "Resource location"
}
]
}
Categoria de operações gêmeas da nuvem para o dispositivo
A categoria de operações de gêmeo de nuvem para dispositivo rastreia eventos iniciados pelo serviço em dispositivos gêmeos. Essas operações podem incluir obter gêmeo digital, atualizar ou substituir etiquetas, 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 de gêmeo do dispositivo para a nuvem
A categoria de operações do dispositivo para a nuvem gêmeo rastreia eventos iniciados pelo dispositivo em dispositivos gêmeos. Essas operações podem incluir obter gêmeo, 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 Configurações
Hub IoT logs de configuração rastreiam eventos e erros para o conjunto de recursos de Gerenciamento de Dispositivos automático.
{
"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, assim como erros. Essa categoria é útil para identificar tentativas de conexão não autorizadas e/ou alertar quando você perde a conexão com dispositivos.
Para obter o status de conexão confiável dos dispositivos, consulte Monitorar o status da conexão do dispositivo.
{
"records":
[
{
"time": " UTC timestamp",
"resourceId": "Resource Id",
"operationName": "deviceConnect",
"category": "Connections",
"level": "Information",
"properties": "{\"deviceId\":\"<deviceId>\",\"sdkVersion\":\"<sdkVersion>\",\"protocol\":\"<protocol>\",\"authType\":\"{\\\"scope\\\":\\\"device\\\",\\\"type\\\":\\\"sas\\\",\\\"issuer\\\":\\\"iothub\\\",\\\"acceptingIpFilterRule\\\":null}\",\"maskedIpAddress\":\"<maskedIpAddress>\"}",
"location": "Resource location"
}
]
}
Para obter informações detalhadas sobre como usar logs de conexões para monitorar a conectividade do dispositivo, consulte Monitor, diagnosticar e solucionar problemas de conectividade do dispositivo com Hub IoT do Azure.
Categoria de operações de identidade do dispositivo
A categoria de operações de identidade do dispositivo rastreia erros que ocorrem quando você tenta criar, atualizar ou excluir uma entrada no registro de identidade do hub IoT. Acompanhar essa 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 dispositivo (versão prévia)
A categoria de fluxos de dispositivos rastreia as interações de solicitação-resposta enviadas a dispositivos individuais.
{
"records":
[
{
"time": "2019-09-19T11:12:04Z",
"resourceId": "Resource Id",
"operationName": "invoke",
"category": "DeviceStreams",
"resultType": "",
"resultDescription": "",
"level": "Information",
"durationMs": "74",
"properties": "{\"deviceId\":\"myDevice\",\"moduleId\":\"myModule\",\"sdkVersion\":\"2019-05-01-preview\",\"requestSize\":\"3\",\"responseSize\":\"5\",\"statusCode\":null,\"requestName\":\"myRequest\",\"direction\":\"c2d\"}",
"location": "Central US"
}
]
}
Categoria de telemetria do dispositivo
A categoria de telemetria do dispositivo rastreia erros que ocorrem no hub IoT e estão relacionados ao pipeline de telemetria. Essa categoria inclui erros que ocorrem ao enviar eventos de telemetria (como limitação) e ao receber eventos de telemetria (como acesso não autorizado). Essa categoria não pode capturar erros causados pelo código em execução no próprio dispositivo.
{
"records":
[
{
"time": "UTC timestamp",
"resourceId": "Resource Id",
"operationName": "ingress",
"category": "DeviceTelemetry",
"level": "Error",
"resultType": "Event status",
"resultDescription": "MessageDescription",
"properties": "{\"deviceId\":\"<deviceId>\",\"batching\":\"0\",\"messageSizeInBytes\":\"<messageSizeInBytes>\",\"EventProcessedUtcTime\":\"<UTC timestamp>\",\"EventEnqueuedUtcTime\":\"<UTC timestamp>\",\"partitionId\":\"1\"}",
"location": "Resource location"
}
]
}
Categoria de métodos diretos
A categoria de métodos diretos acompanha as interações solicitação-resposta enviadas a dispositivos individuais. Essas solicitações são iniciadas na nuvem.
{
"records":
[
{
"time": "UTC timestamp",
"resourceId": "Resource Id",
"operationName": "send",
"category": "DirectMethods",
"level": "Information",
"durationMs": "1",
"properties": "{\"deviceId\":<messageSize>, \"RequestSize\": 1, \"ResponseSize\": 1, \"sdkVersion\": \"2017-07-11\"}",
"location": "Resource location"
}
]
}
Categoria de rastreamento distribuído (versão prévia)
A categoria de rastreamento distribuído rastreia as IDs de correlação para mensagens que carregam o cabeçalho de contexto de rastreamento.
O está correlationId em conformidade com a proposta do W3C Trace Context , onde contém um trace-id e um span-id.
logs de Hub IoT D2C (dispositivo para nuvem)
Hub IoT registra esse log quando uma mensagem que contém propriedades de rastreamento válidas chega ao Hub IoT.
{
"records":
[
{
"time": "UTC timestamp",
"resourceId": "Resource Id",
"operationName": "DiagnosticIoTHubD2C",
"category": "DistributedTracing",
"correlationId": "00-8cd869a412459a25f5b4f31311223344-0144d2590aacd909-01",
"level": "Information",
"resultType": "Success",
"resultDescription":"Receive message success",
"durationMs": "",
"properties": "{\"messageSize\": 1, \"deviceId\":\"<deviceId>\", \"callerLocalTimeUtc\": : \"2017-02-22T03:27:28.633Z\", \"calleeLocalTimeUtc\": \"2017-02-22T03:27:28.687Z\"}",
"location": "Resource location"
}
]
}
Observação
Aqui, durationMs não é calculado, pois o relógio de 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 na latência do dispositivo para a properties nuvem.
| Propriedade | Tipo | Descrição |
|---|---|---|
| messageSize | Número Inteiro | O tamanho da mensagem do dispositivo para a nuvem em bytes |
| deviceId | Sequência de caracteres alfanuméricos ASCII de 7 bits | A identidade do dispositivo |
| callerLocalTimeUtc | Carimbo de data/hora UTC | A hora de criação da mensagem, conforme relatado pelo relógio local do dispositivo |
| calleeLocalTimeUtc | Carimbo de data/hora UTC | A hora da chegada da mensagem no gateway do Hub IoT, conforme relatado por Hub IoT relógio do lado do serviço |
logs de entrada Hub IoT
Hub IoT registra esse log quando a mensagem que contém propriedades de rastreamento válidas é gravada 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 | Tipo | Descrição |
|---|---|---|
| isRoutingEnabled | fio | True ou false indica se o roteamento de mensagens está ou não habilitado no Hub IoT |
| parentSpanId | fio | O span-id da mensagem pai, que seria o rastreamento de mensagem D2C neste caso |
logs de saída Hub IoT
Hub IoT registra esse log quando routing está habilitado e a mensagem é gravada em um endpoint. Se o roteamento não estiver habilitado, 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 | Tipo | Descrição |
|---|---|---|
| endpointName | fio | O nome do ponto de extremidade de roteamento |
| endpointType | fio | O tipo do ponto de extremidade de roteamento |
| parentSpanId | fio | O span-id da mensagem pai, que seria o rastreamento de mensagem de entrada Hub IoT nesse caso |
Categoria de operações de upload de arquivo
A categoria de upload de arquivo rastreia erros que ocorrem no hub IoT e estão relacionados à funcionalidade de upload de arquivo. Esta categoria inclui:
- Erros que ocorrem com o URI SAS, como quando ele expira antes de um dispositivo notificar o hub sobre um upload concluído.
- Envios com falha relatados pelo dispositivo.
- Erros que ocorrem quando um arquivo não é encontrado no armazenamento durante Hub IoT criação da mensagem de notificação.
Essa categoria não pode capturar 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 trabalhos
A categoria de operações de trabalho relata solicitações de trabalho para atualizar dispositivos gêmeos ou invocar métodos diretos em vários dispositivos. Essas solicitações são iniciadas na nuvem.
{
"records":
[
{
"time": "UTC timestamp",
"resourceId": "Resource Id",
"operationName": "jobCompleted",
"category": "JobsOperations",
"level": "Information",
"durationMs": "1",
"properties": "{\"jobId\":\"<jobId>\", \"sdkVersion\": \"<sdkVersion>\",\"messageSize\": <messageSize>,\"filter\":\"DeviceId IN ['1414ded9-b445-414d-89b9-e48e8c6285d5']\",\"startTimeUtc\":\"Wednesday, September 13, 2017\",\"duration\":\"0\"}",
"location": "Resource location"
}
]
}
Categoria de rotas
A categoria message routing rastreia erros que ocorrem durante a avaliação da rota de mensagem e a integridade do ponto de extremidade, conforme percebido pelo Hub IoT. Essa categoria inclui eventos como:
- Uma regra é avaliada como "indefinida"
- Hub IoT marca um ponto de extremidade como morto
- Quaisquer erros recebidos de um ponto de extremidade
Essa categoria não inclui erros específicos sobre as mensagens em si (como erros de limitação de dispositivos), que são relatados na categoria "telemetria do dispositivo".
{
"records":
[
{
"time":"2019-12-12T03:25:14Z",
"resourceId":"/SUBSCRIPTIONS/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/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 logs de recursos de roteamento:
- Lista de códigos de erro do log de recursos de roteamento
- Lista de registros de recursos de roteamento de operações Nomes
Categoria de consultas gêmeas
A categoria de consultas gêmeas relata solicitações de consulta para dispositivos gêmeos 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 de Azure Monitor
Esta seção lista as tabelas de logs de Azure Monitor relevantes para esse serviço, que estão disponíveis para consulta por 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.
Hub IoT Microsoft. Devices/IotHubs
Log de atividades
A tabela vinculada lista as operações que podem ser registradas no log de atividades desse serviço. Essas operações são um subconjunto de todas as operações do provedor de recursos possíveis no log de atividades.
Para obter mais informações sobre o esquema de entradas do log de atividades, confira Esquema do log de atividades.
Conteúdo relacionado
- Consulte Monitor Hub IoT do Azure para obter uma descrição do monitoramento Hub IoT.
- Consulte Monitor Azure recursos com Azure Monitor para obter detalhes sobre o monitoramento de recursos de Azure.