Superviser les déploiements IoT Edge
S’applique à :
IoT Edge 1.4
Important
IoT Edge 1.4 est la version prise en charge. Si vous utilisez une version antérieure, consultez l’article Mettre à jour IoT Edge.
Azure IoT Edge fournit des rapports permettant d’effectuer un monitorage en temps réel des modules déployés sur les appareils IoT Edge. Le service IoT Hub récupère l’état des appareils et les met à la disposition de l’opérateur. Le monitorage est également important pour les déploiements effectués à grande échelle, notamment les déploiements automatiques et multicouches.
Dans la mesure où les appareils et les modules comportent des données similaires (par exemple, la connectivité), les valeurs sont récupérées en fonction de l’ID de l’appareil ou du module.
Le service IoT Hub collecte les données rapportées par les jumeaux d’appareil et de module, et fournit le nombre des différents états des appareils. Il organise ces données en quatre groupes de métriques :
| Type | Description |
|---|---|
| Ciblé | Affiche les appareils IoT Edge qui remplissent la condition de ciblage du déploiement. |
| Applied | Affiche les appareils IoT Edge ciblés, mais non ciblés par un autre déploiement de priorité plus élevée. |
| Réussite rapportée | Affiche les appareils IoT Edge ayant rapporté le bon déploiement des modules. |
| Échec rapporté | Affiche les appareils IoT Edge ayant rapporté l’échec de déploiement d’un ou plusieurs modules. Pour examiner l’erreur plus en détail, connectez-vous à distance à ces appareils et consultez les fichiers journaux. |
Le service IoT Hub met ces données à votre disposition sur le Portail Azure et dans Azure CLI.
Monitorage d’un déploiement sur le Portail Azure
Pour afficher les détails d’un déploiement et surveiller les appareils qui l’exécutent, effectuez les étapes suivantes :
Connectez-vous au portail Azure et accédez à votre hub IoT.
Sélectionnez Configurations+Déploiements sous le menu Gestion des appareils.
Inspectez la liste des déploiements. Pour chaque déploiement, vous pouvez consulter les détails suivants :
Colonne Description Identifiant Le nom du déploiement. Type Type de déploiement : Déploiement ou Déploiement multicouche. Condition cible Étiquette servant à définir les appareils ciblés. Priority Numéro de priorité attribué au déploiement. Métriques du système Nombre de jumeaux d’appareil dans IoT Hub remplissant la condition cible. Appliqué spécifie le nombre d’appareils dont les jumeaux de module se sont vu appliquer le contenu de déploiement dans IoT Hub. Métriques de l’appareil Nombre d’appareils IoT Edge rapportant la réussite ou des erreurs du runtime du client IoT Edge. Métriques personnalisées Nombre d’appareils IoT Edge rapportant des données pour les métriques définies dans le cadre du déploiement. Créé Horodateur de création du déploiement. Cet horodatage sert à départager deux déploiements ayant la même priorité. Sélectionnez le déploiement que vous souhaitez surveiller.
Dans la page Détails du déploiement, faites défiler jusqu’à la section inférieure et sélectionnez l’onglet Condition cible. Sélectionnez Affichage pour répertorier les appareils qui correspondent à la condition cible. Vous pouvez modifier cette condition ainsi que la Priorité. Le cas échéant, sélectionnez Enregistrer.
Sélectionnez l’onglet Métriques . Si vous choisissez une métrique dans la liste déroulante Sélectionner une métrique , un bouton Affichage s’affiche pour afficher les résultats. Vous pouvez également sélectionner Modifier les métriques pour ajuster les critères des métriques personnalisées définies. Le cas échéant, sélectionnez Enregistrer.
Pour apporter des modifications à votre déploiement, consultez Modification d’un déploiement.
Monitorage d’un déploiement avec Azure CLI
Utilisez la commande az iot edge deployment show pour afficher les détails d’un déploiement unique :
az iot edge deployment show --deployment-id [deployment id] --hub-name [hub name]
La commande « deployment show » utilise les paramètres suivants :
- --deployment-id : nom du déploiement qui existe dans le hub IoT. Paramètre obligatoire.
- --hub-name : nom du hub IoT dans lequel le déploiement existe. Le hub doit être dans l’abonnement actuel. Basculez vers l’abonnement souhaité avec la commande
az account set -s [subscription name].
Inspectez le déploiement dans la fenêtre de commande. La propriété metrics répertorie un nombre pour chaque métrique évaluée par chaque hub :
- targetedCount : métrique système qui spécifie le nombre de jumeaux d’appareil dans le hub IoT qui correspondent à la condition de ciblage.
- appliedCount : métrique système qui spécifie le nombre d’appareils dont les jumeaux de module se sont vu appliquer le contenu de déploiement dans IoT Hub.
- reportedSuccessfulCount : métrique d’appareil qui spécifie le nombre d’appareils IoT Edge dans le déploiement indiquant une réussite de l’exécution du client IoT Edge.
- reportedFailedCount : métrique d’appareil qui spécifie le nombre d’appareils IoT Edge dans le déploiement indiquant un échec de l’exécution du client IoT Edge.
Vous pouvez afficher la liste des ID d’appareil ou des objets de chacune des métriques avec la commande az iot edge deployment show-metric :
az iot edge deployment show-metric --deployment-id [deployment id] --metric-id [metric id] --hub-name [hub name]
La commande « deployment show-metric » utilise les paramètres suivants :
- --deployment-id : nom du déploiement qui existe dans le hub IoT.
- --metric-id : nom de la métrique pour laquelle vous souhaitez voir la liste des ID d’appareil, par exemple
reportedFailedCount. - --hub-name : nom du hub IoT dans lequel le déploiement existe. Le hub doit être dans l’abonnement actuel. Basculez vers l’abonnement souhaité avec la commande
az account set -s [subscription name].
Pour apporter des modifications à votre déploiement, consultez Modification d’un déploiement.
Étapes suivantes
Découvrez comment surveiller les jumeaux de module, principalement l’agent IoT Edge et les modules d’exécution IoT Edge Hub, pour la connectivité et l’intégrité de vos déploiements IoT Edge.