Partager via


Informations de référence sur les données de surveillance Azure IoT Hub

Cet article contient toutes les informations de référence de surveillance pour ce service.

Consultez Surveiller Azure IoT pour plus d’informations sur les données que vous pouvez collecter pour IoT Hub et comment l’utiliser.

Métriques

Cette section répertorie toutes les métriques de plateforme collectées automatiquement pour App Service. Ces métriques font également partie de la liste globale de toutes les métriques de plateforme prises en charge dans Azure Monitor.

Pour plus d’informations sur les métriques de surveillance, consultez la section Présentation des métriques Azure Monitor.

Métriques prises en charge pour Microsoft.Devices/IoTHubs

Le tableau suivant répertorie les métriques disponibles pour le type de ressource Microsoft.Devices/IoTHubs.

  • Toutes les colonnes peuvent ne pas être présentes dans chaque table.
  • Certaines colonnes peuvent dépasser la zone d’affichage de la page. Sélectionnez Développer la table pour afficher toutes les colonnes disponibles.

Titres du tableau

  • Catégorie : le groupe de métriques ou classification.
  • Métrique : nom complet de la métrique tel qu’il apparaît dans le portail Azure.
  • Nom dans l’API REST : le nom de la métrique comme appelé dans l’API REST.
  • Unité : unité de mesure.
  • Agrégation : le type d’agrégation par défaut. Valeurs valides : Moyen (moy), Minimum (min), Maximum (max), Total (somme), Nombre.
  • Dimensions - Dimensions disponibles pour la métrique.
  • Fragments de temps - Intervalles auxquels la métrique est échantillonnée. Par exemple, PT1M indique que la métrique est échantillonnée toutes les minutes, PT30M toutes les 30 minutes, PT1H toutes les heures, et ainsi de suite.
  • Exportation DS : indique si la métrique est exportable vers les journaux Azure Monitor via les paramètres de diagnostic. Pour plus d’informations sur l’exportation des métriques, consultez Créer des paramètres de diagnostic dans Azure Monitor.
Mesure Nom dans l’API REST Unité Agrégation Dimensions Fragments de temps Exportation DS
Messages C2D abandonnés

Nombre de messages cloud vers appareil abandonnés par l’appareil
c2d.commands.egress.abandon.success Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Remises de messages C2D terminées

Nombre de remises de messages cloud vers appareil terminées avec succès par l’appareil
c2d.commands.egress.complete.success Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Messages C2D rejetés

Nombre de messages cloud vers appareil rejetés par l’appareil
c2d.commands.egress.reject.success Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Échec des appels de méthode directe

Total des appels de méthode directe en échec.
c2d.methods.failure Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Taille de requête des appels de méthode directe

Moyenne, minimum et maximum de toutes les demandes de méthode directe réussies.
c2d.methods.requestSize Octets Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Taille de réponse des appels de méthode directe

Moyenne, minimum et maximum de toutes les réponses de méthode directe réussies.
c2d.methods.responseSize Octets Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Appels de méthode directe réussies

Total des appels de méthode directe réussis.
c2d.methods.success Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Échec des lectures de jumeaux à partir du serveur principal

Total des lectures de représentations en échec initiées par un serveur principal.
c2d.twin.read.failure Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Taille de réponse des lectures de jumeaux à partir du serveur principal

Moyenne, minimum et maximum de toutes les lectures de représentations réussies initiées par un serveur principal.
c2d.twin.read.size Octets Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Lectures de jumeaux réussies à partir du serveur principal

Total des lectures de représentations réussies initiées par un serveur principal.
c2d.twin.read.success Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Échec des mises à jour des jumeaux à partir du serveur principal

Total des mises à jour de représentations en échec initiées par un serveur principal.
c2d.twin.update.failure Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Taille des mises à jour de jumeau à partir du serveur principal

Taille moyenne, minimale et maximale de toutes les mises à jour de représentations réussies initiées par un serveur principal.
c2d.twin.update.size Octets Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Mises à jour de jumeau réussies à partir du serveur principal

Total des mises à jour de représentations réussies initiées par un serveur principal.
c2d.twin.update.success Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Messages C2D expirés

Nombre de messages cloud vers appareil ayant expiré
C2DMessagesExpired Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Métriques de configuration

Métriques pour les opérations de configuration
configurations Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Appareils connectés

Nombre d’appareils connectés à votre hub IoT
connectedDeviceCount Count Moyenne, Maximum, Minimum <aucune> PT1M Non
Routage : messages remis aux messages/événements

Nombre de fois où le routage IoT Hub a correctement remis des messages au point de terminaison intégré (messages/événements).
d2c.endpoints.egress.builtIn.events Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Routage : messages remis à Event Hub

Nombre de fois où le routage IoT Hub a correctement remis des messages à des points de terminaison Event Hub.
d2c.endpoints.egress.eventHubs Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Routage : messages remis à la file d’attente Service Bus

Nombre de fois où le routage IoT Hub a correctement remis des messages aux points de terminaison de file d’attente Service Bus.
d2c.endpoints.egress.serviceBusQueues Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Routage : messages remis à la rubrique Service Bus

Nombre de fois où le routage IoT Hub a correctement remis des messages à des points de terminaison de rubrique Service Bus.
d2c.endpoints.egress.serviceBusTopics Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Routage : messages remis au stockage

Nombre de fois où le routage IoT Hub a correctement remis des messages à des points de terminaison de stockage.
d2c.endpoints.egress.storage Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Routage : objets blob remis au stockage

Nombre de fois où le routage IoT Hub a remis des objets blob à des points de terminaison de stockage.
d2c.endpoints.egress.storage.blobs Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Routage : données remises au stockage

Quantité de données (octets) que le routage IoT Hub a remis aux points de terminaison de stockage.
d2c.endpoints.egress.storage.bytes Octets Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Routage : latence des messages/événements

