Informazioni di riferimento sul monitoraggio hub IoT di Azure dati

  • Articolo

Per iniziare a usare il monitoraggio di Azure, vedere Monitorare hub IoT di Azure per comprendere come raccogliere e analizzare i dati di monitoraggio per hub IoT di Azure.

Questo articolo è un riferimento per l'implementazione del monitoraggio di Azure.

Le sezioni principali di questo articolo di riferimento:

Metriche

Questa sezione elenca tutte le metriche della piattaforma raccolte automaticamente per hub IoT di Azure. Lo spazio dei nomi del provider di risorse per le metriche di hub IoT è Microsoft.Devices e il tipo Spazio dei nomi è IoTHubs.

Le sottosezioni seguenti mostrano le metriche della piattaforma hub IoT per categoria generale e metriche di elenco in base al nome visualizzato assegnato nella portale di Azure.

È anche possibile trovare una singola tabella che elenca tutte le metriche della piattaforma hub IoT in base al nome della metrica in Microsoft.Devices/IotHubs nella documentazione di Monitoraggio di Azure. Questa tabella non fornisce tutte le informazioni, ad esempio aggregazioni supportate per alcune metriche, disponibili in questo articolo.

Per informazioni sulle metriche supportate da altri servizi di Azure, vedere Metriche supportate con Monitoraggio di Azure.

Argomenti in questa sezione

Selezionare un argomento per passare alle relative informazioni in questa pagina.

Aggregazioni supportate

La colonna Tipo di aggregazione in ogni 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; Tuttavia, per le metriche di conteggio con un valore di colonna Unit di Count, solo alcune aggregazioni sono valide. Le metriche di conteggio possono essere uno dei due tipi:

  • Per le metriche di conteggio a virgola singola, 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 virgola singola sono messaggi di telemetria inviati e recapitazioni di messaggi C2D completate. Per queste metriche, l'unico tipo di aggregazione pertinente è Total (Sum). Il portale consente di scegliere minimo, massimo e medio; tuttavia, questi valori saranno sempre 1.

  • Per le metriche del conteggio 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 che vengono emesse, sommarle sulla granularità specificata non ha senso. Monitoraggio di Azure limita la selezione media, minima e massima per il tipo di aggregazione per queste metriche.

Metriche dei comandi da cloud a dispositivo

Nome visualizzato per la metrica Metrica Unità Tipo di aggregazione Descrizione Dimensioni
Messaggi C2D scaduti C2DMessagesExpired Conteggio Totale Numero di messaggi da cloud a dispositivo scaduti Nessuno
C2D message deliveries completed (Recapiti messaggi C2D completati) c2d.commands.egress.complete.success Conteggio Totale Numero di consegne di messaggi da cloud a dispositivo completate correttamente dal dispositivo Nessuno
C2D messages abandoned (Messaggi C2D abbandonati) c2d.commands.egress.abandon.success Conteggio Totale Numero di messaggi da cloud a dispositivo abbandonati dal dispositivo Nessuno
C2D messages rejected (Messaggi C2D rifiutati) c2d.commands.egress.reject.success Conteggio Totale Numero di messaggi da cloud a dispositivo rifiutati dal dispositivo Nessuno

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 per la metrica Metrica Unità Tipo di aggregazione Descrizione Dimensioni
Chiamate a metodi diretti non riuscite c2d.methods.failure Conteggio Totale Numero di tutte le chiamate a metodi diretti non riuscite. Nessuno
Dimensioni delle richieste di chiamate a metodi diretti c2d.methods.requestSize Byte Media Conteggio di tutte le richieste di metodo diretto riuscite. Nessuno
Dimensioni delle risposte a chiamate a metodi diretti c2d.methods.responseSize Byte Media Conteggio di tutte le risposte al metodo diretto riuscite. Nessuno
Chiamate a metodi diretti riuscite c2d.methods.success Conteggio Totale Numero di tutte le chiamate a metodi diretti riuscite. Nessuno

Per le metriche con un valore unit di aggregazione Conteggio solo totale (somma) è valido. 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 per la metrica Metrica Unità Tipo di aggregazione Descrizione Dimensioni
Letture dei dispositivi gemelli non riuscite per il back-end c2d.twin.read.failure Conteggio Totale Numero di tutte le letture dei dispositivi gemelli avviate dal back-end non riuscite. Nessuno
Aggiornamenti dei dispositivi gemelli non riusciti per il back-end c2d.twin.update.failure Conteggio Totale Numero di tutti gli aggiornamenti dei dispositivi gemelli avviati dal back-end non riusciti. Nessuno
Dimensioni delle risposte di letture dei dispositivi gemelli dal back-end c2d.twin.read.size Byte Media Numero di tutte le letture dei dispositivi gemelli avviate dal back-end completate. Nessuno
Dimensioni degli aggiornamenti dei dispositivi gemelli dal back-end c2d.twin.update.size Byte Media Dimensioni totali di tutti gli aggiornamenti dei dispositivi gemelli avviati dal back-end. Nessuno
Letture dei dispositivi gemelli completate dal back-end c2d.twin.read.success Conteggio Totale Numero di tutte le letture dei dispositivi gemelli avviate dal back-end completate. Nessuno
Aggiornamenti dei dispositivi gemelli completati dal back-end c2d.twin.update.success Conteggio Totale Numero di tutti gli aggiornamenti dei dispositivi gemelli avviati dal back-end completati. Nessuno

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

