Collecter à distance les journaux de diagnostic à partir d’appareils à l’aide de Device Update pour IoT Hub

Navigateurs pris en charge :

• Microsoft Edge
• Google Chrome

Un environnement Azure CLI :

• Utilisez l’environnement Bash dans Azure Cloud Shell.

  

• Ou, si vous préférez exécuter des commandes de référence CLI localement, installez Azure CLI

  • Connectez-vous à Azure CLI à l’aide de la commande az login .
  • Exécutez az version pour rechercher la version et les bibliothèques dépendantes installées. Pour effectuer une mise à niveau vers la dernière version, exécutez az upgrade.
  • Lorsque vous y êtes invité, installez les extensions Azure CLI lors de la première utilisation. Les commandes de cet article utilisent l’extension azure-iot. Exécutez az extension update --name azure-iot pour vous assurer que vous disposez de la version la plus récente de l’extension.

1. Dans le portail Azure, accédez à votre compte Device Update pour IoT Hub.

2. Sélectionnez Instances sous la section Gestion des instances du volet de navigation.

3. Sélectionnez votre instance Device Update dans la liste, puis configurez les diagnostics.

4. Sélectionnez l’onglet Diagnostics client , puis sélectionnez compte de stockage Azure.

5. Choisissez votre compte de stockage souhaité dans la liste, puis sélectionnez Enregistrer.

6. Une fois de retour dans la liste des instances, sélectionnez Actualiser régulièrement jusqu’à ce que l’état d’approvisionnement de l’instance affiche « Réussi ». Ce processus prend généralement 2 à 3 minutes.

Utilisez la commande az iot du instance create pour configurer les diagnostics pour votre instance Device Update.

Remplacez les espaces réservés suivants par vos propres informations :

• < >account_name : nom de votre compte Device Update.
• < >instance_name : nom de votre instance Device Update.
• < >storage_id : ID de ressource du compte de stockage où les journaux de diagnostic seront stockés. Vous pouvez récupérer l’ID de ressource à l’aide de la commande az storage show et interroger la valeur d’ID : az storage account show -n <storage_name> --query id.

az iot du instance update --account <account_name> --instance <instance_name> --set enableDiagnostics=true diagnosticStorageProperties.resourceId=<storage_id>

1. Accédez à votre IoT Hub et sélectionnez l’onglet Mises à jour sous la section Gestion des appareils du volet de navigation.

2. Sélectionnez l’onglet Diagnostics dans l’interface utilisateur. Si vous ne voyez pas d’onglet Diagnostics, vérifiez que vous utilisez la dernière version de l’interface utilisateur Device Update pour IoT Hub. Si vous voyez « Diagnostics doit être activé pour cette instance Device Update », vérifiez que vous avez lié un compte de stockage Blob Azure à votre instance Device Update.

3. Sélectionnez Ajouter une opération de chargement de journal pour accéder à la page de création de l’opération de journal.

4. Entrez un nom (ID) et une description pour votre nouvelle opération de journal, puis sélectionnez Ajouter des appareils pour sélectionner les appareils IoT à partir desquels vous souhaitez collecter les journaux de diagnostic.

5. Sélectionnez Ajouter.

6. Une fois de retour sous l’onglet Diagnostics, sélectionnez Actualiser jusqu’à ce que votre opération de journal soit répertoriée dans la table des opérations.

7. Une fois que l’état de l’opération a réussi ou échoué, sélectionnez le nom de l’opération pour afficher ses détails. Une opération est marquée « Réussie » uniquement si tous les appareils ciblés ont correctement terminé le chargement du journal. Si certains appareils ciblés ont réussi et qu’ils ont échoué, l’opération de journal est marquée « Échec ». Vous pouvez utiliser la page des détails de l’opération de journal pour voir quels appareils ont réussi et qui ont échoué.

8. Dans les détails de la journalisation, vous pouvez voir l’état spécifique à l’appareil et le chemin d’accès du journal. Ce chemin correspond au chemin d’accès du répertoire virtuel dans votre compte de stockage Blob Azure où les journaux de diagnostic ont été chargés.

Utilisez la commande az iot du device log collect pour configurer une opération de collecte de journaux de diagnostics.

La commande device log collect prend les trois arguments suivants :

• --account : nom du compte Device Update.
• --instance : nom de l’instance Device Update.
• --log-collection-id : nom de l’opération de collecte des journaux.
• --agent-id: des paires clé = valeur qui identifient un agent Device Update cible pour cette opération de collecte de logs. Utilisez deviceId=<device name> si l’agent a une identité d’appareil. Utilisez deviceId=<device name> moduleId=<module name> si l’agent a une identité de module. Vous pouvez utiliser le --agent-id paramètre plusieurs fois pour cibler plusieurs appareils.

Par exemple:

az iot du device log collect \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --log-collection-id <log collection name} \
    --agent-id deviceId=<device name> \
    --agent-id deviceId=<device name> moduleId=<module name>

Utilisez az iot du device log show pour afficher les détails d’une opération de collecte de journaux de diagnostic spécifique.

az iot du device log show \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --log-collection-id <log collection name>