Latence moyenne (en millisecondes) entre les entrées de messages vers IoT Hub et de télémétrie dans le point de terminaison intégré (messages/événements).
d2c.endpoints.latency.builtIn.events Millisecondes Moyenne, Minimum, Maximum <aucune> PT1M Oui
Routage : latence des messages pour Event Hub

Latence moyenne (en millisecondes) entre les entrées de messages vers IoT Hub et dans un point de terminaison Event Hub.
d2c.endpoints.latency.eventHubs Millisecondes Moyenne, Minimum, Maximum <aucune> PT1M Oui
Routage : latence des messages pour la file d’attente Service Bus

Latence moyenne (en millisecondes) entre les entrées de messages vers IoT Hub et de télémétrie dans un point de terminaison de file d’attente Service Bus.
d2c.endpoints.latency.serviceBusQueues Millisecondes Moyenne, Minimum, Maximum <aucune> PT1M Oui
Routage : latence des messages pour la rubrique Service Bus

Latence moyenne (en millisecondes) entre les entrées de messages vers IoT Hub et de télémétrie dans un point de terminaison de rubrique Service Bus.
d2c.endpoints.latency.serviceBusTopics Millisecondes Moyenne, Minimum, Maximum <aucune> PT1M Oui
Routage : latence des messages pour le stockage

Latence moyenne (en millisecondes) entre les entrées de messages vers IoT Hub et de télémétrie dans un point de terminaison de stockage.
d2c.endpoints.latency.storage Millisecondes Moyenne, Minimum, Maximum <aucune> PT1M Oui
Routage : messages de télémétrie supprimés

Nombre de fois où des messages ont été annulés par le routage IoT Hub en raison de points de terminaison morts. Cette valeur ne compte pas les messages remis à un itinéraire de secours, car les messages annulés n’y sont pas remis.
d2c.telemetry.egress.dropped Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Routage : messages remis à la secours

Nombre de fois où le routage IoT Hub a remis des messages au point de terminaison associé à l’itinéraire de secours.
d2c.telemetry.egress.fallback Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Routage : les messages de télémétrie incompatibles

Nombre de fois où le routage IoT Hub n’a pas réussi à remettre des messages en raison d’une incompatibilité avec le point de terminaison. Cette valeur n’inclut pas les nouvelles tentatives.
d2c.telemetry.egress.invalid Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Routage : messages de télémétrie orphelins

Nombre de fois où des messages ont été définis comme orphelins par le routage IoT Hub car ils ne correspondaient à aucune règle de routage (y compris la règle de secours).
d2c.telemetry.egress.orphaned Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Routage : messages de télémétrie remis

Nombre de fois où des messages ont été correctement remis à tous les points de terminaison à l’aide du routage IoT Hub. Si un message est routé vers plusieurs points de terminaison, cette valeur augmente d’une unité pour chaque remise réussie. Si un message est routé plusieurs fois vers le même point de terminaison, cette valeur augmente d’une unité pour chaque remise réussie.
d2c.telemetry.egress.success Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Tentatives d’envoi de messages de télémétrie

Nombre de tentatives d’envoi de messages de télémétrie appareil vers cloud à votre hub IoT
d2c.telemetry.ingress.allProtocol Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Nombre d’erreurs de limitation

Nombre d’erreurs de limitation causées par des limitations de débit d’appareil
d2c.telemetry.ingress.sendThrottle Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Messages de télémétrie envoyés

Nombre de messages de télémétrie appareil vers cloud envoyés avec succès à votre hub IoT
d2c.telemetry.ingress.success Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Échec des lectures de jumeaux à partir d’appareils

Total des lectures de représentations en échec initiées par un appareil.
d2c.twin.read.failure Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Taille de réponse des lectures de jumeaux à partir d’appareils

Moyenne, minimum et maximum de toutes les lectures de représentations réussies initiées par un appareil.
d2c.twin.read.size Octets Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Lectures de jumeaux réussies à partir d’appareils

Total des lectures de représentations réussies initiées par un appareil.
d2c.twin.read.success Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Échec des mises à jour de jumeau à partir d’appareils

Total des mises à jour de représentations en échec initiées par un appareil.
d2c.twin.update.failure Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Taille des mises à jour de jumeau à partir d’appareils

Taille moyenne, minimale et maximale de toutes les mises à jour de représentations réussies initiées par un appareil.
d2c.twin.update.size Octets Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Mises à jour de jumeau réussies à partir d’appareils

Total des mises à jour de représentations réussies initiées par un appareil.
d2c.twin.update.success Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Nombre total de messages utilisés

Nombre total de messages utilisés aujourd'hui
dailyMessageQuotaUsed Count Moyenne, Minimum, Maximum <aucune> PT1M Oui
Utilisation totale des données d’appareil

Nombre d’octets transférés vers et depuis tous les appareils connectés à IotHub
deviceDataUsage Octets Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Utilisation totale des données d’appareil (préversion)

Nombre d’octets transférés vers et depuis tous les appareils connectés à IotHub
deviceDataUsageV2 Octets Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Appareils connectés (déconseillés)

Nombre d’appareils connectés à votre hub IoT
devices.connectedDevices.allProtocol Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Nombre total d’appareils (déconseillés)

Nombre d’appareils enregistrés sur votre hub IoT
devices.totalDevices Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Livraisons Event Grid

