Référence des données de supervision 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 sur la façon de les 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 obtenir des informations sur la conservation des métriques, consultez la section Présentation des métriques dans 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 : type d’agrégation par défaut. Valeurs valides : Moyen (moy), Minimum (min), Maximum (max), Total (somme), Nombre.
Dimensions - Dimensions disponibles pour l'indicateur.
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.

Unité de mesure	Nom dans l’API REST	Unité	Regroupement	Taille	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`	Nombre	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`	Nombre	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`	Nombre	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`	Nombre	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`	Nombre	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`	Nombre	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`	Nombre	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`	Nombre	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`	Nombre	Moyenne, Minimum, Maximum, Total (Somme)	<aucune>	PT1M	Oui
Messages C2D expirés Nombre de messages cloud vers appareil ayant expiré	`C2DMessagesExpired`	Nombre	Moyenne, Minimum, Maximum, Total (Somme)	<aucune>	PT1M	Oui
Métriques de configuration Métriques pour les opérations de configuration	`configurations`	Nombre	Moyenne, Minimum, Maximum, Total (Somme)	<aucune>	PT1M	Oui
Connexions réussies Connexions réussies à votre IoTHub	`connect.success`	Nombre	Total (Somme)	`ApiType`, , `ProtocolTLSVersion`, ,`TLSCipher`	PT1M	Oui
Appareils connectés Nombre d’appareils connectés à votre hub IoT	`connectedDeviceCount`	Nombre	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`	Nombre	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`	Nombre	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`	Nombre	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`	Nombre	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`	Nombre	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`	Nombre	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`	Nombre	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`	Nombre	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`	Nombre	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`	Nombre	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`	Nombre	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`	Nombre	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`	Nombre	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`	Nombre	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`	Nombre	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`	Nombre	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`	Nombre	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`	Nombre	Moyenne, Minimum, Maximum, Total (Somme)	<aucune>	PT1M	Oui
Nombre total de messages utilisés Nombre total de messages utilisés aujourd'hui	`dailyMessageQuotaUsed`	Nombre	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`	Nombre	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`	Nombre	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`	Nombre	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`	Nombre	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`	Nombre	Moyenne, Minimum, Maximum, Total (Somme)	<aucune>	PT1M	Oui
Travaux terminés Total des travaux terminés.	`jobs.completed`	Nombre	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`	Nombre	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`	Nombre	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`	Nombre	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`	Nombre	Moyenne, Minimum, Maximum, Total (Somme)	<aucune>	PT1M	Oui
Travaux non réussis Total des travaux en échec.	`jobs.failed`	Nombre	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`	Nombre	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`	Nombre	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`	Nombre	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`	Nombre	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`	Nombre	Moyenne, Minimum, Maximum, Total (Somme)	`EndpointType`, `EndpointName`, , `FailureReasonCategory`, `Result`, `RoutingSource`	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`	Nombre	Moyenne, Maximum, Minimum	<aucune>	PT1M	Non
Requêtes de jumeau ayant échoué Total des requêtes de représentations en échec.	`twinQueries.failure`	Nombre	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`	Nombre	Moyenne, Minimum, Maximum, Total (Somme)	<aucune>	PT1M	Oui

Agrégations supportées

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

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

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

Pour les métriques de comptage de points uniques , IoT Hub inscrit un seul point de données (essentiellement un 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. Des exemples de métriques à point unique sont les messages de télémétrie envoyés et les remises de messages C2D terminées. Pour ces mesures, 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 nombre d’instantanés , IoT Hub enregistre un nombre total lorsque l’opération mesurée se produit. Actuellement, trois métriques d’instantané sont é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 somme sur la granularité spécifiée n’a aucun sens. Azure Monitor vous limite à sélectionner moyenne, minimale et 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	Descriptif
NomDuPointD'accès	Le nom du point de terminaison
Type de point de terminaison	`eventHubs`, `serviceBusQueues`, `cosmosDB`, `serviceBusTopics`, `builtin`, ou `blobStorage`
Type d’événement	`Microsoft.Devices.DeviceCreated`, `Microsoft.Devices.DeviceDeleted`, `Microsoft.Devices.DeviceConnected`, `Microsoft.Devices.DeviceDisconnected`ou `Microsoft.Devices.DeviceTelemetry` Pour plus d’informations, consultez Types d’événements.
FailureReasonCategory	L’une des valeurs suivantes : `invalid`, `dropped`, `orphaned`ou `null`.
Résultat	`success` ou `failure`
RoutageSource	`Device Messages`, , `Twin Change EventsDevice Lifecycle Events`

Nom d’affichage 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 d’affichage tel qu’attribué dans le portail Azure.

Métriques de commande Cloud vers appareil :

Nom d’affichage de la métrique	Unité de mesure	Unité	Descriptif
Messages C2D expirés	C2DMessagesExpiré	Nombre	Nombre de messages cloud vers appareil ayant expiré
Remises de messages cloud vers appareil terminées	c2d.commandes.egress.complete.success	Nombre	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	Nombre	Nombre de messages cloud vers appareil abandonnés par l’appareil
Messages cloud vers appareil rejetés	c2d.commandes.egress.reject.success	Nombre	Nombre de messages cloud vers appareil rejetés par l’appareil

Pour les métriques dont la valeur Unit est Count, seule l’agrégation totale (somme) est valide. Les agrégations minimale, maximale et moyenne renvoient toujours 1. Pour plus d’informations, consultez Agrégations prises en charge.

Métriques des méthodes Cloud to Device Direct :

Nom d’affichage de la métrique	Unité de mesure	Unité	Descriptif
Appels de méthode directe en échec	c2d.methods.failure	Nombre	Total des appels de méthode directe en échec.
Taille de demande des appels de méthode directe	c2d.methods.requestSize	Octets	Nombre de toutes les demandes de méthode directe réussies.
Taille de réponse des appels de méthode directe	c2d.methods.responseSize	Octets	Nombre de toutes les réponses directes réussies.
Appels de méthode directe réussis	c2d.methods.success	Nombre	Total des appels de méthode directe réussis.

Pour les métriques dont la valeur d’unité est Count , seule l’agrégation totale (somme) est valide. Les agrégations minimale, maximale et moyenne renvoient toujours 1. Pour plus d’informations, consultez Agrégations prises en charge.

Métriques d’opérations Cloud to Device Twin :

Nom d’affichage de la métrique	Unité de mesure	Unité	Descriptif
Lectures de représentations de serveur principal en échec	c2d.twin.read.failure	Nombre	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	Nombre	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	Taille totale de toutes les mises à jour de jumeau initiées par le serveur principal réussies.
Lectures de représentations réussies de serveur principal	c2d.twin.read.success	Nombre	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	Nombre	Total des mises à jour de représentations réussies initiées par un serveur principal.

Métriques de configuration :

Nom d’affichage de la métrique	Unité de mesure	Unité	Descriptif
Métriques de configuration	Configurations	Nombre	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. Le nombre d’opérations qui modifient le jumeau d’appareil ou le jumeau de module en raison de ces configurations est inclus.

Statistiques des quotas quotidiens :

Nom d’affichage de la métrique	Unité de mesure	Unité	Descriptif
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	Somme	Nombre d’octets transférés vers et depuis tous les appareils connectés à IotHub
Nombre total de messages utilisés	dailyMessageQuotaUsed	Nombre	Nombre total de messages utilisés aujourd’hui. Valeur cumulée qui est remise à zéro à 00:00 UTC tous les jours.

Pour Nombre total de messages utilisés, seules les agrégations minimales, maximales et moyennes sont prises en charge. Pour plus d’informations, consultez Agrégations prises en charge.

Métriques de l’appareil :

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

Pour le nombre total de périphériques (obsolète) et les périphériques connectés (obsolètes), seule l’agrégation totale (somme) est valide. Les agrégations minimale, maximale et moyenne renvoient toujours 1. Pour plus d’informations, consultez Agrégations prises en charge.

Pour le nombre total d’appareils et les appareils connectés, seules les agrégations minimales, maximales et moyennes sont valides. Pour plus d’informations, consultez Agrégations prises en charge.

Le nombre total d’appareils et les appareils connectés ne peuvent pas être exportés via les paramètres de diagnostic.

Métriques de télémétrie de l’appareil :

Nom d’affichage de la métrique	Unité de mesure	Unité	Descriptif
Nombre d’erreurs de limitation	d2c.telemetry.ingress.sendThrottle	Nombre	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	Nombre	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	Nombre	Nombre de messages de télémétrie appareil vers cloud envoyés avec succès à votre hub IoT

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

Nom d’affichage de la métrique	Unité de mesure	Unité	Descriptif
Lectures de représentations d’appareils en échec	d2c.twin.read.failure	Nombre	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	Nombre	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 toutes les lectures de jumeaux initiées par l’appareil réussies.
Taille des mises à jour de représentations d’appareils	d2c.twin.update.size	Octets	Taille totale de toutes les mises à jour de jumeau initiées par l’appareil réussies.
Lectures de représentations réussies d’appareils	d2c.twin.read.success	Nombre	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	Nombre	Total des mises à jour de représentations réussies initiées par un appareil.

Statistiques Event Grid :

Nom d’affichage de la métrique	Unité de mesure	Unité	Descriptif
Diffusions Event Grid	EventGridLivraisons	Nombre	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 Event Grid	EventGridLatency	Millisecondes	Latence moyenne (en millisecondes) entre la génération de l’événement IoT Hub et la publication de l’événement sur 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.

Indicateurs de l’emploi :

Nom d’affichage de la métrique	Unité de mesure	Unité	Descriptif
Travaux terminés	jobs.completed	Nombre	Total des travaux terminés.
Appels en échec pour répertorier les travaux	jobs.listJobs.failure	Nombre	Total des appels en échec pour répertorier les travaux.
Créations des travaux d’appel de méthode en échec	jobs.createDirectMethodJob.failure	Nombre	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	Nombre	Total des créations en échec des travaux de mises à jour de représentations.
Annulations de travaux en échec	jobs.cancelJob.failure	Nombre	Total des appels en échec pour annuler un travail.
Requêtes de travaux en échec	jobs.queryjobs.failure	Nombre	Total des appels en échec pour interroger les travaux.
Travaux en échec	jobs.failed	Nombre	Total des travaux en échec.
Appels réussis pour répertorier les travaux	emplois.listeEmplois.succès	Nombre	Total des appels réussis pour répertorier les travaux.
Créations réussies des travaux d’appel de méthode	jobs.createDirectMethodJob.success	Nombre	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. succès	Nombre	Total des créations réussies de travaux de mises à jour de représentations.
Annulations de travaux réussies	jobs.cancelJob.success	Nombre	Total des appels réussis pour annuler un travail.
Requêtes de travaux réussies	emplois.queryemplois.succès	Nombre	Total des appels réussis pour interroger les travaux.

Métriques de routage :

Nom d’affichage de la métrique	Unité de mesure	Unité	Descriptif
Acheminement des livraisons (préversion)	RoutageLivraisons	Nombre	La métrique de diffusion de routage. Utilisez les dimensions pour identifier l’état de remise d’un point de terminaison spécifique ou d’une source de routage spécifique.
Routage de la taille du message de remise en octets (préversion)	RoutageDataSizeInBytesDelivered	Octets	Nombre total d’octets acheminés par IoT Hub vers le point de terminaison personnalisé et le point de terminaison intégré. Utilisez les dimensions pour identifier la taille des données acheminées vers un point de terminaison spécifique ou pour une source de routage spécifique.
Latence de diffusion du routage (préversion)	RoutingDeliveryLatency	Millisecondes	Métrique de latence de remise de routage. Utilisez les dimensions pour identifier la latence d’un point de terminaison spécifique ou d’une source de routage spécifique.
Routage : objets blob remis au stockage	d2c.endpoints.egress.storage.blobs	Nombre	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 l’entrée des messages dans IoT Hub et l’entrée des messages dans les points de terminaison personnalisés de type Event Hubs. Les itinéraires de messages vers le point de terminaison intégré (é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 l’entrée d’un message dans IoT Hub et l’entrée d’un message 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 l’entrée d’un message dans IoT Hub et l’entrée d’un message dans un point de terminaison de sujet Service Bus.
Routage : latence des messages de messages/d’événements	d2c.endpoints.latency.builtIn.events	Millisecondes	Latence moyenne (millisecondes) entre l’entrée des messages dans IoT Hub et l’entrée des messages dans le point de terminaison intégré (messages/événements) et la route de secours.
Routage : latence des messages du stockage	d2c.endpoints.latency.storage	Millisecondes	Latence moyenne (en millisecondes) entre l’entrée d’un message dans IoT Hub et l’entrée d’un message dans un point de terminaison de stockage.
Routage : messages remis à Event Hubs	d2c.endpoints.egress.eventHubs	Nombre	Nombre de fois où le routage IoT Hub a remis avec succès des messages à des points de terminaison personnalisés de type Event Hubs. Les itinéraires de messages vers le point de terminaison intégré (événements) ne sont pas inclus.
Routage : messages remis à la file d’attente Service Bus	d2c.endpoints.egress.serviceBusQueues	Nombre	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	Nombre	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	Nombre	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	Nombre	Nombre de fois où le routage IoT Hub a remis avec succès des messages au point de terminaison intégré (messages/événements) et à l’itinéraire de secours.
Routage : messages remis au stockage	d2c.endpoints.egress.storage	Nombre	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	Nombre	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	Nombre	Le nombre de fois où le routage IoT Hub abandonne des messages en raison de points de terminaison morts. Cette valeur ne prend pas en compte les messages remis sur la route de secours, car les messages abandonnés n’y sont pas remis.
Routage : messages de télémétrie incompatibles	d2c.telemetry.egress.invalid	Nombre	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 est incompatible avec un point de terminaison lorsque IoT Hub tente de remettre le message à un point de terminaison et qu’il échoue avec une erreur non temporaire. Les messages non valides ne sont pas réessayés. Cette valeur n’inclut pas les nouvelles tentatives.
Routage : messages de télémétrie orphelins	d2c.telemetry.egress.orphaned	Nombre	Le nombre de fois où IoT Hub achemine des messages orphelins parce qu’ils ne correspondent à aucune requête de routage, lorsque l’itinéraire de secours est désactivé.

Métriques de requête jumeau :

Nom d’affichage de la métrique	Unité de mesure	Unité	Descriptif
Requêtes de représentations en échec	twinQueries.failure	Nombre	Total des requêtes de représentations en échec.
Requêtes de représentations réussies	twinQueries.success	Nombre	Total des requêtes de représentations réussies.
Taille du résultat des requêtes de représentations	twinQueries.resultSize	Octets	Taille totale des résultats de toutes les requêtes de jumeaux réussies.

Journaux des 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

Catégorie	Nom de présentation de la catégorie	Table de journal	Supporte le plan de journalisation de base	Soutient la transformation au moment de l'ingestion	Exemples de requêtes	Coûts d’exportation
`C2DCommands`	Commandes C2D	AzureDiagnostics Journaux de plusieurs ressources Azure.	Non	Non	Requêtes	Non
`C2DTwinOperations`	Opérations de jumeaux C2D	AzureDiagnostics Journaux de plusieurs ressources Azure.	Non	Non	Requêtes	Non
`Configurations`	Paramètres	AzureDiagnostics Journaux de plusieurs ressources Azure.	Non	Non	Requêtes	Non
`Connections`	Connexions	AzureDiagnostics Journaux de plusieurs ressources Azure.	Non	Non	Requêtes	Non
`D2CTwinOperations`	D2CTwinOperations	AzureDiagnostics Journaux de plusieurs ressources Azure.	Non	Non	Requêtes	Non
`DeviceIdentityOperations`	Opérations d’identité des appareils	AzureDiagnostics Journaux de plusieurs ressources Azure.	Non	Non	Requêtes	Non
`DeviceStreams`	Flux d’appareils (préversion)	AzureDiagnostics Journaux de plusieurs ressources Azure.	Non	Non	Requêtes	Non
`DeviceTelemetry`	Télémétrie d’appareil	AzureDiagnostics Journaux de plusieurs ressources Azure.	Non	Non	Requêtes	Non
`DirectMethods`	Méthodes directes	AzureDiagnostics Journaux de plusieurs ressources Azure.	Non	Non	Requêtes	Non
`DistributedTracing`	Traçage distribué (aperçu)	AzureDiagnostics Journaux de plusieurs ressources Azure.	Non	Non	Requêtes	Non
`FileUploadOperations`	Opérations de chargement de fichier	AzureDiagnostics Journaux de plusieurs ressources Azure.	Non	Non	Requêtes	Non
`JobsOperations`	Opérations de travaux	AzureDiagnostics Journaux de plusieurs ressources Azure.	Non	Non	Requêtes	Non
`Routes`	Itinéraires	AzureDiagnostics Journaux de plusieurs ressources Azure.	Non	Non	Requêtes	Non
`TwinQueries`	Requêtes jumelles	AzureDiagnostics Journaux de plusieurs ressources Azure.	Non	Non	Requêtes	Non

Les sections suivantes répertorient les types de catégories de journaux de ressources et les schémas collectés pour Azure IoT Hub. Les événements ne sont émis que pour les erreurs dans certaines catégories.

Catégorie de commandes cloud-à-appareil

La catégorie des commandes cloud-vers-appareil suit les erreurs qui se produisent sur le hub IoT et qui sont liées au pipeline de messages cloud-vers-appareil. Cette catégorie inclut les erreurs qui se produisent à partir des éléments suivants :

Envoi de messages cloud-à-appareil (comme les erreurs d’expéditeur non autorisé),
Réception de messages cloud-à-appareil (comme les erreurs de dépassement du nombre de livraisons) et
Réception de commentaires sur les messages du cloud vers l'appareil (comme les erreurs de commentaires expirés).

Cette catégorie n’intercepte pas les erreurs lorsque le message cloud-à-appareil est remis avec succès, mais qu’il n’est pas correctement géré 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 d’opérations de jumeau cloud à appareil effectue le suivi des événements initiés par le service sur les 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 d’opérations de jumeau appareil-à-cloud effectue le suivi des événements initiés par l’appareil sur les jumeaux d’appareil. Ces opérations peuvent inclure l’obtention d’un jumeau, la mise à jour des 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 de configurations

Les journaux de configuration IoT Hub suivent les événements et les erreurs pour l’ensemble de fonctionnalités de 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 effectue le suivi des événements de connexion et de déconnexion des appareils à partir d’un hub IoT et d’erreurs. Cette catégorie est utile pour identifier les tentatives de connexion non autorisées et/ou alerter lorsque vous perdez la connexion aux appareils.

Pour connaître l’état de connexion fiable des périphériques, consultez Surveiller l’état de connexion des périphériques.

{
   "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 d’opérations d’identité de l’appareil

La catégorie des opérations d’identité d’appareil suit les erreurs qui se produisent lorsque vous tentez de créer, de mettre à jour ou de supprimer une entrée dans le registre d’identités 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 Flux d’appareils (préversion)

La catégorie Flux d’appareils suit les interactions demande-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 de l’appareil suit les erreurs qui se produisent sur le hub IoT et sont liées au pipeline de télémétrie. Cette catégorie inclut des erreurs qui se produisent lors de l’envoi d’événements de télémétrie (tels que la limitation) et la réception d’événements de télémétrie (tels que le lecteur non autorisé). Cette catégorie ne peut pas détecter les erreurs causées par l’exécution du code 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 Méthodes directes

La catégorie de méthodes directes effectue le suivi des interactions de 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 traçage distribué (préversion)

La catégorie de suivi distribué suit les ID de corrélation des messages qui portent l’en-tête de contexte de suivi. Pour activer pleinement ces journaux, le code côté client doit être mis à jour en suivant la procédure Analyser et diagnostiquer les applications IoT de bout en bout avec le suivi distribué IoT Hub (préversion).

Le correlationId est conforme à la proposition de contexte de trace du W3C , où il contient un trace-id et un span-id.

Journaux IoT Hub D2C (device-to-cloud)

IoT Hub enregistre ce journal lorsqu’un message contenant des propriétés de trace valides arrive à IoT Hub.

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

Remarque

Ici, n’est pas calculé, durationMs car l’horloge d’IoT Hub n’est peut-être pas synchronisée avec l’horloge de l’appareil, et donc un calcul de durée peut être trompeur. Nous vous recommandons d’écrire une logique à l’aide des horodatages de la section pour capturer les pics de latence de l’appareil vers le properties cloud.

Propriété	Catégorie	Descriptif
messageSize	Nombre entier	Taille du message device-to-cloud en octets
deviceId	Chaîne de caractères alphanumériques ASCII 7 bits	L’identité de l’appareil
callerLocalTimeUtc	Horodatage UTC	L’heure de création du message telle qu’indiquée par l’horloge locale du périphérique
calleeLocalTimeUtc	Horodatage UTC	Heure d’arrivée du message à la passerelle IoT Hub, telle que signalée par l’horloge côté service IoT Hub

Journaux d’entrée IoT Hub

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

{
    "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 cette properties section, ce journal contient des informations supplémentaires sur l’entrée de messages.

Propriété	Catégorie	Descriptif
isRoutingEnabled	Chaîne	Vrai ou faux, indique si le routage des messages est activé ou non dans IoT Hub
parentSpanId	Chaîne	span-id du message parent, qui serait dans ce cas la trace du message D2C

Journaux 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 cette properties section, ce journal contient des informations supplémentaires sur l’entrée de messages.

Propriété	Catégorie	Descriptif
endpointName	Chaîne	Nom du point de terminaison de routage
endpointType	Chaîne	Le type du point de terminaison de routage
parentSpanId	Chaîne	span-id du message parent, qui serait le suivi du message d’entrée IoT Hub dans ce cas

Catégorie Opérations de téléchargement de fichiers

La catégorie de chargement de fichiers suit les erreurs qui se produisent sur le hub IoT et sont liées à la fonctionnalité de chargement de fichiers. Cette catégorie inclut :

Erreurs qui se produisent avec l’URI SAP, par exemple lorsqu’il expire avant qu’un appareil notifie le hub d’un chargement terminé.
Échec des 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 intercepter les erreurs qui se produisent directement lorsque l’appareil télécharge un fichier dans le 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 Emplois opérations

La catégorie des opérations de travaux signale les demandes de travail 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 d’itinéraires

La catégorie de routage des messages suit les erreurs qui se produisent lors de l’évaluation de l’itinéraire des messages et de l’intégrité du point de terminaison, telles que perçues par IoT Hub. Cette catégorie inclut des événements tels que :

Une règle est évaluée comme « indéfinie »
IoT Hub marque un point de terminaison comme mort
Toute erreur reçue d’un point de terminaison

Cette catégorie n’inclut pas d’erreurs spécifiques concernant les messages eux-mêmes (comme les erreurs de limitation de l’appareil), qui sont signalées dans la catégorie « Télémétrie de l’appareil ».

{
    "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 les journaux de ressources de routage :

Catégorie Requêtes jumelles

La catégorie requêtes de jumeaux signale les demandes de requêtes pour les jumeaux d’appareil initiés 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é.

Opérations du fournisseur de ressources Microsoft.Devices

Pour obtenir une description de la surveillance d’IoT Hub, consultez Surveiller Azure IoT Hub .
Pour plus d’informations sur la supervision des ressources Azure, consultez Superviser des ressources Azure avec Azure Monitor.

Rétroaction

Cette page a-t-elle été utile ?

Last updated on 2025-06-23