Fernabruf von Diagnoseprotokollen von Geräten mithilfe von Geräteupdates für IoT Hub

Erfahren Sie, wie Sie einen Geräteupdate für den IoT Hub-Protokollvorgang initiieren und gesammelte Protokolle in Azure Blob Storage anzeigen.

Voraussetzungen

Azure-Portal
Azure CLI

Zugriff auf einen IoT Hub mit für den IoT Hub aktivierter Geräteaktualisierung.
Ein IoT-Gerät (oder Simulator), das im IoT Hub für die Geräteaktualisierung bereitgestellt wurde und die Diagnose-Schnittstelle implementiert.
Ein Azure Blob Storage-Konto unter demselben Abonnement wie Ihr Geräteupdate für IoT Hub-Konto.

Hinweis

Das Feature für die Remoteprotokollsammlung ist derzeit nur mit Geräten kompatibel, die die Diagnoseschnittstelle implementieren und Dateien in Azure Blob Storage hochladen können. Die Implementierung des Referenz-Agents erwartet außerdem, dass das Gerät Protokolldateien in einen vom Benutzer angegebenen Dateipfad auf dem Gerät schreibt.

Zugriff auf einen IoT Hub mit für den IoT Hub aktivierter Geräteaktualisierung.
Ein IoT-Gerät (oder Simulator), das im IoT Hub für die Geräteaktualisierung bereitgestellt wurde und die Diagnose-Schnittstelle implementiert.
Ein Azure Blob Storage-Konto unter demselben Abonnement wie Ihr Geräteupdate für IoT Hub-Konto.
Eine Azure CLI-Umgebung:
- Verwenden Sie die Bash-Umgebung in Azure Cloud Shell.
- Wenn Sie CLI-Referenzbefehle auch lokal ausführen möchten, installieren Sie die Azure CLI.
  - Melden Sie sich mit dem Az-Anmeldebefehl bei der Azure CLI an.
  - Führen Sie az version aus, um die Version und Abhängigkeiten von Bibliotheken zu finden, die installiert sind. Um auf die neueste Version zu aktualisieren, führen Sie az-Upgrade aus.
  - Installieren Sie die Azure CLI-Erweiterungen bei der ersten Verwendung, wenn Sie dazu aufgefordert werden. Die Befehle in diesem Artikel verwenden die Azure-iot-Erweiterung . Führen Sie az extension update --name azure-iot aus, um sicherzustellen, dass Sie die neueste Version der Erweiterung verwenden.

Hinweis

Verknüpfen Ihres Azure Blob Storage-Kontos mit Ihrer Device Update-Instanz

Um das Remoteprotokollsammlungsfeature verwenden zu können, müssen Sie zuerst ein Azure Blob Storage-Konto mit Ihrer Device Update-Instanz verknüpfen. Dieses Azure Blob Storage-Konto ist der Ort, an den Ihre Geräte Diagnoseprotokolle hochladen.

Azure-Portal
Azure CLI

Navigieren Sie im Azure-Portal zu Ihrem Geräteupdate für IoT Hub-Konto.
Wählen Sie "Instanzen" im Abschnitt " Instanzverwaltung " des Navigationsbereichs aus.
Wählen Sie ihre Geräteaktualisierungsinstanz aus der Liste aus, und konfigurieren Sie dann die Diagnose.
Wählen Sie die Registerkarte " Kundendiagnose " und dann "Azure Storage-Konto" aus.
Wählen Sie in der Liste Ihr gewünschtes Speicherkonto aus, und wählen Sie " Speichern" aus.
Sobald sie wieder in der Instanzliste enthalten ist, wählen Sie regelmäßig "Aktualisieren" aus, bis der Bereitstellungsstatus der Instanz "Erfolgreich" angezeigt wird. Dieser Vorgang dauert in der Regel 2-3 Minuten.

Verwenden Sie den Befehl "az iot device-update instance create " zum Konfigurieren der Diagnose für Ihre Device Update-Instanz.

Tipp

Sie können den az iot device-update instance create Befehl für eine vorhandene Geräteaktualisierungsinstanz verwenden und die Instanz mit den aktualisierten Parametern konfigurieren.

Ersetzen Sie die folgenden Platzhalter durch Ihre eigenen Informationen:

< >account_name: Der Name Ihres Geräteaktualisierungskontos.
< >instance_name: Der Name Ihrer Device Update-Instanz.
< >storage_id: Die Ressourcen-ID des Speicherkontos, in dem die Diagnoseprotokolle gespeichert werden. Sie können die Ressourcen-ID mithilfe des Az Storage Show-Befehls abrufen und den ID-Wert abfragen: az storage account show -n <storage_name> --query id.

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

Konfigurieren der Protokollsammlung

Der Geräteupdate-Agent bezieht sich auf eine Konfigurationsdatei auf dem Gerät, die sich unter /etc/adu/du-diagnostics-config.json im Referenz-Agent befindet.

Protokollsammlungsdateipfade

Der Geräteupdate-Agent auf einem Gerät sammelt Dateien aus bestimmten Dateipfaden auf dem Gerät, wenn es ein Startsignal für den Protokollupload vom Geräteupdatedienst empfängt. Diese Dateipfade werden in der Diagnosekonfigurationsdatei definiert.