Nombre d’événements IoT Hub publiés dans Event Grid. Utilisez la dimension Résultat pour le nombre de requêtes ayant réussi et ayant échoué. La dimension EventType représente le type de l’événement (https://aka.ms/ioteventgrid).
EventGridDeliveries Count Moyenne, Minimum, Maximum, Total (Somme) Result, EventType PT1M Oui
Latence Event Grid

Latence moyenne (en millisecondes) entre le moment où l’événement Iot Hub a été généré et le moment où l’événement a été publié dans Event Grid. Ce nombre est une moyenne de tous les types d’événement. Utilisez la dimension Type d’événement pour afficher la latence d’un type d’événement spécifique.
EventGridLatency Millisecondes Moyenne, Minimum, Maximum EventType PT1M Oui
Annulations de travaux ayant échoué

Total des appels en échec pour annuler un travail.
jobs.cancelJob.failure Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Annulations de travaux réussies

Total des appels réussis pour annuler un travail.
jobs.cancelJob.success Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Travaux terminés

Total des travaux terminés.
jobs.completed Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Échec des créations de travaux d’appel de méthode

Total des créations en échec des travaux d’appel de méthode directe.
jobs.createDirectMethodJob.failure Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Créations réussies de travaux d’appel de méthode

Total des créations réussies des travaux d’appel de méthode directe.
jobs.createDirectMethodJob.success Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Échec des créations de travaux de mise à jour de jumeau

Total des créations en échec des travaux de mises à jour de représentations.
jobs.createTwinUpdateJob.failure Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Créations réussies de travaux de mise à jour de jumeau

Total des créations réussies de travaux de mises à jour de représentations.
jobs.createTwinUpdateJob.success Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Travaux non réussis

Total des travaux en échec.
jobs.failed Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Échec des appels à la liste des travaux

Total des appels en échec pour répertorier les travaux.
jobs.listJobs.failure Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Appels réussis pour répertorier les travaux

Total des appels réussis pour répertorier les travaux.
jobs.listJobs.success Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Requêtes de travail ayant échoué

Total des appels en échec pour interroger les travaux.
jobs.queryJobs.failure Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Requêtes de travail réussies

Total des appels réussis pour interroger les travaux.
jobs.queryJobs.success Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Taille du message de remise de routage en octets (préversion)

Taille totale, en octets, des messages remis par IoT Hub à un point de terminaison. Vous pouvez utiliser les dimensions EndpointName et EndpointType pour afficher la taille, en octets, des messages remis à vos différents points de terminaison. La valeur de la métrique augmente à chaque message remis, y compris à plusieurs points de terminaison ou plusieurs fois au même point de terminaison.
RoutingDataSizeInBytesDelivered Octets Moyenne, Minimum, Maximum, Total (Somme) EndpointType, , EndpointNameRoutingSource PT1M Oui
Livraisons de routage (préversion)

Nombre de fois où IoT Hub a tenté de remettre des messages à tous les points de terminaison à l’aide du routage. Pour afficher le nombre de tentatives ayant abouti ou échoué, utilisez la dimension Résultat. Pour voir la raison de l’échec, comme non valide, supprimé ou orphelin, utilisez la dimension FailureReasonCategory. Vous pouvez également utiliser les dimensions EndpointName et EndpointType pour connaître le nombre de messages remis à vos différents points de terminaison. La valeur de métrique augmente d’une unité à chaque tentative de remise, notamment si le message est remis à plusieurs points de terminaison ou plusieurs fois au même point de terminaison.
RoutingDeliveries Count Moyenne, Minimum, Maximum, Total (Somme) EndpointType, , EndpointNameFailureReasonCategory, , ResultRoutingSource PT1M Oui
Latence de remise de routage (préversion)

Latence moyenne (en millisecondes) entre les entrées de messages vers IoT Hub et de télémétrie dans un point de terminaison. Vous pouvez utiliser les dimensions EndpointName et EndpointType pour connaître la latence à vos différents points de terminaison.
RoutingDeliveryLatency Millisecondes Moyenne, Minimum, Maximum EndpointType, , EndpointNameRoutingSource PT1M Oui
Nombre total d’appareils

Nombre d’appareils enregistrés sur votre hub IoT
totalDeviceCount Count Moyenne, Maximum, Minimum <aucune> PT1M Non
Requêtes de jumeau ayant échoué

Total des requêtes de représentations en échec.
twinQueries.failure Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Taille du résultat des requêtes de jumeaux

Moyenne, minimum et maximum de la taille du résultat de toutes les requêtes de représentations réussies.
twinQueries.resultSize Octets Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui
Requêtes de jumeau réussies

Total des requêtes de représentations réussies.
twinQueries.success Count Moyenne, Minimum, Maximum, Total (Somme) <aucune> PT1M Oui

Agrégations prises en charge

La colonne Type d’agrégation dans la table correspond à l’agrégation par défaut utilisée lorsque la métrique est sélectionnée pour un graphique ou une alerte.

Capture d’écran montrant l’agrégation pour les métriques.

Pour la plupart des métriques, tous les types d’agrégation sont valides. Pour les métriques de nombre avec une valeur de colonne d’unité de Count, seules certaines agrégations sont valides. Les métriques de comptage peuvent être de deux types :

  • Pour les métriques de comptage à point unique, IoT Hub enregistre un point de données unique (essentiellement 1) chaque fois que l’opération mesurée se produit. Azure Monitor additionne ensuite ces points de données sur la granularité spécifiée. Messages de télémétrie envoyés et Remises de messages cloud vers appareil terminées sont des exemples de métriques à point unique. Pour ces métriques, le seul type d’agrégation pertinent est Total (Somme). Le portail vous permet de choisir le minimum, le maximum et la moyenne. Ces valeurs sont toujours 1.

  • Pour les métriques de comptage d’instantanés, IoT Hub enregistre un nombre total lorsque l’opération mesurée se produit. Actuellement, il existe trois métriques d’instantanés émises par IoT Hub : Nombre total de messages utilisés, Nombre total d’appareils et Appareils connectés. Étant donné que ces métriques présentent une quantité « totale » chaque fois, leur additionnement sur la granularité spécifiée n’a aucun sens. Azure Monitor vous limite à sélectionner la moyenne, la valeur minimale et la valeur maximale pour le type d’agrégation de ces métriques.

Dimensions de métrique

Pour plus d’informations sur les dimensions de métrique, consultez Métriques multidimensionnelles.

Ce service a les dimensions suivantes associées à ses métriques.

Nom de la dimension Description
EndpointName Nom du point de terminaison
EndpointType eventHubs, serviceBusQueues, cosmosDB, serviceBusTopics, builtin ou blobStorage
Type d’événement Microsoft.Devices.DeviceCreated, Microsoft.Devices.DeviceDeleted, Microsoft.Devices.DeviceConnected, Microsoft.Devices.DeviceDisconnected ouMicrosoft.Devices.DeviceTelemetry
Pour plus d’informations, consultez Types d’événements.
FailureReasonCategory Une des valeurs suivantes : invalid, , droppedorphaned, ou null.
Résultat success ou failure
RoutingSource Device Messages, , Twin Change EventsDevice Lifecycle Events

Nom complet et agrégation des métriques

Les tableaux suivants fournissent plus d’informations sur les métriques décrites dans le tableau précédent. Ils affichent les métriques de la plateforme IoT Hub par catégorie générale et répertorient les métriques par leur nom complet comme attribué dans le Portail Azure.

Métriques de commande cloud à appareil :

Nom d’affichage de la métrique Métrique Unité Description
Messages cloud vers appareil ayant expiré C2DMessagesExpired Count Nombre de messages cloud vers appareil ayant expiré
Remises de messages cloud vers appareil terminées c2d.commands.egress.complete.success Count Nombre de remises de messages cloud vers appareil terminées avec succès par l’appareil
Messages cloud vers appareil abandonnés c2d.commands.egress.abandon.success Count Nombre de messages cloud vers appareil abandonnés par l’appareil
Messages cloud vers appareil rejetés c2d.commands.egress.reject.success Count Nombre de messages cloud vers appareil rejetés par l’appareil

Pour les métriques dont la valeur d’unité est Comptage, seule l’agrégation totale (somme) est valide. Les agrégations Minimum, Maximum et Moyenne retournent toujours la valeur 1. Pour en savoir plus, consultez les agrégations prises en charge.

Métriques de méthodes directes cloud vers appareil :

Nom d’affichage de la métrique Métrique Unité Description
Appels de méthode directe en échec c2d.methods.failure Count Total des appels de méthode directe en échec.
Taille de demande des appels de méthode directe c2d.methods.requestSize Octets Total des requêtes de méthode directe réussies.
Taille de réponse des appels de méthode directe c2d.methods.responseSize Octets Total des réponses de méthode directe réussies.
Appels de méthode directe réussis c2d.methods.success Count Total des appels de méthode directe réussis.

Pour les métriques dont la valeur d’unité est Comptage, seule l’agrégation totale (somme) est valide. Les agrégations Minimum, Maximum et Moyenne retournent toujours la valeur 1. Pour en savoir plus, consultez les agrégations prises en charge.

Métriques des opérations de jumeau cloud vers appareil :

Nom d’affichage de la métrique Métrique Unité Description
Lectures de représentations de serveur principal en échec c2d.twin.read.failure Count Total des lectures de représentations en échec initiées par un serveur principal.
Mises à jour de représentations de serveur principal en échec c2d.twin.update.failure Count Total des mises à jour de représentations en échec initiées par un serveur principal.
Taille de la réponse des lectures de représentations de serveur principal c2d.twin.read.size Octets Total des lectures de représentations réussies initiées par un serveur principal.
Taille des mises à jour de représentations de serveur principal c2d.twin.update.size Octets Total des mises à jour de représentations réussies initiées par un serveur principal.
Lectures de représentations réussies de serveur principal c2d.twin.read.success Count Total des lectures de représentations réussies initiées par un serveur principal.
Mises à jour de représentations réussies de serveur principal c2d.twin.update.success Count Total des mises à jour de représentations réussies initiées par un serveur principal.

Pour les métriques dont la valeur d’unité est Comptage, seule l’agrégation totale (somme) est valide. Les agrégations Minimum, Maximum et Moyenne retournent toujours la valeur 1. Pour en savoir plus, consultez les agrégations prises en charge.

Métriques de configurations :

Nom d’affichage de la métrique Métrique Unité Description
Métriques de configuration configurations Count Nombre total d’opérations CRUD effectuées pour la configuration de l’appareil et le déploiement d’IoT Edge sur un ensemble d’appareils cibles. Cela inclut également le nombre d’opérations qui modifient le jumeau d’appareil ou le jumeau de module en raison de ces configurations.

Pour les métriques dont la valeur d’unité est Comptage, seule l’agrégation totale (somme) est valide. Les agrégations Minimum, Maximum et Moyenne retournent toujours la valeur 1. Pour en savoir plus, consultez les agrégations prises en charge.

Métriques de quota quotidiennes :

Nom d’affichage de la métrique Métrique Unité Description
Utilisation totale des données d’appareil deviceDataUsage Octets Nombre d’octets transférés vers et depuis tous les appareils connectés à IotHub
Utilisation totale des données d’appareil (préversion) deviceDataUsageV2 Total Nombre d’octets transférés vers et depuis tous les appareils connectés à IotHub
Nombre total de messages utilisés dailyMessageQuotaUsed Count Nombre total de messages utilisés aujourd’hui. Une valeur cumulative qui est réinitialisée sur zéro à 00h00 UTC chaque jour.

Pour Nombre total de messages utilisés, seules les agrégations Minimum, Maximum et Moyenne sont prises en charge. Pour en savoir plus, consultez les agrégations prises en charge.

Métriques d’appareil :

Nom d’affichage de la métrique Métrique Unité Description
Nombre total d’appareils (déconseillé) devices.totalDevices Count Nombre d’appareils enregistrés sur votre hub IoT
Appareils connectés (déconseillé) devices.connectedDevices.allProtocol Count Nombre d’appareils connectés à votre hub IoT
Nombre total d’appareils totalDeviceCount Count Nombre d’appareils enregistrés sur votre hub IoT
Appareils connectés connectedDeviceCount Count Nombre d’appareils connectés à votre hub IoT

Pour Nombre total d’appareils (déconseillé) et Appareils connectés (déconseillé) , seule l’agrégation Total (Somme) est valide. Les agrégations Minimum, Maximum et Moyenne retournent toujours la valeur 1. Pour en savoir plus, consultez les agrégations prises en charge.

Pour Nombre total d’appareils et Appareils connectés, seules les agrégations Minimum, Maximum et Moyenne sont valides. Pour en savoir plus, consultez les agrégations prises en charge.

Nombre total d’appareils et Appareils connectés ne sont pas exportables via les paramètres de diagnostic.

Métriques de télémétrie des appareils :

Nom d’affichage de la métrique Métrique Unité Description
Nombre d’erreurs de limitation d2c.telemetry.ingress.sendThrottle Count Nombre d’erreurs de limitation causées par des limitations de débit d’appareil
Tentatives d’« envoi de message » de télémétrie d2c.telemetry.ingress.allProtocol Count Nombre de tentatives d’envoi de messages de télémétrie appareil vers cloud à votre hub IoT
Messages de télémétrie envoyés d2c.telemetry.ingress.success Count Nombre de messages de télémétrie appareil vers cloud envoyés avec succès à votre hub IoT

Pour les métriques dont la valeur d’unité est Comptage, seule l’agrégation totale (somme) est valide. Les agrégations Minimum, Maximum et Moyenne retournent toujours la valeur 1. Pour en savoir plus, consultez les agrégations prises en charge.

Métriques des opérations d’appareil à jumeau cloud :

Nom d’affichage de la métrique Métrique Unité Description
Lectures de représentations d’appareils en échec d2c.twin.read.failure Count Total des lectures de représentations en échec initiées par un appareil.
Mises à jour de représentations d’appareils en échec d2c.twin.update.failure Count Total des mises à jour de représentations en échec initiées par un appareil.
Taille de la réponse des lectures de représentations des appareils d2c.twin.read.size Octets Nombre de lectures de toutes les représentations réussies initiées par un appareil.
Taille des mises à jour de représentations d’appareils d2c.twin.update.size Octets Taille totale des mises à jour de représentations réussies initiées par un appareil.
Lectures de représentations réussies d’appareils d2c.twin.read.success Count Total des lectures de représentations réussies initiées par un appareil.
Mises à jour de représentations réussies d’appareils d2c.twin.update.success Count Total des mises à jour de représentations réussies initiées par un appareil.

Pour les métriques dont la valeur d’unité est Comptage, seule l’agrégation totale (somme) est valide. Les agrégations Minimum, Maximum et Moyenne retournent toujours la valeur 1. Pour en savoir plus, consultez les agrégations prises en charge.

Métriques Event Grid :

Nom d’affichage de la métrique Métrique Unité Description
Remises Event Grid EventGridDeliveries Count Nombre d’événements IoT Hub publiés dans Event Grid. Utilisez la dimension Résultat pour le nombre de requêtes ayant réussi et ayant échoué. La dimension EventType représente le type de l’événement (https://aka.ms/ioteventgrid).
Latence d’Event Grid EventGridLatency Millisecondes Latence moyenne (en millisecondes) entre le moment où l’événement Iot Hub a été généré et le moment où l’événement a été publié dans Event Grid. Ce nombre est une moyenne de tous les types d’événement. Utilisez la dimension Type d’événement pour afficher la latence d’un type d’événement spécifique.

Pour les métriques dont la valeur d’unité est Comptage, seule l’agrégation totale (somme) est valide. Les agrégations Minimum, Maximum et Moyenne retournent toujours la valeur 1. Pour en savoir plus, consultez les agrégations prises en charge.

Métriques de travaux :

Nom d’affichage de la métrique Métrique Unité Description
Travaux terminés jobs.completed Count Total des travaux terminés.
Appels en échec pour répertorier les travaux jobs.listJobs.failure Count Total des appels en échec pour répertorier les travaux.
Créations des travaux d’appel de méthode en échec jobs.createDirectMethodJob.failure Count Total des créations en échec des travaux d’appel de méthode directe.
Créations des travaux de mises à jour de représentations en échec jobs.createTwinUpdateJob.failure Count Total des créations en échec des travaux de mises à jour de représentations.
Annulations de travaux en échec jobs.cancelJob.failure Count Total des appels en échec pour annuler un travail.
Requêtes de travaux en échec jobs.queryJobs.failure Count Total des appels en échec pour interroger les travaux.
Travaux en échec jobs.failed Count Total des travaux en échec.
Appels réussis pour répertorier les travaux jobs.listJobs.success Count Total des appels réussis pour répertorier les travaux.
Créations réussies des travaux d’appel de méthode jobs.createDirectMethodJob.success Count Total des créations réussies des travaux d’appel de méthode directe.
Créations réussies des travaux de mises à jour de représentations jobs.createTwinUpdateJob.
success
Count Total des créations réussies de travaux de mises à jour de représentations.
Annulations de travaux réussies jobs.cancelJob.success Count Total des appels réussis pour annuler un travail.
Requêtes de travaux réussies jobs.queryJobs.success Count Total des appels réussis pour interroger les travaux.

Pour les métriques dont la valeur d’unité est Comptage, seule l’agrégation totale (somme) est valide. Les agrégations Minimum, Maximum et Moyenne retournent toujours la valeur 1. Pour en savoir plus, consultez les agrégations prises en charge.

Métriques de routage :

Nom d’affichage de la métrique Métrique Unité Description
Livraisons de routage (préversion) RoutingDeliveries Count La métrique de livraison de routage. Utilisez les dimensions pour identifier l’état de livraison d’un point de terminaison ou d’une source de routage spécifiques.
Taille des messages de livraison du routage en octets (préversion) RoutingDataSizeInBytesDelivered Octets Nombre total d’octets acheminés par IoT Hub vers un point de terminaison personnalisé et un point de terminaison intégré. Utilisez les dimensions pour identifier la taille des données acheminées vers un point de terminaison ou une source de routage spécifiques.
Latence de livraison du routage (préversion) RoutingDeliveryLatency Millisecondes La métrique de latence de la livraison de routage. Utilisez les dimensions pour identifier l’état de livraison d’un point de terminaison ou d’une source de routage spécifiques.
Routage : objets blob remis au stockage d2c.endpoints.egress.storage.blobs Count Nombre de fois où le routage IoT Hub a remis des objets blob à des points de terminaison de stockage.
Routage : données remises au stockage d2c.endpoints.egress.storage.bytes Octets Quantité de données (octets) que le routage IoT Hub a remis aux points de terminaison de stockage.
Routage : latence des messages pour Event Hubs d2c.endpoints.latency.eventHubs Millisecondes Latence moyenne (en millisecondes) entre les entrées de messages vers IoT Hub et les entrées de messages dans des points de terminaison personnalisés de type Event Hubs. Les itinéraires des messages vers les points de terminaison intégrés (événements) ne sont pas inclus.
Routage : latence des messages de la file d’attente Service Bus d2c.endpoints.latency.serviceBusQueues Millisecondes Latence moyenne (en millisecondes) entre les entrées de messages vers IoT Hub et dans un point de terminaison de file d’attente Service Bus.
Routage : latence des messages de la rubrique Service Bus d2c.endpoints.latency.serviceBusTopics Millisecondes Latence moyenne (en millisecondes) entre les entrées de messages vers IoT Hub et dans un point de terminaison de rubrique Service Bus.
Routage : latence des messages de messages/d’événements d2c.endpoints.latency.builtIn.events Millisecondes Latence moyenne (en millisecondes) entre les entrées de messages vers IoT Hub et dans le point de terminaison intégré (messages/événements) l’itinéraire de secours.
Routage : latence des messages du stockage d2c.endpoints.latency.storage Millisecondes Latence moyenne (en millisecondes) entre les entrées de messages vers IoT Hub et dans un point de terminaison de stockage.
Routage : messages remis à Event Hubs d2c.endpoints.egress.eventHubs Count Nombre de fois où le routage IoT Hub a correctement remis des messages à des points de terminaison personnalisés de type Event Hubs. Les itinéraires des messages vers les points de terminaison intégrés (événements) ne sont pas inclus.
Routage : messages remis à la file d’attente Service Bus d2c.endpoints.egress.serviceBusQueues Count Nombre de fois où le routage IoT Hub a correctement remis des messages aux points de terminaison de file d’attente Service Bus.
Routage : messages remis à la rubrique Service Bus d2c.endpoints.egress.serviceBusTopics Count Nombre de fois où le routage IoT Hub a correctement remis des messages à des points de terminaison de rubrique Service Bus.
Routage : messages remis à l’itinéraire de secours d2c.telemetry.egress.fallback Count Nombre de fois où le routage IoT Hub a remis des messages au point de terminaison associé à l’itinéraire de secours.
Routage : messages remis à des messages/événements d2c.endpoints.egress.builtIn.events Count Nombre de fois où le routage IoT Hub a correctement remis des messages au point de terminaison intégré (messages/événements) à l’itinéraire de secours.
Routage : messages remis au stockage d2c.endpoints.egress.storage Count Nombre de fois où le routage IoT Hub a correctement remis des messages à des points de terminaison de stockage.
Routage : messages de télémétrie remis d2c.telemetry.egress.success Count Nombre de fois où des messages ont été correctement remis à tous les points de terminaison à l’aide du routage IoT Hub. Si un message est routé vers plusieurs points de terminaison, cette valeur augmente d’une unité pour chaque remise réussie. Si un message est routé plusieurs fois vers le même point de terminaison, cette valeur augmente d’une unité pour chaque remise réussie.
Routage : messages de télémétrie supprimés d2c.telemetry.egress.dropped Count Le nombre de fois où le routage IoT Hub supprime les messages en raison de points de terminaison morts. Cette valeur ne compte pas les messages remis à un itinéraire de secours, car les messages annulés n’y sont pas livrés.
Routage : messages de télémétrie incompatibles d2c.telemetry.egress.invalid Count Nombre de fois où le routage IoT Hub n’a pas réussi à remettre des messages en raison d’une incompatibilité avec le point de terminaison. Un message n’est pas compatible avec un point de terminaison lorsque Iot Hub tente de remettre le message à un point de terminaison et qu’il échoue avec une erreur nontransiente. Il n’y a pas de nouvelle tentative pour les messages non valides. Cette valeur n’inclut pas les nouvelles tentatives.
Routage : messages de télémétrie orphelins d2c.telemetry.egress.orphaned Count Nombre de fois où les messages orphelins de routage IoT Hub ne correspondent à aucune requête de routage, lorsque l’itinéraire de secours est désactivé.

Pour les métriques dont la valeur d’unité est Comptage, seule l’agrégation totale (somme) est valide. Les agrégations Minimum, Maximum et Moyenne retournent toujours la valeur 1. Pour en savoir plus, consultez les agrégations prises en charge.

Métriques de requête de jumeau :

Nom d’affichage de la métrique Métrique Unité Description
Requêtes de représentations en échec twinQueries.failure Count Total des requêtes de représentations en échec.
Requêtes de représentations réussies twinQueries.success Count Total des requêtes de représentations réussies.
Taille du résultat des requêtes de représentations twinQueries.resultSize Octets Total de toutes les requêtes de représentations réussies.

Pour les métriques dont la valeur d’unité est Comptage, seule l’agrégation totale (somme) est valide. Les agrégations Minimum, Maximum et Moyenne retournent toujours la valeur 1. Pour en savoir plus, consultez les agrégations prises en charge.

Journaux d’activité de ressources

Cette section répertorie les types de journaux d’activité de ressources que vous pouvez collecter pour ce service. La section extrait la liste de tous les types de catégorie de journaux d’activité de ressources pris en charge dans Azure Monitor.

Journaux de ressources pris en charge pour Microsoft.Devices/IotHubs

Category Nom complet de la catégorie Table de journal Prend en charge le plan de journal de base Prend en charge la transformation de la durée d’ingestion Exemples de requêtes Coûts d’exportation
C2DCommands Commandes C2D AzureDiagnostics

Journaux d’activité de plusieurs ressources Azure.

Non Non Requêtes Non
C2DTwinOperations Opérations de jumeaux C2D AzureDiagnostics

Journaux d’activité de plusieurs ressources Azure.

Non Non Requêtes Non
Configurations Configurations AzureDiagnostics

Journaux d’activité de plusieurs ressources Azure.

Non Non Requêtes Non
Connections Connexions AzureDiagnostics

Journaux d’activité de plusieurs ressources Azure.

Non Non Requêtes Non
D2CTwinOperations Opérations de jumeaux D2C AzureDiagnostics

Journaux d’activité de plusieurs ressources Azure.

Non Non Requêtes Non
DeviceIdentityOperations Opérations d’identité des appareils AzureDiagnostics

Journaux d’activité de plusieurs ressources Azure.

Non Non Requêtes Non
DeviceStreams Flux d’appareils (préversion) AzureDiagnostics

Journaux d’activité de plusieurs ressources Azure.

Non Non Requêtes Non
DeviceTelemetry Télémétrie d’appareil AzureDiagnostics

Journaux d’activité de plusieurs ressources Azure.

Non Non Requêtes Non
DirectMethods Méthodes directes AzureDiagnostics

Journaux d’activité de plusieurs ressources Azure.

Non Non Requêtes Non
DistributedTracing Traçage distribué (préversion) AzureDiagnostics

Journaux d’activité de plusieurs ressources Azure.

Non Non Requêtes Non
FileUploadOperations Opérations de chargement de fichier AzureDiagnostics

Journaux d’activité de plusieurs ressources Azure.

Non Non Requêtes Non
JobsOperations Opérations de travaux AzureDiagnostics

Journaux d’activité de plusieurs ressources Azure.

Non Non Requêtes Non
Routes Itinéraires AzureDiagnostics

Journaux d’activité de plusieurs ressources Azure.

Non Non Requêtes Non
TwinQueries Requêtes de jumeaux AzureDiagnostics

Journaux d’activité de plusieurs ressources Azure.

Non Non Requêtes Non

Les sections suivantes répertorient les types et schémas de catégorie de journal des ressources collectés pour Azure IoT Hub. Des événements sont émis uniquement pour les erreurs de certaines catégories.

Catégorie de commandes cloud-à-appareil

La catégorie de commandes cloud-à-appareil effectue le suivi des erreurs qui se produisent au niveau du hub IoT et qui sont liées au pipeline de messages cloud-à-appareil. Cette catégorie inclut les erreurs qui surviennent suite à ces événements :

  • Envoi de messages cloud-à-appareil (erreurs liées aux expéditeurs non autorisés, par exemple)
  • Réception de messages cloud-à-appareil (erreurs liées au dépassement du nombre de remises, par exemple)
  • Réception de commentaires sur les messages cloud-à-appareil (erreurs liées à l’expiration des commentaires, par exemple)

Cette catégorie ne signale pas les erreurs lorsque le message cloud-à-appareil est bien remis mais qu’il n’est pas correctement traité par l’appareil.

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

Catégorie d’opérations de jumeau cloud à appareil

La catégorie des opérations jumelles cloud-à-appareil effectue le suivi des événements initiés par le service sur des jumeaux d’appareil. Ces opérations peuvent inclure : obtenir un jumeau, mettre à jour ou remplacer des balises, et mettre à jour ou remplacer les propriétés souhaitées.

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

Catégorie d’opérations de jumeau appareil-à-cloud

La catégorie des opérations jumelles appareil-à-cloud effectue le suivi des événements initiés par l’appareil sur des jumeaux d’appareil. Ces opérations peuvent inclure l’obtention d’un jumeau, la mise à jour les propriétés signalées et l’abonnement aux propriétés souhaitées.

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

Catégorie Configurations

Les journaux de configuration d’IoT Hub permettent de suivre les événements et les erreurs pour l’ensemble de fonctionnalités de la gestion automatique des appareils.

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

Catégorie Connexions

La catégorie Connexions suit les événements de connexion et de déconnexion des appareils d’un hub IoT, et les erreurs. Cette catégorie est utile pour identifier les tentatives de connexion non autorisées et/ou donner l’alerte lorsque vous êtes déconnecté des appareils.

Pour connaître l’état de connexion fiable des appareils, consultez Analyser l’état de la connexion des appareils.

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

Pour plus d’informations sur l’utilisation des journaux de connexions pour surveiller la connectivité des appareils, consultez Surveiller, diagnostiquer et résoudre les problèmes de connectivité des appareils à Azure IoT Hub.

Catégorie des opérations d’identité d’appareil

La catégorie d’opérations d’identité des appareils effectue le suivi des erreurs qui se produisent quand vous tentez de créer, mettre à jour ou supprimer une entrée dans le registre d’identité de votre hub IoT. Le suivi de cette catégorie est utile pour les scénarios d’approvisionnement.

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

Catégorie de flux d’appareils (préversion)

La catégorie des flux d’appareil assure le suivi des interactions requête-réponse envoyées à des appareils individuels.

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

Catégorie de télémétrie de l’appareil

La catégorie de télémétrie d’appareil effectue le suivi des erreurs qui se produisent au niveau du hub IoT et qui sont liées au pipeline de télémétrie. Cette catégorie inclut notamment les erreurs concernant l’envoi d’événements de télémétrie (par exemple, une limitation) et la réception des événements de télémétrie (par exemple, un lecteur non autorisé). Cette catégorie ne peut pas intercepter les erreurs provoquées par le code en cours d’exécution sur l’appareil lui-même.

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

Catégorie de méthodes directes

La catégorie des méthodes directes assure le suivi des interactions demande-réponse envoyées à des appareils individuels. Ces demandes sont lancées dans le 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"
        }
    ]
}

