Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Device Update pour IoT Hub a plusieurs fonctionnalités qui vous aident à diagnostiquer et résoudre les erreurs côté appareil. Il existe trois fonctionnalités de diagnostic disponibles :
Les codes d’erreur de déploiement peuvent être consultés directement dans l’interface utilisateur device Update.
La collecte de journaux à distance permet de créer des opérations de journal, ce qui indique aux appareils ciblés de charger des journaux de diagnostic sur un compte de stockage Blob Azure lié.
Agent Check exécute des contrôles de validation sur les appareils enregistrés à votre instance Device Update, dans le but de diagnostiquer les appareils enregistrés dans le Hub IoT connecté, mais qui ne s'affichent pas dans Device Update.
Codes d’erreur de déploiement dans l’interface utilisateur
Lorsqu’un appareil signale un échec de déploiement au service Device Update, l’interface utilisateur Device Update affiche les informations signalées resultCode et extendedResultCode dans l’interface utilisateur de l’appareil. Pour afficher ces codes, procédez comme suit :
Accédez à votre IoT Hub dans le portail Azure.
Sélectionnez Mises à jour , puis accédez à l’onglet Groupes et déploiements .
Sélectionnez le nom d’un groupe avec un déploiement actif pour accéder à la page de détails du groupe .
Sélectionnez n’importe quel nom d’appareil dans la liste des appareils pour ouvrir le panneau détails de l’appareil. Ici, vous pouvez voir le code de résultat signalé par l’appareil.
L’agent de référence Device Update suit la convention de code d’état HTTP standard pour le champ de code de résultat (par exemple, « 200 » indique la réussite). Pour plus d’informations sur l’analyse des codes de résultat, consultez les codes d’erreur du client Device Update.
Note
Si vous avez modifié votre agent Device Update pour signaler des codes de résultat personnalisés, les codes numériques sont toujours transmis à l’interface utilisateur device Update. Vous pouvez ensuite faire référence à toute documentation que vous avez créée pour analyser ces codes numériques.
Collecte de journaux à distance
Lorsque des informations supplémentaires sur l’appareil sont nécessaires pour diagnostiquer et résoudre une erreur, vous pouvez utiliser la fonctionnalité de collecte de journaux pour indiquer aux appareils ciblés de charger des journaux de diagnostic sur un compte de stockage Blob Azure lié. Vous pouvez commencer à utiliser cette fonctionnalité en suivant les instructions de la collecte à distance des journaux de diagnostic à partir d’appareils.
La fonctionnalité de collecte de journaux à distance de Device Update est basée sur les opérations et pilotée par le service. Pour tirer parti de la collecte de journaux, un appareil doit uniquement être en mesure d’implémenter l’interface de diagnostic et le fichier de configuration, et de pouvoir charger des fichiers dans le stockage Blob Azure via le Kit de développement logiciel (SDK).
Voici une vue d’ensemble du fonctionnement de la collecte de journaux :
Vous créez une opération de journal à l’aide de l’interface utilisateur ou des API Device Update, ciblant jusqu’à 100 appareils qui ont implémenté l’interface de diagnostic.
Le service Device Update envoie un message de démarrage de la collecte de journaux aux appareils ciblés utilisant l’interface de diagnostic. Ce message de démarrage inclut l’ID d’opération de journal et un jeton SAP pour le chargement sur le compte de stockage Azure associé.
Lors de la réception du message de démarrage, l’agent Device Update de l’appareil ciblé tente de collecter et de charger les fichiers dans un ou plusieurs chemins de fichiers prédéfinis spécifiés dans le fichier de configuration de l’agent sur l’appareil. L’agent de référence Device Update est configuré pour charger le journal de diagnostic de l’agent Device Update (
aduc.log) et le journal de diagnostic de l’agent DO (« do-agent.log ») par défaut.L’agent Device Update signale ensuite l’état de l’opération ( réussite ou échec) au service, y compris l’ID d’opération de journal, un ResultCode et un ExtendedResultCode. Si l’agent Device Update échoue une opération de journal, il tente automatiquement de réessayer trois fois, en signalant uniquement l’état final au service.
Une fois que tous les appareils ciblés ont signalé leur état terminal au service Device Update, le service Device Update marque l’opération de journal comme ayant réussi ou échoué. Une opération de journalisation réussie indique que tous les appareils ciblés ont correctement terminé l’opération de journalisation. Une opération de journalisation ayant échoué indique qu’au moins un appareil ciblé a échoué à l’opération de journalisation.
Note
Étant donné que l’opération de journalisation est effectuée en parallèle par les appareils ciblés, il est possible que certains appareils ciblés aient correctement chargé les journaux, mais que l’opération globale de journalisation soit marquée comme ayant échoué. Vous pouvez voir quels appareils ont réussi et qui ont échoué en affichant les détails de l’opération de journal via l’interface utilisateur ou les API.
Vérification de l’agent
Lorsque votre appareil est inscrit dans IoT Hub, mais qu’il n’apparaît pas dans votre instance Device Update, vous pouvez utiliser la fonctionnalité Vérification de l’agent pour exécuter des vérifications de validation prédéfinies pour vous aider à diagnostiquer le problème sous-jacent. Vous pouvez commencer à utiliser cette fonctionnalité en suivant ces instructions de vérification de l’agent.
Voici une vue d’ensemble du fonctionnement de la vérification d’agent :
- Vous inscrivez un appareil auprès d’IoT Hub. Si l’appareil signale un ID de modèle qui correspond à ceux compatibles avec Device Update pour IoT Hub, votre instance Device Update connectée inscrit automatiquement l’appareil avec Device Update.
- Pour qu’un appareil soit correctement géré par Device Update, il doit répondre à certains critères qui peuvent être vérifiés à l’aide des vérifications de validation prédéfinies d'Agent Check. Vous trouverez plus d’informations sur ces critères ici.
- Si un appareil ne répond pas à tous ces critères, il ne peut pas être correctement géré par Device Update et ne s’affiche pas dans l’interface Device Update ou les réponses d’API. Vous pouvez utiliser Agent Check pour rechercher cet appareil et tenter d'identifier les critères qui ne sont pas remplis.
- Une fois que vous avez identifié quels critères ne sont pas remplis, vous pouvez corriger le problème et l’appareil doit ensuite apparaître correctement dans l’interface Device Update.
Étapes suivantes
Découvrez comment utiliser la collecte de journaux à distance de Device Update et la fonctionnalité contrôle de l’agent :