Condividi tramite


hub IoT di Azure riferimento ai dati di monitoraggio

Questo articolo contiene tutte le informazioni di riferimento sul monitoraggio per questo servizio.

Vedere Monitorare Azure IoT per informazioni dettagliate sui dati che è possibile raccogliere per hub IoT e su come usarli.

Metrica

Questa sezione elenca tutte le metriche della piattaforma raccolte automaticamente per questo servizio. Queste metriche fanno anche parte dell'elenco globale di tutte le metriche della piattaforma supportate nel Monitoraggio di Azure.

Per informazioni sulla conservazione delle metriche, vedere Informazioni generali sulle metriche del Monitoraggio di Azure.

Metriche supportate per Microsoft.Devices/IoTHubs

La tabella seguente elenca le metriche disponibili per il tipo di risorsa Microsoft.Devices/IoTHubs.

  • Potrebbero non essere presenti tutte le colonne in ogni tabella.
  • Alcune colonne potrebbero superare l'area di visualizzazione della pagina. Selezionare Espandi tabella per visualizzare tutte le colonne disponibili.

Intestazioni di tabella

  • Categoria: gruppo o classificazione delle metriche.
  • Metrica: nome visualizzato della metrica come visualizzato nella portale di Azure.
  • Nome nell'API REST: nome della metrica indicato nell'API REST.
  • Unità: Unità di misura.
  • Aggregazione: tipo di aggregazione predefinito. Valori validi: Medio (Avg), Minimo (Min), Massimo (Max), Totale (Sum), Conteggio.
  • Dimensioni - Dimensioni disponibili per la metrica.
  • Intervalli di tempo - Intervalli in cui viene campionata la metrica. Ad esempio, PT1M indica che la metrica viene campionata ogni minuto, PT30M ogni 30 minuti, PT1H ogni ora e così via.
  • Esportazione DS: indica se la metrica è esportabile nei log di Monitoraggio di Azure tramite le impostazioni di diagnostica. Per informazioni sull'esportazione delle metriche, vedere Creare impostazioni di diagnostica nel Monitoraggio di Azure.
Metric Nome nell'API REST Unità Aggregazione Dimensioni Intervalli di tempo Esportazione DS
Messaggi C2D abbandonati

Numero di messaggi da cloud a dispositivo abbandonati dal dispositivo
c2d.commands.egress.abandon.success Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Recapito dei messaggi C2D completato

Numero di recapito dei messaggi da cloud a dispositivo completati correttamente dal dispositivo
c2d.commands.egress.complete.success Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Messaggi C2D rifiutati

Numero di messaggi da cloud a dispositivo rifiutati dal dispositivo
c2d.commands.egress.reject.success Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Chiamate al metodo diretto non riuscite

Numero di tutte le chiamate a metodi diretti non riuscite.
c2d.methods.failure Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Dimensioni della richiesta di chiamate al metodo diretto

Dimensioni medie, minime e massime delle richieste di chiamate a metodi diretti riuscite.
c2d.methods.requestSize Byte Average, Minimum, Maximum, Total (Sum) <none> PT1M
Dimensioni della risposta delle chiamate al metodo diretto

Dimensioni medie, minime e massime delle risposte a chiamate a metodi diretti riuscite.
c2d.methods.responseSize Byte Average, Minimum, Maximum, Total (Sum) <none> PT1M
Chiamate al metodo diretto riuscite

Numero di tutte le chiamate a metodi diretti riuscite.
c2d.methods.success Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Letture dei dispositivi gemelli non riuscite dal back-end

Numero di tutte le letture dei dispositivi gemelli avviate dal back-end non riuscite.
c2d.twin.read.failure Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Dimensioni della risposta dei dispositivi gemelli letti dal back-end

Numero medio, minimo e massimo di letture dei dispositivi gemelli avviate dal back-end completate.
c2d.twin.read.size Byte Average, Minimum, Maximum, Total (Sum) <none> PT1M
Letture dei dispositivi gemelli riuscite dal back-end

Numero di tutte le letture dei dispositivi gemelli avviate dal back-end completate.
c2d.twin.read.success Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Aggiornamenti dei dispositivi gemelli non riusciti dal back-end

Numero di tutti gli aggiornamenti dei dispositivi gemelli avviati dal back-end non riusciti.
c2d.twin.update.failure Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Dimensioni degli aggiornamenti dei dispositivi gemelli dal back-end

Dimensioni medie, minime e massime degli aggiornamenti dei dispositivi gemelli avviati dal back-end completati.
c2d.twin.update.size Byte Average, Minimum, Maximum, Total (Sum) <none> PT1M
Aggiornamenti dei dispositivi gemelli riusciti dal back-end

Numero di tutti gli aggiornamenti dei dispositivi gemelli avviati dal back-end completati.
c2d.twin.update.success Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Messaggi C2D scaduti

Numero di messaggi da cloud a dispositivo scaduti
C2DMessagesExpired Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Metriche di configurazione

Metriche per le operazioni di configurazione
configurations Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Dispositivi connessi

Il numero di dispositivi connessi all'hub IoT
connectedDeviceCount Count Media, Massimo, Minimo <none> PT1M No
Routing: messaggi recapitati a messaggi/eventi

Numero di volte in cui il routing dell'hub IoT ha recapitato i messaggi all'endpoint predefinito (messaggi/eventi).
d2c.endpoints.egress.builtIn.events Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Routing: messaggi recapitati all'hub eventi

Numero di volte in cui il routing dell'hub IoT ha recapitato i messaggi agli endpoint dell'hub eventi.
d2c.endpoints.egress.eventHubs Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Routing: messaggi recapitati alla coda bus di servizio

Numero di volte in cui il routing dell'hub IoT ha recapitato i messaggi agli endpoint della coda del bus di servizio.
d2c.endpoints.egress.serviceBusQueues Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Routing: messaggi recapitati a bus di servizio argomento

Numero di volte in cui il routing dell'hub IoT ha recapitato i messaggi agli endpoint dell'argomento del bus di servizio.
d2c.endpoints.egress.serviceBusTopics Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Routing: messaggi recapitati all'archiviazione