Metriche delle configurazioni

Nome visualizzato per la metrica Metrica Unità Tipo di aggregazione Descrizione Dimensioni
Metriche di configurazione configurazioni Conteggio Totale Numero di operazioni CRUD totali eseguite per la configurazione del dispositivo e la distribuzione 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. Nessuno

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

Metriche delle quote giornaliere

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

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 per la metrica Metrica Unità Tipo di aggregazione Descrizione Dimensioni
Dispositivi totali (deprecati) devices.totalDevices Conteggio Totale Il numero di dispositivi registrati nell'hub IoT Nessuno
Dispositivi connessi (deprecati) devices.connectedDevices.allProtocol Conteggio Totale Il numero di dispositivi connessi all'hub IoT Nessuno
Totale dispositivi totalDeviceCount Conteggio Media Il numero di dispositivi registrati nell'hub IoT Nessuno
Dispositivi connessi connectedDeviceCount Conteggio Media Il numero di dispositivi connessi all'hub IoT Nessuno

Per Totale dispositivi (deprecati) e Dispositivi connessi (deprecati), è valida solo l'aggregazione totale (somma). 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 per la metrica Metrica Unità Tipo di aggregazione Descrizione Dimensioni
Number of throttling errors (Numero di errori di limitazione) d2c.telemetry.ingress.sendThrottle Conteggio Totale Numero di errori di limitazione dovuti alle limitazioni della velocità effettiva del dispositivo Nessuno
Tentativi di telemetria 'message send' d2c.telemetry.ingress.allProtocol Conteggio Totale Il numero di messaggi di telemetria da dispositivo a cloud che si è cercato di inviare all'hub IoT Nessuno
Messaggi di telemetria inviati d2c.telemetry.ingress.success Conteggio Totale Il numero di messaggi di telemetria da dispositivo a cloud inviati all'hub IoT Nessuno

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

Metriche delle operazioni da dispositivo a cloud twin

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

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 griglia di eventi