Catégorie de suivi distribué (préversion)

La catégorie de traçage distribué suit les ID de corrélation pour les messages comportant l’en-tête de contexte de trace. Pour activer pleinement ces journaux d’activité, le code côté client doit être mis à jour en suivant Analyser et diagnostiquer les applications IoT de bout en bout avec le traçage distribué IoT Hub (preview).

correlationId est conforme à la proposition Contexte de trace W3C, car il contient un trace-id ainsi qu’un span-id.

Journaux d’activité appareil à cloud (D2C) IoT Hub

IoT Hub enregistre ce journal en recevant un message contenant des propriétés de trace valides.

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

Ici, durationMs n’est pas calculé, car l’horloge IoT Hub peut ne pas être synchronisée avec l’horloge de l’appareil, ce qui fausse le calcul de durée. Nous recommandons d’écrire la logique en utilisant les horodatages de la section properties pour capturer les pics de latence de l’appareil vers le cloud.

Propriété Type Description
messageSize Integer Taille du message appareil-à-cloud, en octets
deviceId Chaîne de caractères alphanumériques ASCII 7 bits Identité de l’appareil
callerLocalTimeUtc Horodateur UTC Heure de création du message telle que rapportée par l’horloge local de l’appareil
calleeLocalTimeUtc Horodateur UTC Heure de réception du message sur la passerelle d’IoT Hub telle qu’elle est rapportée par l’horloge du service IoT Hub