Numero di volte in cui il routing dell'hub IoT ha recapitato i messaggi agli endpoint di archiviazione.
d2c.endpoints.egress.storage Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Routing: BLOB recapitati all'archiviazione

Numero di volte in cui routing dell'hub IoT ha recapitato BLOB agli endpoint di archiviazione.
d2c.endpoints.egress.storage.blobs Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Routing: dati recapitati all'archiviazione

Quantità di dati (byte) che il routing dell'hub IoT ha recapitato agli endpoint di archiviazione.
d2c.endpoints.egress.storage.bytes Byte Average, Minimum, Maximum, Total (Sum) <none> PT1M
Routing: latenza dei messaggi per messaggi/eventi

Latenza media (in millisecondi) tra l'ingresso del messaggio nell'hub IoT e l'ingresso del messaggio nell'endpoint predefinito (messaggi/eventi).
d2c.endpoints.latency.builtIn.events Millisecondi Average, Minimum, Maximum <none> PT1M
Routing: latenza dei messaggi per Hub eventi

Latenza media (in millisecondi) tra l'ingresso del messaggio nell'hub IoT e l'ingresso del messaggio in un endpoint dell'hub eventi.
d2c.endpoints.latency.eventHubs Millisecondi Average, Minimum, Maximum <none> PT1M
Routing: latenza dei messaggi per bus di servizio coda

Latenza media (in millisecondi) tra l'ingresso dei messaggi all'hub IoT e l'ingresso dei messaggi di telemetria in un endpoint della coda del bus di servizio.
d2c.endpoints.latency.serviceBusQueues Millisecondi Average, Minimum, Maximum <none> PT1M
Routing: latenza dei messaggi per bus di servizio argomento

Latenza media (in millisecondi) tra l'ingresso dei messaggi all'hub IoT e l'ingresso dei messaggi di telemetria in un endpoint dell'argomento del bus di servizio.
d2c.endpoints.latency.serviceBusTopics Millisecondi Average, Minimum, Maximum <none> PT1M
Routing: latenza dei messaggi per l'archiviazione

Latenza media (in millisecondi) tra l'ingresso dei messaggi all'hub IoT e l'ingresso dei messaggi di telemetria in un endpoint di archiviazione.
d2c.endpoints.latency.storage Millisecondi Average, Minimum, Maximum <none> PT1M
Routing: messaggi di telemetria eliminati

Numero di volte in cui i messaggi sono stati eliminati dal routing dell'hub IoT a causa degli endpoint inattivi. Questo valore non include messaggi recapitati alla route di fallback perché i messaggi eliminati non vengono recapitati in tale punto.
d2c.telemetry.egress.dropped Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Routing: messaggi recapitati al fallback

Numero di volte in cui il routing dell'hub IoT ha recapitato i messaggi all'endpoint associato con la route di fallback.
d2c.telemetry.egress.fallback Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Routing: messaggi di telemetria incompatibili

Numero di volte in cui il routing dell'hub IoT non è riuscito a recapitare i messaggi a causa di un'incompatibilità con l'endpoint. Questo valore non include i nuovi tentativi.
d2c.telemetry.egress.invalid Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Routing: messaggi di telemetria orfani

Numero di volte in cui i messaggi sono stati resi orfani dal routing dell'hub IoT perché non corrispondono ad alcuna regola di routing (inclusa la regola di fallback).
d2c.telemetry.egress.orphaned Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Routing: messaggi di telemetria recapitati

Numero di volte in cui i messaggi sono stati recapitati correttamente a tutti gli endpoint tramite routing dell'hub IoT. Se un messaggio viene indirizzato a più endpoint, questo valore aumenta di uno per ogni recapito con esito positivo. Se un messaggio viene recapitato più volte allo stesso endpoint, questo valore aumenta di uno per ogni recapito con esito positivo.
d2c.telemetry.egress.success Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Tentativi di invio di messaggi di telemetria

Il numero di messaggi di telemetria da dispositivo a cloud che si è cercato di inviare all'hub IoT
d2c.telemetry.ingress.allProtocol Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Numero di errori di limitazione

Numero di errori di limitazione dovuti alle limitazioni della velocità effettiva del dispositivo
d2c.telemetry.ingress.sendThrottle Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Messaggi di telemetria inviati

Il numero di messaggi di telemetria da dispositivo a cloud inviati all'hub IoT
d2c.telemetry.ingress.success Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Letture dei dispositivi gemelli non riuscite

Numero di tutte le letture dei dispositivi gemelli avviate dal dispositivo non riuscite.
d2c.twin.read.failure Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Dimensioni della risposta delle letture dei dispositivi gemelli

Numero medio, minimo e massimo di letture dei dispositivi gemelli avviate dal dispositivo completate.
d2c.twin.read.size Byte Average, Minimum, Maximum, Total (Sum) <none> PT1M
Letture dei dispositivi gemelli riuscite

Numero di tutte le letture dei dispositivi gemelli avviate dal dispositivo completate.
d2c.twin.read.success Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Aggiornamenti dei dispositivi gemelli non riusciti

Numero di tutti gli aggiornamenti dei dispositivi gemelli avviati dal dispositivo non riusciti.
d2c.twin.update.failure Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Dimensioni degli aggiornamenti dei dispositivi gemelli

Dimensioni medie, minime e massime degli aggiornamenti dei dispositivi gemelli avviati dal dispositivo completati.
d2c.twin.update.size Byte Average, Minimum, Maximum, Total (Sum) <none> PT1M
Aggiornamenti dei dispositivi gemelli riusciti

Numero di tutti gli aggiornamenti dei dispositivi gemelli avviati dal dispositivo completati.
d2c.twin.update.success Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Numero totale di messaggi usati

Numero totale di messaggi usati nella data odierna
dailyMessageQuotaUsed Count Average, Minimum, Maximum <none> PT1M
Utilizzo totale dei dati del dispositivo

Byte trasferiti a e da qualsiasi dispositivo connesso all'hub IoT
deviceDataUsage Byte Average, Minimum, Maximum, Total (Sum) <none> PT1M
Utilizzo totale dei dati del dispositivo (anteprima)

Byte trasferiti a e da qualsiasi dispositivo connesso all'hub IoT
deviceDataUsageV2 Byte Average, Minimum, Maximum, Total (Sum) <none> PT1M
Dispositivi connessi (deprecati)

