Beheben von Problemen bei IoT Edge-Geräten über das Azure-Portal

Gilt für:Häkchen für IoT Edge 1.5 IoT Edge 1.5 IoT Edge 1.4 Häkchen IoT Edge 1.4

Wichtig

IoT Edge 1.5 LTS und IoT Edge 1.4 LTS sind unterstützte Releases. Das Ende der Lebensdauer von IoT Edge 1.4 LTS wird am 12. November 2024 erreicht. Wenn Sie ein früheres Release verwenden, finden Sie weitere Informationen unter Aktualisieren von IoT Edge.

IoT Edge bietet eine optimierte Möglichkeit zur Überwachung von und Problembehandlung bei Modulen im Azure-Portal. Die Seite zur Problembehandlung ist ein Wrapper für direkte Methoden des IoT Edge-Agents, sodass Sie Protokolle aus bereitgestellten Modulen problemlos abrufen und remote neu starten können. In diesem Artikel erfahren Sie, wie Sie im Azure-Portal auf Geräte- und Modulprotokolle zugreifen und diese filtern.

Zugriff auf die Seite zur Problembehandlung

Sie können auf die Seite zur Problembehandlung im Portal entweder über die Seite „IoT Edge Gerätedetails“ oder die Seite „IoT Edge Moduldetails“ zugreifen.

  1. Melden Sie sich beim Azure-Portal an, und navigieren Sie zu Ihrem IoT Hub.

  2. Wählen Sie im linken Bereich unter dem Menü Geräteverwaltung die Option Geräte aus.

  3. Wählen Sie in der Liste mit Geräten das IoT Edge-Gerät aus, das Sie überwachen möchten.

  4. Auf dieser Seite mit den Gerätedetails können Sie im Menü Problembehandlung auswählen.

    Screenshot des Speicherorts der Registerkarte

    Oder wählen Sie den Laufzeitstatus eines bestimmten Moduls aus, das Sie überprüfen möchten.

    Screenshot des Speicherorts der Spalte

  5. Auf der Seite mit den Gerätedetails können Sie auch den Namen eines Moduls auswählen, um die Seite mit den Moduldetails zu öffnen. Von dort aus können Sie im Menü die Option Problembehandlung auswählen.

    Screenshot des Speicherorts der Registerkarte

Anzeigen von Modulprotokollen im Portal

Auf der Seite Problembehandlung Ihres Gerätes können Sie Protokolle von jedem der ausgeführten Module auf Ihrem IoT Edge-Gerät anzeigen und herunterladen.

Diese Seite hat einen maximalen Grenzwert von 1.500 Protokollzeilen, und alle Protokolle, die länger sind, werden abgeschnitten. Wenn die Protokolle zu groß sind, schlägt der Versuch des Abrufs von Modulprotokollen fehl. Versuchen Sie in diesem Fall, den Zeitbereichsfilter zu ändern, damit weniger Daten abgerufen werden, oder verwenden Sie direkte Methoden zum Abrufen von Protokollen aus IoT Edge-Bereitstellungen, um größere Protokolldateien zu sammeln.

Wählen Sie im Dropdownmenü aus, welches Modul überprüft werden soll.

Screenshot, der zeigt, wie Sie ein Modul aus dem Dropdownmenü auswählen, das Sie überprüfen möchten.

Standardmäßig werden auf dieser Seite die letzten 15 Minuten aus Protokollen angezeigt. Wählen Sie den Filter Zeitbereich aus, um verschiedene Protokolle anzuzeigen. Mithilfe des Schiebereglers können Sie ein Zeitfenster innerhalb der letzten 60 Minuten auswählen, oder aktivieren Sie stattdessen Enter time (Zeit eingeben), um ein bestimmtes „datetime“-Fenster auszuwählen.

Screenshot, der zeigt, wie Sie einen Zeit- oder Zeitbereich aus dem Popupfilter

Sobald Sie über die Protokolle verfügen und den Zeitfilter aus dem Modul festlegen, das Sie beheben möchten, können Sie den Suchfilter verwenden, um bestimmte Zeilen aus den Protokollen abzurufen. Sie können entweder nach Warnungen oder Fehlern filtern oder aber einen bestimmten Begriff oder Ausdruck für die Suche angeben.

Screenshot der Verwendung eines dotnet regex-Musters zum Durchsuchen der Protokolle mithilfe des Suchfilters.

Das Feature Suche unterstützt Klartextsuchen oder reguläre .NET-Ausdrücke für komplexere Suchvorgänge.

Sie können die Modulprotokolle als Textdatei herunterladen. Die heruntergeladene Protokolldatei spiegelt alle aktiven Filter wider, die Sie auf die Protokolle angewendet haben.

Tipp

Bei der CPU-Auslastung auf einem Gerät kommt es vorübergehend zu Spitzen, während es Protokolle als Reaktion auf eine Anforderung aus dem Portal sammelt. Dieses Verhalten wird erwartet, und die Auslastung sollte sich nach Abschluss der Aufgabe stabilisieren.

Neustarten von Modulen

Die Seite Problembehandlung enthält ein Feature zum Neustarten eines Moduls. Wenn Sie diese Option auswählen, wird ein Befehl an den IoT Edge-Agent gesendet, um das ausgewählte Modul neu zu starten. Das Neustarten eines Moduls wirkt sich nicht auf Ihre Möglichkeit aus, Protokolle vor dem Neustart abzurufen.

Screenshot, der zeigt, wie Sie ein Modul über die Seite

Nächste Schritte

Suchen Sie weitere Tipps zur Problembehandlung bei Ihrem IoT Edge-Gerät, oder informieren Sie sich über Häufige Probleme und Lösungen.

Wenn Sie weitere Fragen haben, erstellen Sie eine Supportanfrage, um Hilfe zu erhalten.