Journaux d’activité d’entrée IoT Hub

IoT Hub enregistre ce journal lorsqu’un message contenant des propriétés de trace valides écrit dans Event Hubs interne ou intégré.

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

Dans la section properties, ce journal contient des informations supplémentaires sur l’entrée des messages.

Propriété Type Description
isRoutingEnabled String Indique si le routage des messages est activé (true) ou non (false) dans le hub IoT
parentSpanId String span-id du message parent, qui serait la trace du message D2C dans ce cas-ci

Journaux d’activité de sortie IoT Hub

IoT Hub enregistre ce journal lorsque le routage est activé et que le message est écrit sur un point de terminaison. Si le routage n’est pas activé, IoT Hub n’enregistre pas ce journal.

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

Dans la section properties, ce journal contient des informations supplémentaires sur l’entrée des messages.

Propriété Type Description
endpointName String Nom du point de terminaison de routage
endpointType String Type du point de terminaison de routage
parentSpanId String span-id du message parent, qui serait la trace du message d’entrée IoT Hub dans ce cas-ci

Catégorie d’opérations de chargement de fichiers

La catégorie de chargement de fichiers effectue le suivi des erreurs qui se produisent au niveau de l’IoT hub et qui sont liées à la fonctionnalité de chargement. Cette catégorie inclut :

  • Erreurs qui se produisent avec l’URI SAP, par exemple en cas d’expiration avant qu’un appareil notifie le hub d’un téléchargement terminé.
  • Échecs des téléchargements signalés par l’appareil.
  • Erreurs qui se produisent lorsqu’un fichier est introuvable dans le stockage lors de la création du message de notification IoT Hub.