Il numero di dispositivi connessi all'hub IoT
devices.connectedDevices.allProtocol Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Totale dispositivi (deprecato)

Il numero di dispositivi registrati nell'hub IoT
devices.totalDevices Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Consegne di Griglia di eventi

Il numero di eventi dell'hub IoT pubblicati in Griglia di eventi. Usare la dimensione Result per il numero di richieste riuscite e non riuscite. La dimensione EventType mostra il tipo di evento (https://aka.ms/ioteventgrid).
EventGridDeliveries Count Average, Minimum, Maximum, Total (Sum) Result, EventType PT1M
Latenza di Griglia di eventi

La latenza media (millisecondi) tra il momento in cui l'evento dell'hub IoT viene generato e il momento in cui viene pubblicato in Griglia di eventi. Questo numero è una media tra tutti i tipi di evento. Usare la dimensione EventType per visualizzare la latenza di un tipo specifico di evento.
EventGridLatency Millisecondi Average, Minimum, Maximum EventType PT1M
Annullamenti di processi non riusciti

Numero di tutte le chiamate per annullare i processi non riuscite.
jobs.cancelJob.failure Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Annullamenti di processi riusciti

Numero di tutte le chiamate per annullare i processi riuscite.
jobs.cancelJob.success Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Processi completati

Numero di tutti i processi completati.
jobs.completed Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Creazioni non riuscite di processi di chiamata al metodo

Numero di tutte le creazioni di processi di chiamata a metodi diretti non riuscite.
jobs.createDirectMethodJob.failure Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Creazioni riuscite di processi di chiamata al metodo

Numero di tutte le creazioni di processi di chiamata a metodi diretti completate.
jobs.createDirectMethodJob.success Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Creazioni non riuscite dei processi di aggiornamento dei dispositivi gemelli

Numero di tutte le creazioni di processi di aggiornamento dei dispositivi gemelli non riuscite.
jobs.createTwinUpdateJob.failure Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Creazioni riuscite dei processi di aggiornamento dei dispositivi gemelli

Numero di tutte le creazioni di processi di aggiornamento dei dispositivi gemelli completate.
jobs.createTwinUpdateJob.success Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Processi non riusciti

Numero di tutti i processi non riusciti.
jobs.failed Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Chiamate non riuscite per elencare i processi

Numero di tutte le chiamate per elencare i processi non riuscite.
jobs.listJobs.failure Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Chiamate riuscite per elencare i processi

Numero di tutte le chiamate per elencare i processi riuscite.
jobs.listJobs.success Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Query di processo non riuscite

Numero di tutte le chiamate per eseguire query sui processi non riuscite.
jobs.queryJobs.failure Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Query di processo riuscite

Numero di tutte le chiamate per eseguire query sui processi riuscite.
jobs.queryJobs.success Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Routing delle dimensioni dei messaggi di recapito in byte (anteprima)

Dimensioni totali in byte di messaggi recapitati dall'hub IoT a un endpoint. È possibile usare le dimensioni EndpointName e EndpointType per visualizzare le dimensioni dei messaggi in byte recapitati ai diversi endpoint. Il valore della metrica aumenta per ogni messaggio recapitato, incluso se il messaggio viene recapitato a più endpoint o se il messaggio viene recapitato più volte allo stesso endpoint.
RoutingDataSizeInBytesDelivered Byte Average, Minimum, Maximum, Total (Sum) EndpointType, EndpointName, RoutingSource PT1M
Routing Deliveries (anteprima)

Numero di tentativi hub IoT di recapitare messaggi a tutti gli endpoint usando il routing. Per visualizzare il numero di tentativi riusciti o non riusciti, utilizzare la dimensione Result. Per visualizzare il motivo dell'errore, ad esempio non valido, eliminato o orfano, usare la dimensione FailureReasonCategory. È anche possibile usare le dimensioni EndpointName e EndpointType per comprendere il numero di messaggi recapitati ai diversi endpoint. Il valore della metrica aumenta di uno per ogni tentativo di recapito, incluso se il messaggio viene recapitato a più endpoint o se il messaggio viene recapitato più volte allo stesso endpoint.
RoutingDeliveries Count Average, Minimum, Maximum, Total (Sum) EndpointType, EndpointName, FailureReasonCategory, ResultRoutingSource PT1M
Latenza recapito routing (anteprima)

Latenza media (millisecondi) tra l'ingresso del messaggio a hub IoT e l'ingresso dei messaggi di telemetria in un endpoint. È possibile usare le dimensioni EndpointName e EndpointType per comprendere la latenza per i diversi endpoint.
RoutingDeliveryLatency Millisecondi Average, Minimum, Maximum EndpointType, EndpointName, RoutingSource PT1M
Totale dispositivi

Il numero di dispositivi registrati nell'hub IoT
totalDeviceCount Count Media, Massimo, Minimo <none> PT1M No
Query gemelle non riuscite

Numero di tutte le query dei dispositivi gemelli non riuscite.
twinQueries.failure Count Average, Minimum, Maximum, Total (Sum) <none> PT1M
Dimensioni dei risultati delle query gemelle

Dimensioni medie, minime e massime dei risultati delle query dei dispositivi gemelli.
twinQueries.resultSize Byte Average, Minimum, Maximum, Total (Sum) <none> PT1M
Query dei dispositivi gemelli riuscite

Numero di tutte le query dei dispositivi gemelli completate.
twinQueries.success Count Average, Minimum, Maximum, Total (Sum) <none> PT1M

Aggregazioni supportate

La colonna Tipo di aggregazione nella tabella corrisponde all'aggregazione predefinita usata quando la metrica viene selezionata per un grafico o un avviso.

Screenshot che mostra l'aggregazione per le metriche.

