Freigeben über

Übersicht über das Geräteupdate für IoT Hub-Diagnose

Geräteupdate für IoT Hub verfügt über mehrere Features, mit denen Sie geräteseitige Fehler diagnostizieren und beheben können. Es stehen drei Diagnosefeatures zur Verfügung:

  • Bereitstellungsfehlercodes können direkt auf der Geräteaktualisierungs-Benutzeroberfläche angezeigt werden.

  • Die Remoteprotokollsammlung ermöglicht die Erstellung von Protokollvorgängen, die Zielgeräte anweisen, Diagnoseprotokolle auf Dem Gerät in ein verknüpftes Azure Blob Storage-Konto hochzuladen.

  • Die Agentüberprüfung führt Überprüfungsprüfungen auf Geräten aus, die auf Ihrer Device Update-Instanz registriert sind, mit dem Ziel, Geräte zu diagnostizieren, die im verbundenen IoT Hub registriert sind, aber nicht im Geräteupdate angezeigt werden.

Fehlercodes für die Bereitstellung in der Benutzeroberfläche

Wenn ein Gerät einen Bereitstellungsfehler an den Device Update-Dienst meldet, werden auf der Benutzeroberfläche von Device Update der vom Gerät gemeldete resultCode und extendedResultCode angezeigt. Führen Sie die folgenden Schritte aus, um diese Codes anzuzeigen:

  1. Navigieren Sie im Azure-Portal zu Ihrem IoT Hub.

  2. Wählen Sie "Updates" aus, und navigieren Sie dann zur Registerkarte " Gruppen und Bereitstellungen ".

  3. Wählen Sie den Namen einer Gruppe mit einer aktiven Bereitstellung aus, um zur Seite " Gruppendetails " zu gelangen.

  4. Wählen Sie einen beliebigen Gerätenamen in der Geräteliste aus, um den Bereich "Gerätedetails" zu öffnen. Hier sehen Sie den Ergebniscode, den das Gerät gemeldet hat.

  5. Der Verweis-Agent für Geräteupdates folgt der standardmäßigen HTTP-Statuscodekonvention für das Ergebniscodefeld (z. B. "200" gibt den Erfolg an). Weitere Informationen zum Analysieren von Ergebniscodes finden Sie unter Fehlercodes des Geräteupdateclients.

    Hinweis

    Wenn Sie ihren Geräteaktualisierungs-Agent so geändert haben, dass angepasste Ergebniscodes angezeigt werden, werden die numerischen Codes weiterhin an die Benutzeroberfläche für Geräteaktualisierung übergeben. Sie können dann auf jede Dokumentation verweisen, die Sie erstellt haben, um diese numerischen Codes zu analysieren.

Fernprotokollsammlung

Wenn weitere Informationen vom Gerät erforderlich sind, um einen Fehler zu diagnostizieren und zu beheben, können Sie das Protokollsammlungsfeature verwenden, um zielorientierte Geräte anweisen, Diagnoseprotokolle auf einem Gerät in ein verknüpftes Azure Blob Storage-Konto hochzuladen. Sie können mit der Verwendung dieses Features beginnen, indem Sie die Anweisungen unter Remoteerfassung von Diagnoseprotokollen von Geräten befolgen.

Die Remoteprotokollsammlung von Device Update ist ein dienstgesteuertes, prozedurbasiertes Feature. Um die Protokollsammlung nutzen zu können, muss ein Gerät nur in der Lage sein, die Diagnoseschnittstelle und Konfigurationsdatei zu implementieren und Dateien über das SDK in Azure Blob Storage hochzuladen.