Nome visualizzato per la metrica Metrica Unità Tipo di aggregazione Descrizione Dimensioni
Consegne di Griglia di eventi EventGridDeliveries Conteggio Totale 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). Risultato:
EventType
Per altre informazioni, vedere Dimensioni delle metriche.
Latenza griglia di eventi EventGridLatency Millisecondi Media 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. EventType
Per altre informazioni, vedere Dimensioni delle metriche.

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 per la metrica Metrica Unità Tipo di aggregazione Descrizione Dimensioni
Processi completati jobs.completed Conteggio Totale Numero di tutti i processi completati. Nessuno
Chiamate per elencare i processi non riuscite jobs.listJobs.failure Conteggio Totale Numero di tutte le chiamate per elencare i processi non riuscite. Nessuno
Creazioni di processi di chiamata al metodo non riuscite jobs.createDirectMethodJob.failure Conteggio Totale Numero di tutte le creazioni di processi di chiamata a metodi diretti non riuscite. Nessuno
Creazioni di processi di aggiornamento dei dispositivi gemelli non riuscite jobs.createTwinUpdateJob.failure Conteggio Totale Numero di tutte le creazioni di processi di aggiornamento dei dispositivi gemelli non riuscite. Nessuno
Annullamenti di processi non riusciti jobs.cancelJob.failure Conteggio Totale Numero di tutte le chiamate per annullare i processi non riuscite. Nessuno
Query sui processi non riuscite jobs.queryJobs.failure Conteggio Totale Numero di tutte le chiamate per eseguire query sui processi non riuscite. Nessuno
Processi non riusciti jobs.failed Conteggio Totale Numero di tutti i processi non riusciti. Nessuno
Chiamate per elencare i processi riuscite jobs.listJobs.success Conteggio Totale Numero di tutte le chiamate per elencare i processi riuscite. Nessuno
Creazioni di processi di chiamata al metodo completate jobs.createDirectMethodJob.success Conteggio Totale Numero di tutte le creazioni di processi di chiamata a metodi diretti completate. Nessuno
Creazioni di processi di aggiornamento dei dispositivi gemelli completate jobs.createTwinUpdateJob.
esito positivo		 Conteggio Totale Numero di tutte le creazioni di processi di aggiornamento dei dispositivi gemelli completate. Nessuno
Annullamenti di processi riusciti jobs.cancelJob.success Conteggio Totale Numero di tutte le chiamate per annullare i processi riuscite. Nessuno
Query sui processi riuscite jobs.queryJobs.success Conteggio Totale Numero di tutte le chiamate per eseguire query sui processi riuscite. Nessuno

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 per la metrica Metrica Unità Tipo di aggregazione Descrizione Dimensioni
Distribuzione di routing (anteprima) RoutingDeliveries Conteggio Totale Metrica di distribuzione del routing. Usare le dimensioni per identificare lo stato di recapito per un endpoint specifico o per un'origine di routing specifica. Risultato:
RoutingSource,
EndpointType,
FailureReasonCategory,
EndpointName
Per altre informazioni, vedere Dimensioni delle metriche.
Dimensioni dei messaggi di recapito del routing in byte (anteprima) RoutingDataSizeInBytesDelivered Byte Totale 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. RoutingSource,
EndpointType
EndpointName
Per altre informazioni, vedere Dimensioni delle metriche.
Latenza recapito routing (anteprima) RoutingDeliveryLatency Millisecondi Media Metrica di latenza del recapito di routing. Usare le dimensioni per identificare la latenza per un endpoint specifico o per un'origine di routing specifica. RoutingSource,
EndpointType,
EndpointName
Per altre informazioni, vedere Dimensioni delle metriche.
Routing: BLOB recapitati all'archiviazione d2c.endpoints.egress.storage.blobs Conteggio Totale Numero di volte in cui routing dell'hub IoT ha recapitato BLOB agli endpoint di archiviazione. Nessuno
Routing: dati recapitati all'archiviazione d2c.endpoints.egress.storage.bytes Byte Totale Quantità di dati (byte) che il routing dell'hub IoT ha recapitato agli endpoint di archiviazione. Nessuno
Routing: latenza dei messaggi per Hub eventi d2c.endpoints.latency.eventHubs Millisecondi Media Latenza media (millisecondi) tra i messaggi in ingresso a hub IoT e i messaggi in ingresso in endpoint personalizzati di tipo Hub eventi. Le route dei messaggi all'endpoint predefinito (eventi) non sono incluse. Nessuno
Routing: latenza dei messaggi per la coda del bus di servizio d2c.endpoints.latency.serviceBusQueues Millisecondi Media Latenza media (millisecondi) tra i messaggi in ingresso a hub IoT e l'ingresso dei messaggi in un endpoint della coda del bus di servizio. Nessuno
Routing: latenza dei messaggi per l'argomento del bus di servizio d2c.endpoints.latency.serviceBusTopics Millisecondi Media Latenza media (millisecondi) tra i messaggi in ingresso a hub IoT e l'ingresso dei messaggi in un endpoint dell'argomento del bus di servizio. Nessuno
Routing: latenza dei messaggi per messaggi/eventi d2c.endpoints.latency.builtIn.events Millisecondi Media Latenza media (millisecondi) tra i messaggi in ingresso a hub IoT e i messaggi in ingresso nell'endpoint predefinito (messaggi/eventi) e nella route di fallback. Nessuno
Routing: latenza dei messaggi per l'archiviazione d2c.endpoints.latency.storage Millisecondi Media Latenza media (millisecondi) tra i messaggi in ingresso a hub IoT e l'ingresso dei messaggi in un endpoint di archiviazione. Nessuno
Routing: messaggi recapitati a Hub eventi d2c.endpoints.egress.eventHubs Conteggio Totale 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. Nessuno
Routing: messaggi recapitati alla coda del bus di servizio d2c.endpoints.egress.serviceBusQueues Conteggio Totale Numero di volte in cui il routing dell'hub IoT ha recapitato i messaggi agli endpoint della coda del bus di servizio. Nessuno
Routing: messaggi recapitati all'argomento del bus di servizio d2c.endpoints.egress.serviceBusTopics Conteggio Totale Numero di volte in cui il routing dell'hub IoT ha recapitato i messaggi agli endpoint dell'argomento del bus di servizio. Nessuno
Routing: messaggi recapitati al fallback d2c.telemetry.egress.fallback Conteggio Totale Numero di volte in cui il routing dell'hub IoT ha recapitato i messaggi all'endpoint associato con la route di fallback. Nessuno
Routing: messaggi recapitati a messaggi/eventi d2c.endpoints.egress.builtIn.events Conteggio Totale Numero di volte in cui hub IoT il routing ha recapitato correttamente i messaggi all'endpoint predefinito (messaggi/eventi) e alla route di fallback. Nessuno
Routing: messaggi recapitati all'archiviazione d2c.endpoints.egress.storage Conteggio Totale Numero di volte in cui il routing dell'hub IoT ha recapitato i messaggi agli endpoint di archiviazione. Nessuno
Routing: messaggi di telemetria recapitati d2c.telemetry.egress.success Conteggio Totale 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. Nessuno
Routing: messaggi di telemetria eliminati d2c.telemetry.egress.dropped Conteggio Totale Numero di volte in cui i messaggi sono stati eliminati dal routing dell'hub IoT a causa degli endpoint inattivi. Questo valore non conta i messaggi recapitati alla route di fallback perché i messaggi eliminati non vengono recapitati. Nessuno
Routing: messaggi di telemetria incompatibili d2c.telemetry.egress.invalid Conteggio Totale 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 temporaneo. I messaggi non validi non vengono riprovati. Questo valore non include tentativi. Nessuno
Routing: messaggi di telemetria orfani d2c.telemetry.egress.orphaned Conteggio Totale Numero di volte in cui i messaggi sono orfani hub IoT routing perché non corrispondono a alcuna query di routing, quando la route di fallback è disabilitata. Nessuno

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 per la metrica Metrica Unità Tipo di aggregazione Descrizione Dimensioni
Query dei dispositivi gemelli non riuscite twinQueries.failure Conteggio Totale Numero di tutte le query dei dispositivi gemelli non riuscite. Nessuno
Query dei dispositivi gemelli completate twinQueries.success Conteggio Totale Numero di tutte le query dei dispositivi gemelli completate. Nessuno
Dimensioni dei risultati delle query dei dispositivi gemelli twinQueries.resultSize Byte Media Totale delle dimensioni dei risultati di tutte le query gemelle riuscite. Nessuno

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