Per la maggior parte delle metriche, tutti i tipi di aggregazione sono validi. Per le metriche di conteggio con un valore di colonna Unit pari a Count, sono valide solo alcune aggregazioni. Le metriche di conteggio possono essere uno dei due tipi seguenti:

  • Per le metriche con conteggio a singolo punto, hub IoT registra un singolo punto dati (essenzialmente un 1) ogni volta che si verifica l'operazione misurata. Monitoraggio di Azure somma quindi questi punti dati sulla granularità specificata. Esempi di metriche a singolo punto sono i messaggi di telemetria inviati e i recapito dei messaggi C2D completati. Per queste metriche, l'unico tipo di aggregazione rilevante è Total (Sum). Il portale consente di scegliere minimo, massimo e medio. Questi valori sono sempre 1.

  • Per le metriche del numero di snapshot, hub IoT registra un conteggio totale quando si verifica l'operazione misurata. Attualmente sono disponibili tre metriche snapshot generate da hub IoT: numero totale di messaggi usati, Dispositivi totali e Dispositivi connessi. Poiché queste metriche presentano una quantità "totale" ogni volta, sommarle sulla granularità specificata non ha senso. Monitoraggio di Azure limita la selezione della media, del valore minimo e massimo per il tipo di aggregazione per queste metriche.

Dimensioni delle metriche

Per informazioni sulle dimensioni delle metriche, vedere Metriche multidimensionali.

Questo servizio ha le dimensioni seguenti associate alle relative metriche.

Nome dimensione Descrizione
EndpointName Nome dell'endpoint
EndpointType eventHubs, serviceBusQueues, cosmosDB, serviceBusTopics, builtin o blobStorage
EventType Microsoft.Devices.DeviceCreated, Microsoft.Devices.DeviceDeleted, Microsoft.Devices.DeviceConnected, Microsoft.Devices.DeviceDisconnected o Microsoft.Devices.DeviceTelemetry
Per altre informazioni, vedere Tipi di evento.
FailureReasonCategory Uno dei valori seguenti: invalid, dropped, orphanedo null.
Risultato Il valore può essere success o failure
RoutingSource Device Messages, Twin Change Events, Device Lifecycle Events

Nome visualizzato e aggregazione delle metriche

Le tabelle seguenti forniscono altre informazioni sulle metriche descritte nella tabella precedente. Mostrano le metriche della piattaforma hub IoT per categoria generale ed elencare le metriche in base al nome visualizzato assegnato nel portale di Azure.

Metriche dei comandi da cloud a dispositivo:

Nome visualizzato della metrica Metric Unità Descrizione
Messaggi C2D scaduti C2DMessagesExpired Count Numero di messaggi da cloud a dispositivo scaduti
C2D message deliveries completed (Recapiti messaggi C2D completati) c2d.commands.egress.complete.success Count Numero di recapito dei messaggi da cloud a dispositivo completati correttamente dal dispositivo
C2D messages abandoned (Messaggi C2D abbandonati) c2d.commands.egress.abandon.success Count Numero di messaggi da cloud a dispositivo abbandonati dal dispositivo
C2D messages rejected (Messaggi C2D rifiutati) c2d.commands.egress.reject.success Count Numero di messaggi da cloud a dispositivo rifiutati dal dispositivo

Per le metriche con un valore unit di Count, è valida solo l'aggregazione totale (somma). Le aggregazioni minime, massime e medie restituiscono sempre 1. Per altre informazioni, vedere Aggregazioni supportate.

Metriche dei metodi diretti da cloud a dispositivo:

Nome visualizzato della metrica Metric Unità Descrizione
Chiamate a metodi diretti non riuscite c2d.methods.failure Count Numero di tutte le chiamate a metodi diretti non riuscite.
Dimensioni delle richieste di chiamate a metodi diretti c2d.methods.requestSize Byte Conteggio di tutte le richieste di metodo diretto riuscite.
Dimensioni delle risposte a chiamate a metodi diretti c2d.methods.responseSize Byte Conteggio di tutte le risposte al metodo diretto riuscite.
Chiamate a metodi diretti riuscite c2d.methods.success Count Numero di tutte le chiamate a metodi diretti riuscite.

Per le metriche con un valore unitario di aggregazione Conteggio solo totale (somma) è valida. Le aggregazioni minime, massime e medie restituiscono sempre 1. Per altre informazioni, vedere Aggregazioni supportate.

Metriche delle operazioni da cloud a dispositivo gemello:

Nome visualizzato della metrica Metric Unità Descrizione
Letture dei dispositivi gemelli non riuscite per il back-end c2d.twin.read.failure Count Numero di tutte le letture dei dispositivi gemelli avviate dal back-end non riuscite.
Aggiornamenti dei dispositivi gemelli non riusciti per il back-end c2d.twin.update.failure Count Numero di tutti gli aggiornamenti dei dispositivi gemelli avviati dal back-end non riusciti.
Dimensioni delle risposte di letture dei dispositivi gemelli dal back-end c2d.twin.read.size Byte Numero di tutte le letture dei dispositivi gemelli avviate dal back-end completate.
Dimensioni degli aggiornamenti dei dispositivi gemelli dal back-end c2d.twin.update.size Byte Dimensioni totali di tutti gli aggiornamenti dei dispositivi gemelli avviati dal back-end.
Letture dei dispositivi gemelli completate dal back-end c2d.twin.read.success Count Numero di tutte le letture dei dispositivi gemelli avviate dal back-end completate.
Aggiornamenti dei dispositivi gemelli completati dal back-end c2d.twin.update.success Count Numero di tutti gli aggiornamenti dei dispositivi gemelli avviati dal back-end completati.

Per le metriche con un valore unit di Count, è valida solo l'aggregazione totale (somma). Le aggregazioni minime, massime e medie restituiscono sempre 1. Per altre informazioni, vedere Aggregazioni supportate.

Metriche delle configurazioni:

Nome visualizzato della metrica Metric Unità Descrizione
Metriche di configurazione configurazioni Count Numero di operazioni CRUD totali eseguite per la configurazione del dispositivo e la distribuzione di IoT Edge in un set di dispositivi di destinazione. Sono incluse il numero di operazioni che modificano il dispositivo gemello o il modulo gemello a causa di queste configurazioni.

Per le metriche con un valore unit di Count, è valida solo l'aggregazione totale (somma). Le aggregazioni minime, massime e medie restituiscono sempre 1. Per altre informazioni, vedere Aggregazioni supportate.

Metriche della quota giornaliera:

Nome visualizzato della metrica Metric Unità Descrizione
Total device data usage (Utilizzo totale dati dispositivo) deviceDataUsage Byte Byte trasferiti a e da qualsiasi dispositivo connesso all'hub IoT
Uso totale dei dati del dispositivo (anteprima) deviceDataUsageV2 Totale Byte trasferiti a e da qualsiasi dispositivo connesso all'hub IoT
Total number of messages used (Numero totale di messaggi usati) dailyMessageQuotaUsed Count Numero totale di messaggi usati nella data odierna. Valore cumulativo che viene reimpostato su zero alle 00:00 UTC ogni giorno.

Per Numero totale di messaggi usati, sono supportate solo le aggregazioni minime, massime e medie. Per altre informazioni, vedere Aggregazioni supportate.

Metriche del dispositivo:

Nome visualizzato della metrica Metric Unità Descrizione
Dispositivi totali (deprecati) devices.totalDevices Count Il numero di dispositivi registrati nell'hub IoT
Dispositivi connessi (deprecati) devices.connectedDevices.allProtocol Count Il numero di dispositivi connessi all'hub IoT
Totale dispositivi totalDeviceCount Count Il numero di dispositivi registrati nell'hub IoT
Dispositivi connessi connectedDeviceCount Count Il numero di dispositivi connessi all'hub IoT

Per i dispositivi totali (deprecati) e i dispositivi connessi (deprecati), l'aggregazione totale (somma) è valida. Le aggregazioni minime, massime e medie restituiscono sempre 1. Per altre informazioni, vedere Aggregazioni supportate.

Per Dispositivi totali e Dispositivi connessi, sono valide solo le aggregazioni minime, massime e medie. Per altre informazioni, vedere Aggregazioni supportate.

I dispositivi totali e i dispositivi connessi non sono esportabili tramite le impostazioni di diagnostica.

Metriche di telemetria del dispositivo:

Nome visualizzato della metrica Metric Unità Descrizione
Number of throttling errors (Numero di errori di limitazione) d2c.telemetry.ingress.sendThrottle Count Numero di errori di limitazione dovuti alle limitazioni della velocità effettiva del dispositivo
Tentativi di telemetria 'message send' d2c.telemetry.ingress.allProtocol Count Il numero di messaggi di telemetria da dispositivo a cloud che si è cercato di inviare all'hub IoT
Messaggi di telemetria inviati d2c.telemetry.ingress.success Count Il numero di messaggi di telemetria da dispositivo a cloud inviati all'hub IoT

Per le metriche con un valore unit di Count, è valida solo l'aggregazione totale (somma). Le aggregazioni minime, massime e medie restituiscono sempre 1. Per altre informazioni, vedere Aggregazioni supportate.

Metriche delle operazioni da dispositivo a cloud gemello:

Nome visualizzato della metrica Metric Unità Descrizione
Letture dei dispositivi gemelli non riuscite per i dispositivi d2c.twin.read.failure Count Numero di tutte le letture dei dispositivi gemelli avviate dal dispositivo non riuscite.
Aggiornamenti dei dispositivi gemelli non riusciti per i dispositivi d2c.twin.update.failure Count Numero di tutti gli aggiornamenti dei dispositivi gemelli avviati dal dispositivo non riusciti.
Dimensioni delle risposte di letture dei dispositivi gemelli dai dispositivi d2c.twin.read.size Byte Numero di letture dei dispositivi gemelli avviate correttamente.
Dimensioni degli aggiornamenti dei dispositivi gemelli dai dispositivi d2c.twin.update.size Byte Dimensioni totali di tutti gli aggiornamenti dei dispositivi gemelli avviati correttamente.
Letture dei dispositivi gemelli completate dai dispositivi d2c.twin.read.success Count Numero di tutte le letture dei dispositivi gemelli avviate dal dispositivo completate.
Aggiornamenti dei dispositivi gemelli completati dai dispositivi d2c.twin.update.success Count Numero di tutti gli aggiornamenti dei dispositivi gemelli avviati dal dispositivo completati.

Per le metriche con un valore unit di Count, è valida solo l'aggregazione totale (somma). Le aggregazioni minime, massime e medie restituiscono sempre 1. Per altre informazioni, vedere Aggregazioni supportate.

Metriche di Griglia di eventi:

Nome visualizzato della metrica Metric Unità Descrizione
Consegne di Griglia di eventi EventGridDeliveries Count Il numero di eventi dell'hub IoT pubblicati in Griglia di eventi. Usare la dimensione Result per il numero di richieste riuscite e non riuscite. La dimensione EventType mostra il tipo di evento (https://aka.ms/ioteventgrid).
Latenza di Griglia di eventi EventGridLatency Millisecondi La latenza media (millisecondi) tra il momento in cui l'evento dell'hub IoT viene generato e il momento in cui viene pubblicato in Griglia di eventi. Questo numero è una media tra tutti i tipi di evento. Usare la dimensione EventType per visualizzare la latenza di un tipo specifico di evento.

Per le metriche con un valore unit di Count, è valida solo l'aggregazione totale (somma). Le aggregazioni minime, massime e medie restituiscono sempre 1. Per altre informazioni, vedere Aggregazioni supportate.

Metriche dei processi:

Nome visualizzato della metrica Metric Unità Descrizione
Processi completati jobs.completed Count Numero di tutti i processi completati.
Chiamate per elencare i processi non riuscite jobs.listJobs.failure Count Numero di tutte le chiamate per elencare i processi non riuscite.
Creazioni di processi di chiamata al metodo non riuscite jobs.createDirectMethodJob.failure Count Numero di tutte le creazioni di processi di chiamata a metodi diretti non riuscite.
Creazioni di processi di aggiornamento dei dispositivi gemelli non riuscite jobs.createTwinUpdateJob.failure Count Numero di tutte le creazioni di processi di aggiornamento dei dispositivi gemelli non riuscite.
Annullamenti di processi non riusciti jobs.cancelJob.failure Count Numero di tutte le chiamate per annullare i processi non riuscite.
Query sui processi non riuscite jobs.queryJobs.failure Count Numero di tutte le chiamate per eseguire query sui processi non riuscite.
Processi non riusciti jobs.failed Count Numero di tutti i processi non riusciti.
Chiamate per elencare i processi riuscite jobs.listJobs.success Count Numero di tutte le chiamate per elencare i processi riuscite.
Creazioni di processi di chiamata al metodo completate jobs.createDirectMethodJob.success Count Numero di tutte le creazioni di processi di chiamata a metodi diretti completate.
Creazioni di processi di aggiornamento dei dispositivi gemelli completate jobs.createTwinUpdateJob.
esito positivo
Count Numero di tutte le creazioni di processi di aggiornamento dei dispositivi gemelli completate.
Annullamenti di processi riusciti jobs.cancelJob.success Count Numero di tutte le chiamate per annullare i processi riuscite.
Query sui processi riuscite jobs.queryJobs.success Count Numero di tutte le chiamate per eseguire query sui processi riuscite.