Innerhalb der Konfigurationsdatei wird jede zu erfassende und hochgeladene Protokolldatei als logComponent Objekt mit componentName- und logPath-Eigenschaften dargestellt. Diese Konfiguration kann nach Bedarf geändert werden.

Maximale Protokolldateigröße

Der Geräteupdate-Agent sammelt nur Protokolldateien unter einer bestimmten Dateigröße. Diese maximale Dateigröße wird in der Diagnosekonfigurationsdatei definiert.

Der relevante Parameter "maxKilobytesToUploadPerLogPath" gilt für jedes logComponent-Objekt und kann wie gewünscht geändert werden.

Erstellen eines Protokollvorgangs

Protokolloperationen sind dienstgesteuerte Aktionen, die Sie Ihren IoT-Geräten über den Geräteaktualisierungsdienst anweisen können auszuführen. Eine ausführlichere Erläuterung der Funktionsweise von Protokollvorgängen finden Sie unter Geräteaktualisierungsdiagnose.

Navigieren Sie zu Ihrem IoT Hub, und wählen Sie die Registerkarte "Updates " im Abschnitt " Geräteverwaltung " des Navigationsbereichs aus.
Wählen Sie auf der Benutzeroberfläche die Registerkarte " Diagnose " aus. Wenn keine Registerkarte "Diagnose" angezeigt wird, stellen Sie sicher, dass Sie die neueste Version der Benutzeroberfläche des Geräteupdates für IoT Hub verwenden. Wenn "Diagnose muss für diese Geräteaktualisierungsinstanz aktiviert sein" angezeigt wird, stellen Sie sicher, dass Sie ein Azure Blob Storage-Konto mit Ihrer Device Update-Instanz verknüpft haben.
Wählen Sie " Protokolluploadvorgang hinzufügen" aus, um zur Seite zum Erstellen des Protokollvorgangs zu navigieren.
Geben Sie einen Namen (ID) und eine Beschreibung für Ihren neuen Protokollvorgang ein, und wählen Sie dann "Geräte hinzufügen " aus, um auszuwählen, von welchen IoT-Geräten Sie Diagnoseprotokolle sammeln möchten.
Wählen Sie "Hinzufügen" aus.
Kehren Sie zur Registerkarte "Diagnose" zurück und wählen Sie "Aktualisieren", bis Ihr Protokollvorgang in der Vorgangstabelle aufgeführt ist.
Nachdem der Vorgangsstatus erfolgreich oder fehlgeschlagen ist, wählen Sie den Vorgangsnamen aus, um seine Details anzuzeigen. Ein Vorgang wird nur dann als "Erfolgreich" gekennzeichnet, wenn alle Zielgeräte den Protokollupload erfolgreich abgeschlossen haben. Wenn einige Zielgeräte erfolgreich waren und einige fehlgeschlagen sind, wird der Protokollvorgang als "Fehlgeschlagen" gekennzeichnet. Sie können die Detailseite des Protokollvorgangs verwenden, um zu sehen, welche Geräte erfolgreich waren und welche fehlgeschlagen sind.
In den Protokollvorgangsdetails können Sie den gerätespezifischen Status anzeigen und den Protokollspeicherortpfad anzeigen. Dieser Pfad entspricht dem virtuellen Verzeichnispfad in Ihrem Azure Blob Storage-Konto, in das die Diagnoseprotokolle hochgeladen wurden.

Anzeigen und Exportieren gesammelter Diagnoseprotokolle

Nachdem ihr Protokollvorgang erfolgreich war, navigieren Sie zu Ihrem Azure Blob Storage-Konto.
Wählen Sie "Container" im Abschnitt " Datenspeicher " des Navigationsbereichs aus.
Wählen Sie den Container mit demselben Namen wie Ihre Device Update-Instanz aus.
Verwenden Sie den Protokollspeicherortpfad aus den Protokollvorgangsdetails, um zum richtigen Verzeichnis zu navigieren, das die Protokolle enthält. Standardmäßig weist das Remoteprotokollsammlungsfeature Zielgeräte an, Diagnoseprotokolle mithilfe des folgenden Verzeichnispfadmodells hochzuladen: Blob-Speichercontainer/Zielgeräte-ID/Protokollvorgangs-ID/Protokollprotokollpfad
Wenn Sie die Diagnosekomponente des DU-Agents nicht geändert haben, reagiert das Gerät auf jeden Protokollvorgang, indem versucht wird, zwei Klartext-Protokolldateien hochzuladen: das DU-Agent-Diagnoseprotokoll ("aduc.log") und das DIAGNOSEprotokoll des DO-Agents ("do-agent.log"). Sie können mehr darüber erfahren, welche Protokolldateien der DU-Referenz-Agent sammelt, indem Sie die Seite " Geräteaktualisierungsdiagnose "-Konzept lesen.
Sie können den Inhalt der Protokolldatei anzeigen, indem Sie den Dateinamen auswählen, das Menüelement (Auslassungspunkte) auswählen und anschließend auf "Ansicht/Bearbeiten" klicken. Sie können die Protokolldatei auch herunterladen oder löschen, indem Sie die jeweils bezeichneten Optionen auswählen.

Nächste Schritte

Weitere Informationen zu den Diagnosefunktionen von Geräteupdates finden Sie in der Übersicht über die Diagnosefunktion für Geräteupdates

Last updated on 2022-06-23

Freigeben über