Cette catégorie ne peut pas détecter les erreurs qui surviennent directement pendant que l’appareil charge un fichier de stockage.

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

Catégorie d’opérations de travaux

La catégorie des opérations de travaux génère un rapport sur les demandes de travaux pour mettre à jour des jumeaux d’appareil ou appeler des méthodes directes sur plusieurs appareils. Ces demandes sont lancées dans le 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"
        }
    ]
}

Catégorie Routes

La catégorie de routage des messages assure le suivi des erreurs qui se produisent pendant l’évaluation du routage des messages et de l’intégrité du point de terminaison perçue par IoT Hub. Cette catégorie inclut les événements de type :

  • Une règle prend la valeur « non définie »
  • IoT Hub marque un point de terminaison comme mort
  • Toutes les erreurs reçues à partir d’un point de terminaison

Cette catégorie n’inclut pas les erreurs spécifiques aux messages eux-mêmes (les erreurs de limitation des appareils, par exemple) qui sont signalées dans la catégorie « télémétrie des appareils ».

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

Voici plus de détails sur le routage des journaux de ressource :

Catégorie de requêtes de jumeaux

La catégorie des requêtes de jumeaux génère un rapport sur les demandes de requêtes pour jumeaux d’appareil lancées dans le 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"
        }
    ]
}

Tables Azure Monitor Logs

Cette section répertorie les tables de journaux Azure Monitor pertinentes pour ce service, disponibles pour une requête par l’analytique des journaux d’activité à l’aide de requêtes Kusto. Les tables contiennent les données du journal des ressources et éventuellement d’autres données en fonction de ce qui est collecté et acheminé vers elles.

IoT Hub Microsoft.Devices/IotHubs

Journal d’activité

La table liée répertorie les opérations qui peuvent être enregistrées dans le journal d’activité de ce service. Ces opérations constituent un sous-ensemble de toutes les opérations possibles du fournisseur de ressources dans le journal d’activité.

Pour plus d’informations sur le schéma des entrées du journal d’activité, consultez Schéma du journal d’activité.