Per le metriche con un valore unit di Count, è valida solo l'aggregazione totale (somma). Le aggregazioni minime, massime e medie restituiscono sempre 1. Per altre informazioni, vedere Aggregazioni supportate.

Metriche di routing:

Nome visualizzato della metrica Metric Unità Descrizione
Routing Deliveries (anteprima) RoutingDeliveries Count Metrica di recapito del routing. Usare le dimensioni per identificare lo stato di recapito per un endpoint specifico o per un'origine di routing specifica.
Routing Delivery Message Size In Byte (anteprima) RoutingDataSizeInBytesDelivered Byte Numero totale di byte indirizzati da hub IoT all'endpoint personalizzato e all'endpoint predefinito. Usare le dimensioni per identificare le dimensioni dei dati indirizzate a un endpoint specifico o per un'origine di routing specifica.
Latenza recapito routing (anteprima) RoutingDeliveryLatency Millisecondi Metrica di latenza di recapito del routing. Usare le dimensioni per identificare la latenza per un endpoint specifico o per un'origine di routing specifica.
Routing: BLOB recapitati all'archiviazione d2c.endpoints.egress.storage.blobs Count Numero di volte in cui routing dell'hub IoT ha recapitato BLOB agli endpoint di archiviazione.
Routing: dati recapitati all'archiviazione d2c.endpoints.egress.storage.bytes Byte Quantità di dati (byte) che il routing dell'hub IoT ha recapitato agli endpoint di archiviazione.
Routing: latenza dei messaggi per Hub eventi d2c.endpoints.latency.eventHubs Millisecondi Latenza media (millisecondi) tra l'ingresso del messaggio a hub IoT e l'ingresso dei messaggi in endpoint personalizzati di tipo Hub eventi. Le route dei messaggi all'endpoint predefinito (eventi) non sono incluse.
Routing: latenza dei messaggi per la coda del bus di servizio d2c.endpoints.latency.serviceBusQueues Millisecondi Latenza media (millisecondi) tra l'ingresso del messaggio a hub IoT e l'ingresso dei messaggi in un endpoint della coda bus di servizio.
Routing: latenza dei messaggi per l'argomento del bus di servizio d2c.endpoints.latency.serviceBusTopics Millisecondi Latenza media (millisecondi) tra l'ingresso del messaggio a hub IoT e l'ingresso dei messaggi in un endpoint dell'argomento bus di servizio.
Routing: latenza dei messaggi per messaggi/eventi d2c.endpoints.latency.builtIn.events Millisecondi Latenza media (millisecondi) tra l'ingresso del messaggio a hub IoT e l'ingresso dei messaggi nell'endpoint predefinito (messaggi/eventi) e nella route di fallback.
Routing: latenza dei messaggi per l'archiviazione d2c.endpoints.latency.storage Millisecondi Latenza media (millisecondi) tra l'ingresso del messaggio a hub IoT e l'ingresso dei messaggi in un endpoint di archiviazione.
Routing: messaggi recapitati a Hub eventi d2c.endpoints.egress.eventHubs Count Numero di volte in cui hub IoT il routing ha recapitato correttamente i messaggi agli endpoint personalizzati di tipo Hub eventi. Le route dei messaggi all'endpoint predefinito (eventi) non sono incluse.
Routing: messaggi recapitati alla coda del bus di servizio d2c.endpoints.egress.serviceBusQueues Count Numero di volte in cui il routing dell'hub IoT ha recapitato i messaggi agli endpoint della coda del bus di servizio.
Routing: messaggi recapitati all'argomento del bus di servizio d2c.endpoints.egress.serviceBusTopics Count Numero di volte in cui il routing dell'hub IoT ha recapitato i messaggi agli endpoint dell'argomento del bus di servizio.
Routing: messaggi recapitati al fallback d2c.telemetry.egress.fallback Count Numero di volte in cui il routing dell'hub IoT ha recapitato i messaggi all'endpoint associato con la route di fallback.
Routing: messaggi recapitati a messaggi/eventi d2c.endpoints.egress.builtIn.events Count Numero di volte in cui hub IoT il routing ha recapitato correttamente i messaggi all'endpoint predefinito (messaggi/eventi) e alla route di fallback.
Routing: messaggi recapitati all'archiviazione d2c.endpoints.egress.storage Count Numero di volte in cui il routing dell'hub IoT ha recapitato i messaggi agli endpoint di archiviazione.
Routing: messaggi di telemetria recapitati d2c.telemetry.egress.success Count Numero di volte in cui i messaggi sono stati recapitati correttamente a tutti gli endpoint tramite routing dell'hub IoT. Se un messaggio viene indirizzato a più endpoint, questo valore aumenta di uno per ogni recapito con esito positivo. Se un messaggio viene recapitato più volte allo stesso endpoint, questo valore aumenta di uno per ogni recapito con esito positivo.
Routing: messaggi di telemetria eliminati d2c.telemetry.egress.dropped Count Il numero di volte in cui il routing hub IoT elimina i messaggi a causa di endpoint non recapitabili. Questo valore non conta i messaggi recapitati alla route di fallback perché i messaggi eliminati non vengono recapitati lì.
Routing: messaggi di telemetria incompatibili d2c.telemetry.egress.invalid Count Numero di volte in cui il routing dell'hub IoT non è riuscito a recapitare i messaggi a causa di un'incompatibilità con l'endpoint. Un messaggio non è compatibile con un endpoint quando l'hub Iot tenta di recapitare il messaggio a un endpoint e ha esito negativo con un errore non transiente. I messaggi non validi non vengono ritentati. Questo valore non include nuovi tentativi.
Routing: messaggi di telemetria orfani d2c.telemetry.egress.orphaned Count Numero di volte in cui hub IoT il routing dei messaggi orfani perché non corrispondono ad alcuna query di routing, quando la route di fallback è disabilitata.

