Tutoriel : Monitoring des appareils IoT Edge

S’applique à : IoT Edge 1.5

Important

IoT Edge 1.5 LTS est la version prise en charge. IoT Edge 1.4 LTS est en fin de vie depuis le 12 novembre 2024. Si vous utilisez une version antérieure, consultez Mettre à jour IoT Edge.

Utilisez des classeurs Azure Monitor pour effectuer le monitoring de l’intégrité et du niveau de performance de vos déploiements Azure IoT Edge.

Dans ce tutoriel, vous allez apprendre à :

• Découvrez les métriques que les appareils IoT Edge partagent et comment le module collecteur de métriques les gère.
• Déployez le module du collecteur de métriques sur un appareil IoT Edge.
• Consultez des visualisations curées des métriques collectées à partir de l’appareil.

Prérequis

Vous avez besoin d’un appareil IoT Edge avec le module de capteur de température simulé déployé. Si vous ne possédez pas d’appareil prêt, suivez la procédure décrite dans Déploiement d’un premier module IoT Edge sur un appareil virtuel Linux pour en créer un avec une machine virtuelle.

Présentation des métriques IoT Edge

Chaque appareil IoT Edge s’appuie sur deux modules, appelés modules d’exécution, qui gèrent le cycle de vie et la communication de tous les autres modules sur un appareil. Ces modules sont l’agent IoT Edge et le hub IoT Edge. Pour plus d’informations sur ces modules, consultez Présentation du runtime Azure IoT Edge et de son architecture.

Les deux modules d’exécution créent des métriques qui vous permettent de surveiller à distance l’exécution d’un appareil IoT Edge ou de ses modules individuels. L’agent IoT Edge signale l’état des modules individuels et de l’appareil hôte, de sorte qu’il crée des métriques telles que la durée d’exécution correcte d’un module, ou la quantité de RAM et le pourcentage d’UC utilisés sur l’appareil. Le hub IoT Edge signale les communications sur l’appareil, de sorte qu’il crée des métriques comme le nombre total de messages envoyés et reçus, ou le temps nécessaire pour résoudre une méthode directe. Pour connaître la liste complète des métriques disponibles, consultez Accès aux métriques intégrées.

Les deux modules exposent automatiquement ces métriques. Vous pouvez donc créer vos propres solutions pour y accéder et les signaler. Pour faciliter ce processus, Microsoft fournit le module azureiotedge-metrics-collector, qui gère ce processus si vous n’avez pas ou souhaitez une solution personnalisée. Le module collecteur de métriques collecte les métriques des deux modules d’exécution et tous les autres modules que vous souhaitez surveiller et les envoie hors de l’appareil.

Le module collecteur de métriques envoie vos métriques au cloud de deux façons. La première option, utilisée dans ce tutoriel, envoie les métriques directement à Log Analytics. La deuxième option est recommandée uniquement si vos stratégies de mise en réseau le nécessitent. Il envoie les métriques via IoT Hub, puis configure un itinéraire pour transmettre les messages de métrique à Log Analytics. Dans les deux cas, une fois que les métriques se trouvent dans votre espace de travail Log Analytics, vous pouvez les afficher via des classeurs Azure Monitor.

Créer un espace de travail Log Analytics

Un espace de travail Log Analytics est nécessaire pour collecter des données de métriques, utiliser un langage de requête et l’intégrer à Azure Monitor afin de pouvoir surveiller vos appareils.

1. Connectez-vous au portail Azure.

2. Recherchez des espaces de travail Log Analytics, puis sélectionnez-les.

3. Sélectionnez Créer, puis suivez les invites pour créer un espace de travail.

4. Une fois votre espace de travail prêt, sélectionnez Accéder à la ressource.

5. Dans le menu principal sous Paramètres, sélectionnez Agents.

6. Copiez les valeurs de l’ID de l’espace de travail et de la clé primaire sous les instructions de l’agent Log Analytics. Vous utilisez ces valeurs plus loin dans le tutoriel pour configurer le module collecteur de métriques pour envoyer des métriques à cet espace de travail.

Récupération de l’ID de ressource du IoT

Lorsque vous configurez le module collecteur de métriques, vous entrez l’ID de ressource Azure Resource Manager pour votre hub IoT. Obtenez cet ID maintenant.

1. Accédez à votre IoT Hub dans le Portail Azure.

2. Sous Paramètres, sélectionnez Propriétés.

3. Copiez la valeur ID de la ressource. Le format est /subscriptions/<subscription_id>/resourceGroups/<resource_group_name>/providers/Microsoft.Devices/IoTHubs/<iot_hub_name>.

Déploiement du module du collecteur de métriques