Auf hoher Ebene funktioniert das Protokollsammlungsfeature wie folgt:

  1. Sie erstellen einen neuen Protokollvorgang mithilfe der Geräteaktualisierungs-Benutzeroberfläche oder APIs für bis zu 100 Geräte, die die Diagnoseschnittstelle implementiert haben.

  2. Der Geräteaktualisierungsdienst sendet eine Protokollauflistungsstartnachricht an die Zielgeräte mithilfe der Diagnoseschnittstelle. Diese Startnachricht enthält die Protokollvorgangs-ID und ein SAS-Token zum Hochladen in das zugeordnete Azure Storage-Konto.

  3. Beim Empfang der Startnachricht versucht der Geräteaktualisierungs-Agent des Zielgeräts, die Dateien in einem oder mehreren vordefinierten Dateipfaden zu sammeln und hochzuladen, die in der Konfigurationsdatei des On-Device-Agents angegeben sind. Der Geräteupdate-Referenz-Agent ist so konfiguriert, dass das Diagnoseprotokolladuc.log des Geräteupdate-Agents () und das DO-Agent-Diagnoseprotokoll ("do-agent.log") standardmäßig hochgeladen wird.

  4. Der Geräteaktualisierungs-Agent meldet dann den Status des Vorgangs ( entweder erfolgreich oder fehlgeschlagen) zurück an den Dienst, einschließlich der Protokollvorgangs-ID, eines ResultCode und eines ExtendedResultCode. Wenn der Geräteaktualisierungs-Agent einen Protokollvorgang fehlschlägt, versucht er automatisch, dreimal erneut zu versuchen, und meldet nur den endgültigen Zustand zurück an den Dienst.

  5. Nachdem alle Zielgeräte ihren Terminalstatus wieder an den Geräteaktualisierungsdienst gemeldet haben, kennzeichnet der Geräteaktualisierungsdienst den Protokollvorgang entweder als erfolgreich oder fehlgeschlagen. Ein erfolgreicher Protokollvorgang gibt an, dass alle Zielgeräte den Protokollvorgang erfolgreich abgeschlossen haben. Ein fehlgeschlagener Protokollvorgang gibt an, dass mindestens ein Zielgerät den Protokollvorgang fehlgeschlagen hat.

    Hinweis

    Da der Protokollvorgang parallel von den Zielgeräten ausgeführt wird, ist es möglich, dass einige zielorientierte Geräte erfolgreich Protokolle hochgeladen haben, der gesamte Protokollvorgang jedoch als fehlgeschlagen gekennzeichnet ist. Sie können sehen, welche Geräte erfolgreich waren und welche fehlgeschlagen sind, indem Sie die Protokollvorgangsdetails über die Benutzeroberfläche oder APIs anzeigen.

Agentenprüfung

Wenn Ihr Gerät im IoT Hub registriert, aber nicht in Ihrer Device Update-Instanz angezeigt wird, können Sie die Agent-Überprüfungsfunktion verwenden, um vorab vorgenommene Überprüfungen auszuführen, um das zugrunde liegende Problem zu diagnostizieren. Sie können mit der Verwendung dieses Features beginnen, indem Sie diese Anweisungen zur Agentprüfung befolgen.

Auf einer höheren Ebene funktioniert die Agentenprüfung wie folgt:

  1. Sie registrieren ein Gerät bei IoT Hub. Wenn das Gerät eine Modell-ID meldet, die mit den für Device Update for IoT Hub kompatiblen Modellen übereinstimmt, registriert Ihre verbundene Device Update-Instanz das Gerät automatisch bei Device Update.
  2. Damit ein Gerät von Device Update korrekt verwaltet werden kann, muss es bestimmte Kriterien erfüllen, die mit den vorgefertigten Validierungsprüfungen von Agent Check überprüft werden können. Weitere Informationen zu diesen Kriterien finden Sie hier.
  3. Wenn ein Gerät nicht alle diese Kriterien erfüllt, kann es nicht ordnungsgemäß von der Geräteaktualisierung verwaltet werden und wird nicht in der Geräteaktualisierungsschnittstelle oder API-Antworten angezeigt. Sie können Agent Check verwenden, um dieses Gerät zu finden und zu versuchen, zu ermitteln, welches Kriterium mithilfe von Agent Check nicht erfüllt wird.
  4. Nachdem Sie festgestellt haben, welche Kriterien nicht erfüllt werden, beheben Sie möglicherweise das Problem, und das Gerät sollte dann ordnungsgemäß in der Geräteaktualisierungsschnittstelle angezeigt werden.

Nächste Schritte

Erfahren Sie, wie Sie die Remote-Log-Sammlung und die Agentenprüfungsfunktionen von Device Update verwenden.

  • Last updated on