Per le metriche con un valore unit di Count, è valida solo l'aggregazione totale (somma). Le aggregazioni minime, massime e medie restituiscono sempre 1. Per altre informazioni, vedere Aggregazioni supportate.

Metriche di query gemelle:

Nome visualizzato della metrica Metric Unità Descrizione
Query dei dispositivi gemelli non riuscite twinQueries.failure Count Numero di tutte le query dei dispositivi gemelli non riuscite.
Query dei dispositivi gemelli completate twinQueries.success Count Numero di tutte le query dei dispositivi gemelli completate.
Dimensioni dei risultati delle query dei dispositivi gemelli twinQueries.resultSize Byte Totale delle dimensioni dei risultati di tutte le query gemelle riuscite.

Per le metriche con un valore unit di Count, è valida solo l'aggregazione totale (somma). Le aggregazioni minime, massime e medie restituiscono sempre 1. Per altre informazioni, vedere Aggregazioni supportate.

Log risorse

Questa sezione elenca i tipi di log delle risorse che si possono raccogliere per questo servizio. La sezione esegue il pull dall'elenco di tutti i tipi di categoria dei log delle risorse supportati nel Monitoraggio di Azure.

Log delle risorse supportati per Microsoft.Devices/IotHubs

Categoria Nome visualizzato della categoria Tabella di log Supporta il piano di log di base Supporta la trasformazione in fase di inserimento Query di esempio Costi da esportare
C2DCommands Comandi da cloud a dispositivo AzureDiagnostics

Log da più risorse di Azure.

No No Query No
C2DTwinOperations Operazioni da cloud a dispositivi gemelli AzureDiagnostics

Log da più risorse di Azure.

No No Query No
Configurations Configurazioni AzureDiagnostics

Log da più risorse di Azure.

No No Query No
Connections Connessioni AzureDiagnostics

Log da più risorse di Azure.

No No Query No
D2CTwinOperations D2CTwinOperations AzureDiagnostics

Log da più risorse di Azure.

No No Query No
DeviceIdentityOperations Operazioni relative alle identità dei dispositivi AzureDiagnostics

Log da più risorse di Azure.

No No Query No
DeviceStreams Flussi dispositivo (anteprima) AzureDiagnostics

Log da più risorse di Azure.

No No Query No
DeviceTelemetry Telemetria dei dispositivi AzureDiagnostics

Log da più risorse di Azure.

No No Query No
DirectMethods Metodi diretti AzureDiagnostics

Log da più risorse di Azure.

No No Query No
DistributedTracing Traccia distribuita (anteprima) No No No
FileUploadOperations Operazioni di caricamento file AzureDiagnostics

Log da più risorse di Azure.

No No Query No
JobsOperations Operazioni dei processi AzureDiagnostics

Log da più risorse di Azure.

No No Query No
Routes Route AzureDiagnostics

Log da più risorse di Azure.

No No Query No
TwinQueries Query dei dispositivi gemelli AzureDiagnostics

Log da più risorse di Azure.

No No Query No

Le sezioni seguenti elencano i tipi di categoria del log delle risorse e gli schemi raccolti per hub IoT di Azure. Gli eventi vengono generati solo per gli errori in alcune categorie.

Categoria di comandi da cloud a dispositivo

La categoria di comandi da cloud a dispositivo tiene traccia degli errori che si verificano nell'hub IoT e sono correlati alla pipeline di messaggi da cloud a dispositivo. Questa categoria include errori che risultano da:

  • Invio di messaggi da cloud a dispositivo (ad esempio, errori di mittente non autorizzato)
  • Ricezione di messaggi da cloud a dispositivo (ad esempio, errori di superamento del numero di recapiti)
  • Ricezione di feedback sui messaggi da cloud a dispositivo (ad esempio, errori di feedback scaduto)

Questa categoria non rileva errori quando il messaggio da cloud a dispositivo viene recapitato correttamente ma gestito in modo non corretto dal 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 di operazioni da cloud a dispositivo gemello

La categoria relativa alle operazioni da cloud a dispositivo gemello tiene traccia degli eventi avviati dal servizio su dispositivi gemelli. Queste operazioni possono includere il recupero del dispositivo gemello, l'aggiornamento o la sostituzione dei tag e l'aggiornamento o la sostituzione delle proprietà desiderate.

{
    "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 di operazioni da dispositivo a cloud gemello

La categoria relativa alle operazioni da dispositivo gemello a cloud tiene traccia degli eventi avviati dal servizio su dispositivi gemelli. Queste operazioni possono includere ottenere i dispositivi gemelli, aggiornare le proprietà segnalate e sottoscrivere le proprietà desiderate.

{
    "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 Configurazioni

hub IoT log di configurazione tiene traccia degli eventi e degli errori per il set di funzionalità Gestione dispositivi automatico.

{
    "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 Connessioni

La categoria Connessioni tiene traccia degli eventi di connessione e disconnessione del dispositivo da un hub IoT, nonché degli errori. Questa categoria è utile per identificare i tentativi di connessione non autorizzati e per inviare avvisi in caso di interruzione della connessione ai dispositivi.

Per informazioni sullo stato di connessione affidabile dei dispositivi, vedere Monitorare lo stato della connessione del 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"
        }
    ]
}

Per informazioni dettagliate sull'uso dei log delle connessioni per monitorare la connettività dei dispositivi, vedere Monitorare, diagnosticare e risolvere i problemi di connettività dei dispositivi a hub IoT di Azure.

Categoria di operazioni di identità del dispositivo

La categoria di operazioni di identità del dispositivo tiene traccia degli errori che si verificano quando si prova a creare, aggiornare o eliminare una voce nel registro delle identità dell'hub IoT. Il rilevamento di questa categoria è utile per gli scenari di provisioning.