Déployez le module collecteur de métriques sur chaque appareil que vous souhaitez surveiller. Il s’exécute sur l’appareil comme n’importe quel autre module et surveille ses points de terminaison assignés pour collecter des métriques et les envoyer au cloud.

Pour déployer et configurer le module du collecteur, procédez comme suit :

1. Connectez-vous au portail Azure, puis accédez à votre hub IoT.

1.Sous Gestion des appareils, sélectionnez Appareils.

1. Sélectionnez l’ID d’appareil de l’appareil cible dans la liste des appareils IoT Edge pour ouvrir la page des détails de l’appareil.

2. Dans la barre de menus, sélectionnez Définir des modules.

3. La première étape du déploiement de modules à partir du portail consiste à déclarer les modules sur un appareil. Si vous utilisez le même appareil que celui que vous avez créé dans le guide de démarrage rapide, vous voyez déjà SimulatedTemperatureSensor répertorié. Si ce n’est pas le cas, ajoutez-le maintenant :

   1. Dans la section modules IoT Edge , sélectionnez Ajouter, puis choisissez Module IoT Edge.

   2. Mettez à jour les paramètres de module suivants :

      Paramètre	Valeur
      Nom du module IoT	SimulatedTemperatureSensor
      URI d’image	mcr.microsoft.com/azureiotedge-simulated-temperature-sensor:latest
      Stratégie de redémarrage	toujours
      État souhaité	exécution en cours

   3. Sélectionnez Suivant : Itinéraires pour continuer à configurer des itinéraires.

   4. Ajoutez une route qui envoie tous les messages du module de température simulé à IoT Hub.

      Paramètre	Valeur
      Nom	SimulatedTemperatureSensorToIoTHub
      Valeur	FROM /messages/modules/SimulatedTemperatureSensor/* INTO $upstream

4. Ajoutez et configurez le module du collecteur de métriques :

   1. Sélectionnez Ajouter, puis choisissez Module IoT Edge.

   2. Recherchez et sélectionnez Collecteur de métriques IoT Edge.

   3. Mettez à jour les paramètres de module suivants :

      Paramètre	Valeur
      Nom du module IoT	IoTEdgeMetricsCollector
      URI d’image	mcr.microsoft.com/azureiotedge-metrics-collector:latest
      Stratégie de redémarrage	toujours
      État souhaité	exécution en cours

   Pour utiliser une autre version ou architecture du module collecteur de métriques, recherchez des images disponibles dans le Registre Microsoft Artifact.

   1. Accédez à l’onglet Variables d’environnement .

   2. Ajoutez les variables d’environnement de type texte suivantes :

      Nom	Valeur
      ResourceId	ID de ressource du hub IoT que vous avez récupéré dans une section précédente.
      UploadTarget	AzureMonitor
      LogAnalyticsWorkspaceId	ID de l’espace de travail Log Analytics que vous avez récupéré dans une section précédente.
      LogAnalyticsSharedKey	Clé Log Analytics que vous avez récupérée dans une section précédente.

      Pour plus d’informations sur les paramètres des variables d’environnement, consultez la Configuration du collecteur de métriques.

   3. Sélectionnez Appliquer pour enregistrer vos modifications.

   Remarque

   Pour envoyer des métriques via IoT Hub, ajoutez un itinéraire vers l’amont similaire à FROM /messages/modules/< FROM_MODULE_NAME >/* INTO $upstream. Dans ce tutoriel, les métriques sont envoyées directement à Log Analytics. Par conséquent, cet itinéraire n’est pas nécessaire.

5. Sélectionnez Vérifier + créer pour passer à l’étape finale du déploiement des modules.

6. Sélectionnez Créer pour terminer le déploiement.

Une fois que vous avez terminé le déploiement des modules, revenez à la page de détails de l’appareil, où vous voyez quatre modules répertoriés comme spécifiés dans le déploiement. Il peut falloir quelques instants pour que les quatre modules soient listés comme étant Signalé par l'appareil, ce qui signifie qu'ils ont démarré et signalé leur état à IoT Hub. Actualisez la page pour afficher l’état le plus récent.

Monitoring de l’intégrité de l’appareil

L’affichage des classeurs de surveillance de votre appareil peut prendre jusqu’à 15 minutes. Après avoir déployé le module collecteur de métriques, il commence à envoyer des messages de métriques à Log Analytics, où ils sont organisés dans une table. L’ID de ressource IoT Hub que vous fournissez relie les métriques ingérées au hub approprié. Par conséquent, les classeurs IoT Edge organisés récupèrent des métriques en interrogeant la table des métriques avec l’ID de ressource.

Azure Monitor fournit trois modèles de classeurs par défaut pour IoT :

• Le classeur Vue de la flotte montre l’intégrité des appareils dans plusieurs ressources IoT. La vue vous permet de définir des seuils pour l’intégrité de l’appareil et d’afficher les agrégations des métriques principales par appareil.
• Le classeur Détails de l’appareil affiche des visualisations pour la messagerie, les modules et l’hôte. La vue Messages permet de visualiser l’itinéraire des messages pour un appareil et donne l’intégrité globale du système de messagerie. La vue modules montre comment les modules individuels sur un appareil s’exécutent. La vue hôte affiche des informations sur l’appareil hôte, y compris les informations de version pour les composants hôtes et l’utilisation des ressources.
• La vue de classeur Alertes montre les alertes pour les appareils de plusieurs ressources IoT.

Exploration des classeurs Vue de la flotte et Instantané d’intégrité

L'interface d'affichage de la flotte montre tous vos appareils et vous permet de sélectionner des appareils spécifiques pour voir leurs états de santé. Procédez comme suit pour explorer les visualisations de classeur :

1. Accédez à votre page IoT Hub dans le portail Azure.

2. Dans le menu principal, descendez jusqu'à la section Surveillance et sélectionnez Workbooks.

   

3. Sélectionnez le classeur Vue de la flotte.

4. Vous voyez votre appareil exécutant le module collecteur de métriques. comme sain ou non sain.

5. Sélectionnez le nom de l’appareil pour afficher les métriques détaillées.

6. Sur n’importe quel graphique horaire, utilisez les icônes de flèche sous l’axe X ou sélectionnez le graphique et faites glisser votre curseur pour modifier l’intervalle de temps.

   

7. Fermez le classeur Instantané d’intégrité. Dans le classeur de l'aperçu de la flotte, sélectionnez Workbooks pour revenir à la galerie des classeurs.

Exploration du classeur Détails de l’appareil

Le classeur Détails de l’appareil affiche des informations sur le niveau de performance d’un appareil donné. Procédez comme suit pour explorer les visualisations de classeur :

1. Dans la galerie de classeurs, sélectionnez le classeur Détails de l'appareil IoT Edge.

2. La première page du classeur détails de l’appareil est la vue de messagerie avec l’onglet routage sélectionné.

   Sur la gauche, un tableau affiche les itinéraires sur l’appareil, organisés par point de terminaison. Pour cet appareil, le point de terminaison en amont , qui est le terme de routage vers IoT Hub, reçoit les messages de la sortie temperatureOutput du module de capteur de température simulé.

   À droite, un graphique montre le nombre de clients connectés au fil du temps. Sélectionnez et faites glisser le graphique pour modifier l’intervalle de temps.

   

3. Sélectionnez l’onglet Graphe pour afficher une autre visualisation des itinéraires. Sur la page du graphique, glissez-déposez les extrémités pour réorganiser le graphique. Cette fonctionnalité permet de visualiser de nombreux itinéraires.

   

4. L’onglet Santé affiche les problèmes liés à la messagerie, tels que les messages perdus ou les clients déconnectés.

5. Sélectionnez la vue Modules pour afficher l’état de tous les modules déployés sur l’appareil. Sélectionnez un module pour afficher des détails sur son utilisation du processeur et de la mémoire.

   

6. Sélectionnez l’affichage hôte pour afficher des informations sur l’appareil hôte, notamment son système d’exploitation, sa version du démon IoT Edge et l’utilisation des ressources.

Affichage des journaux des modules

Une fois que vous avez consulté les métriques d’un appareil, vous souhaiterez peut-être approfondir et inspecter les modules individuels. IoT Edge fournit une assistance à la résolution des problèmes sur le Portail Azure avec une fonctionnalité de journaux dynamiques des modules.

1. Dans le classeur détails de l’appareil, sélectionnez Résoudre les problèmes en direct.

   

2. La page de résolution des problèmes s’ouvre sur les journaux edgeAgent de l’appareil IoT Edge. Si vous sélectionnez un intervalle de temps spécifique dans le classeur détails de l’appareil, ce paramètre passe à la page de résolution des problèmes.

3. Utilisez le menu déroulant pour basculer vers les journaux d’activité des autres modules s’exécutant sur l’appareil, puis utilisez le bouton Redémarrer pour redémarrer un module.

   

Vous pouvez également accéder à la page de résolution des problèmes à partir de la page de détails d’un appareil IoT Edge. Pour plus d’informations, consultez Résolution des problèmes des appareils IoT Edge sur le Portail Azure.

Étapes suivantes

À mesure que vous parcourez le reste des didacticiels, conservez le module collecteur de métriques sur vos appareils et revenez à ces classeurs pour voir comment les informations changent lorsque vous ajoutez des modules et un routage plus complexes.

Accédez au tutoriel suivant pour configurer votre environnement de développement et commencer à déployer des modules personnalisés sur vos appareils.

Développer des modules Azure IoT Edge à l’aide de Visual Studio Code