Kommunikation mit edgeAgent über integrierte direkte Methoden

Gilt für: IoT Edge 1.5

Wichtig

IoT Edge 1.5 LTS ist das unterstützte Release. IoT Edge 1.4 LTS wurde am 12. November 2024 eingestellt. Wenn Sie ein früheres Release verwenden, finden Sie weitere Informationen unter Aktualisieren von IoT Edge.

Überwachen und Verwalten von IoT Edge-Bereitstellungen mithilfe der direkten Methoden im IoT Edge-Agent-Modul. Direkte Methoden werden auf dem Gerät implementiert und können über die Cloud aufgerufen werden. Der IoT Edge-Agent enthält direkte Methoden zum Überwachen und Verwalten von IoT Edge-Geräten remote.

Weitere Informationen zu direkten Methoden sowie zu ihrer Verwendung und Implementierung in Ihren eigenen Modulen finden Sie unter Verstehen und Aufrufen direkter Methoden von IoT Hub.

Bei den Namen dieser direkten Methoden wird die Groß-/Kleinschreibung nicht beachtet.

Pingen

Die Pingmethode überprüft, ob IoT Edge auf einem Gerät ausgeführt wird oder ob das Gerät über eine offene Verbindung mit IoT Hub verfügt. Verwenden Sie diese Methode, um den IoT Edge-Agent zu pingen und den Status zu überprüfen. Ein erfolgreicher Ping gibt eine leere Nutzlast und einen "Status" zurück: 200.

Zum Beispiel:

az iot hub invoke-module-method --method-name 'ping' -n <hub name> -d <device name> -m '$edgeAgent'

Rufen Sie im Azure-Portal die Methode mithilfe des Methodennamens ping und einer leeren JSON-Nutzlast auf {}.

Neustart des Moduls

Mit der RestartModule-Methode können Sie Module remote verwalten, die auf einem IoT Edge-Gerät ausgeführt werden. Wenn ein Modul einen fehlerhaften Zustand oder ein fehlerhaftes Verhalten meldet, lösen Sie den IoT Edge-Agent aus, um ihn neu zu starten. Ein Befehl für einen erfolgreichen Neustart gibt eine leere Nutzlast mit "status": 200 zurück.

Die RestartModule-Methode ist ab IoT Edge Version 1.0.9 verfügbar.

Tipp

Die Seite "Problembehandlung bei IoT Edge" im Azure-Portal vereinfacht den Neustart von Modulen. Weitere Informationen finden Sie unter Überwachen und Beheben von Problemen bei IoT Edge-Geräten über das Azure-Portal.

Verwenden Sie die direkte RestartModule-Methode auf jedem Modul, das auf einem IoT Edge-Gerät ausgeführt wird, einschließlich des EdgeAgent-Moduls. Wenn Sie diese direkte Methode verwenden, um den EdgeAgent herunterzufahren, erhalten Sie kein Erfolgsergebnis, da die Verbindung während des Modulneustarts unterbrochen wird.

Zum Beispiel:

az iot hub invoke-module-method --method-name 'RestartModule' -n <hub name> -d <device name> -m '$edgeAgent' --method-payload \
'
    {
        "schemaVersion": "1.0",
        "id": "<module name>"
    }
'

Verwenden Sie im Azure-Portal den Methodennamen RestartModule mit der folgenden JSON-Nutzlast:

{
    "schemaVersion": "1.0",
    "id": "<module name>"
}

Direkte Diagnosemethoden

• GetModuleLogs: Abrufen von Modulprotokollen in der Antwort der direkten Methode.
• UploadModuleLogs: Abrufen von Modulprotokollen und Hochladen in Azure Blob Storage.
• UploadSupportBundle: Abrufen von Modulprotokollen mit einem Supportbundle und Hochladen einer ZIP-Datei in Azure Blob Storage.
• GetTaskStatus: Überprüfen Sie den Status eines Uploadprotokolls oder einer Support-Bundle-Anforderung.

Diese direkten Diagnosemethoden sind ab Version 1.0.10 verfügbar.

Nächste Schritte

Eigenschaften der Modulzwillinge von IoT Edge-Agent und IoT Edge-Hub