{
    "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 Flussi di dispositivo (anteprima)

La categoria device streams tiene traccia delle interazioni di richiesta-risposta inviate ai singoli dispositivi.

{
    "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 di dati di telemetria del dispositivo

La categoria di telemetria dei dispositivi tiene traccia degli errori che si verificano nell'hub IoT e sono correlati alla pipeline di telemetria. Questa categoria include gli errori che si verificano durante l'invio di eventi di telemetria, ad esempio la limitazione, e la ricezione di eventi di telemetria, ad esempio un lettore non autorizzato. Questa categoria non può intercettare gli errori causati dal codice in esecuzione nel dispositivo stesso.

{
    "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 metodi diretti

La categoria relativa ai metodi diretti tiene traccia delle interazioni di richiesta-risposta inviate ai singoli dispositivi. Queste richieste vengono avviate nel cloud.

{
    "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 di traccia distribuita (anteprima)

La categoria relativa alla traccia distribuita tiene traccia degli ID di correlazione per i messaggi che contengono l'intestazione del contesto di traccia. Per abilitare completamente questi log, il codice lato client deve essere aggiornato seguendo Analizza e diagnosticare le applicazioni IoT end-to-end con hub IoT traccia distribuita (anteprima).

correlationId È conforme alla proposta del contesto di traccia W3C, in cui contiene un trace-id oggetto e un oggetto span-id.

Log dell'hub IoT D2C (da dispositivo a cloud)

L'hub IoT registra questo log all'arrivo di un messaggio contenente proprietà di traccia valide nell'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"
        }
    ]
}

In questo caso, durationMs non viene calcolato come l'orologio di hub IoT potrebbe non essere sincronizzato con l'orologio del dispositivo e quindi un calcolo della durata può essere fuorviante. È consigliabile scrivere la logica usando i timestamp nella sezione properties per acquisire i picchi di latenza da dispositivo a cloud.

Proprietà Type Descrizione
messageSize Intero Dimensione del messaggio da dispositivo a cloud in byte
deviceId Stringa di caratteri alfanumerici ASCII a 7 bit Identità del dispositivo
callerLocalTimeUtc Timestamp UTC Ora di creazione del messaggio in base a quanto indicato dall'orologio locale del dispositivo
calleeLocalTimeUtc Timestamp UTC Ora di arrivo del messaggio nel gateway dell'hub IoT in base a quanto indicato dall'orologio sul lato servizio dell'hub IoT

Log di ingresso dell'hub IoT

hub IoT registra questo log quando il messaggio contenente proprietà di traccia valide scrive in Hub eventi interni o predefiniti.

{
    "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"
        }
    ]
}

properties Nella sezione questo log contiene informazioni aggiuntive sull'ingresso dei messaggi.

Proprietà Type Descrizione
isRoutingEnabled String True o false, indica se il routing dei messaggi è abilitato o meno nell'hub IoT
parentSpanId String Oggetto span-id del messaggio padre, che in questo caso sarebbe la traccia del messaggio D2C

Log di uscita dell'hub IoT

L'hub IoT Hub registra questo log quando il routing è abilitato e il messaggio viene scritto in un endpoint. Se il routing non è abilitato, hub IoT non registra questo 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"
        }
    ]
}

properties Nella sezione questo log contiene informazioni aggiuntive sull'ingresso dei messaggi.

Proprietà Type Descrizione
endpointName String Nome dell'endpoint di routing
endpointType String Tipo dell'endpoint di routing
parentSpanId String Oggetto span-id del messaggio padre, che in questo caso sarebbe la traccia del messaggio di ingresso nell'hub IoT

Categoria di operazioni di caricamento file

La categoria di caricamenti dei file tiene traccia degli errori che si verificano nell'hub IoT e correlati alla funzionalità di caricamento dei file. Questa categoria include:

  • Errori che si verificano con l'URI di firma di accesso condiviso, ad esempio quando l'URI scade prima che un dispositivo notifichi all'hub un caricamento completato.
  • Caricamenti non riusciti segnalati dal dispositivo.
  • Errori che si verificano quando un file non viene trovato nell'archiviazione durante la creazione di hub IoT messaggio di notifica.

Questa categoria non riesce a rilevare gli errori che si verificano direttamente mentre il dispositivo carica un file nell'archiviazione.

{
    "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 di operazioni processi

La categoria relativa alle operazioni dei processi segnala le richieste di processo per aggiornare i dispositivi gemelli o richiamare i metodi diretti su più dispositivi. Queste richieste vengono avviate nel cloud.

{
    "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 Route

La categoria di routing dei messaggi tiene traccia degli errori che si verificano durante la valutazione della route dei messaggi e l'integrità degli endpoint percepiti da hub IoT. Questa categoria include eventi di questo tipo:

  • Una regola restituisce "non definito"
  • hub IoT contrassegna un endpoint come non risolto
  • Eventuali errori ricevuti da un endpoint

Questa categoria non include errori specifici sui messaggi stessi (ad esempio errori di limitazione dei dispositivi), che vengono segnalati nella categoria "telemetria del 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"
        }
    ]
}

Di seguito sono riportati altri dettagli sui log delle risorse di routing:

Categoria query gemelle

La categoria relativa alle query dei dispositivi gemelli segnala le richieste di query per i dispositivi gemelli che vengono avviati nel cloud.

{
    "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"
        }
    ]
}

Tabelle di log di Monitoraggio di Azure

Questa sezione elenca tutte le tabelle dei log del Monitoraggio di Azure pertinenti a questo servizio che sono disponibili per la query da parte di Log Analytics mediante le query di Kusto. Le tabelle contengono i dati dei log delle risorse ed eventualmente altro, a seconda di ciò che viene raccolto e indirizzato verso di esse.

hub IoT Microsoft.Devices/IotHubs

Log attività

Nella tabella collegata sono elencate le operazioni che possono essere registrate nel log attività per questo servizio. Queste operazioni sono un sottoinsieme di tutte le possibili operazioni del provider di risorse nel log attività.

Per altre informazioni sullo schema delle voci del log attività, vedere Schema del log attività.