Dimensioni delle metriche

hub IoT di Azure ha le dimensioni seguenti associate ad alcune delle metriche di routing e Griglia di eventi.

Nome della 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 seguenti: non valido, eliminato, orfano o Null.
Risultato Esito positivo o negativo
RoutingSource Messaggi del dispositivo
Eventi di modifica dei dispositivi gemelli
Eventi relativi al ciclo di vita dei dispositivi

Per altre informazioni sulle dimensioni delle metriche, vedere Metriche multidimensionali.

Log risorse

Questa sezione elenca tutti i tipi di categoria e gli schemi dei log delle risorse raccolti per hub IoT di Azure. Il provider di risorse e il tipo per tutti i log di hub IoT sono Microsoft.Devices/IotHubs. Gli eventi vengono generati solo per gli errori in alcune categorie.

Argomenti in questa sezione

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 uno 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.

Telemetria dei dispositivi

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ò rilevare 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"
        }
    ]
}

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

Operazioni relative alle identità dei dispositivi

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

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 nella risorsa di archiviazione durante la creazione di hub IoT messaggio di notifica.

Questa categoria non può rilevare gli errori che si verificano direttamente durante il caricamento di un file nella risorsa di 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"
        }
    ]
}

Route

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

  • Una regola viene valutata come "non definita"
  • Hub IoT contrassegna un endpoint come inattivo
  • Qualsiasi errore ricevuto 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/91R34780-3DEC-123A-BE2A-213B5500DFF0/RESOURCEGROUPS/ANON-TEST/PROVIDERS/MICROSOFT.DEVICES/IOTHUBS/ANONHUB1",
            "operationName":"endpointUnhealthy",
            "category":"Routes",
            "level":"Error",
            "resultType":"403004",
            "resultDescription":"DeviceMaximumQueueDepthExceeded",
            "properties":"{\"deviceId\":null,\"endpointName\":\"anon-sb-1\",\"messageId\":null,\"details\":\"DeviceMaximumQueueDepthExceeded\",\"routeName\":null,\"statusCode\":\"403\"}",
            "location":"westus"
        }
    ]
}

Ecco altri dettagli sul routing dei log delle risorse:

Operazioni da dispositivo gemello a cloud

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

Operazioni da cloud a dispositivi gemelli

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

Query dei dispositivi gemelli

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

Operazioni dei 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"
        }
    ]
}

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

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, è necessario aggiornare il codice lato client seguendo Analizza e diagnosticare le applicazioni IoT end-to-end con hub IoT traccia distribuita (anteprima).

È correlationId conforme alla proposta di 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 Integer 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

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

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

Tabelle dei log di Monitoraggio di Azure

Questa sezione si riferisce a tutte le tabelle Kusto dei log di Monitoraggio di Azure rilevanti per hub IoT di Azure e disponibili per le query da Parte di Log Analytics. Per un elenco di queste tabelle e collegamenti a altre informazioni sul tipo di risorsa hub IoT, vedere hub IoT nella tabella dei log di Monitoraggio di Azure.

Per informazioni di riferimento su tutti i log di Monitoraggio di Azure o le tabelle di Log Analytics, vedere Informazioni di riferimento sulla tabella dei log di Monitoraggio di Azure.

Vedere anche