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 , , EndpointName RoutingSource |
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 , , 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 , , EndpointName RoutingSource |
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.
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 , , dropped orphaned , ou null . |
Result | success ou failure |
RoutingSource | Device Messages , , Twin Change Events Device 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) | Non | Non | 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 :
- Liste des codes d’erreur du routage de journaux de ressource
- Liste des operationNames du 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é.
Contenu connexe
- Consultez Surveiller Azure IoT Hub pour obtenir une description de la surveillance d’IoT Hub.
- Pour plus d’informations sur la supervision des ressources Azure, consultez Superviser des ressources Azure avec Azure Monitor.