Komunikacja z agentem edgeAgent przy użyciu wbudowanych metod bezpośrednich

Dotyczy: IoT Edge 1.5

Monitorowanie wdrożeń usługi IoT Edge i zarządzanie nimi przy użyciu metod bezpośrednich w module agenta usługi IoT Edge. Metody bezpośrednie są implementowane na urządzeniu i mogą być wywoływane z chmury. Agent usługi IoT Edge zawiera metody bezpośrednie do zdalnego monitorowania urządzeń usługi IoT Edge i zarządzania nimi.

Aby uzyskać więcej informacji o metodach bezpośrednich, sposobie ich używania i implementowaniu ich we własnych modułach, zobacz Omówienie i wywoływanie metod bezpośrednich z usługi IoT Hub.

Nazwy tych metod bezpośrednich są nie rozróżniane według wielkości liter.

Polecenie ping

Metoda ping sprawdza, czy usługa IoT Edge jest uruchomiona na urządzeniu lub czy urządzenie ma otwarte połączenie z usługą IoT Hub. Użyj tej metody, aby wysłać polecenie ping do agenta usługi IoT Edge i sprawdzić jego stan. Pomyślne polecenie ping zwraca pusty pakiet i "stan": 200.

Na przykład:

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

W portalu Azure wywołaj metodę przy użyciu nazwy metody ping i pustego ładunku JSON {}.

Ponowne uruchamianie modułu

Metoda RestartModule umożliwia zdalne zarządzanie modułami uruchomionymi na urządzeniu usługi IoT Edge. Jeśli moduł zgłasza stan awarii lub nieprawidłowe działanie, uruchom ponownie agenta IoT Edge. Pomyślne ponowne uruchomienie polecenia zwraca pusty ładunek ze stanem 200.

Metoda RestartModule jest dostępna od usługi IoT Edge w wersji 1.0.9.

Użyj metody bezpośredniej RestartModule w dowolnym module uruchomionym na urządzeniu usługi IoT Edge, w tym w module edgeAgent. Jeśli używasz tej metody bezpośredniej do zamknięcia agenta edgeAgent, nie otrzymasz wyniku powodzenia, ponieważ połączenie zostanie przerwane podczas ponownego uruchomienia modułu.

Na przykład:

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>"
    }
'

W witrynie Azure Portal użyj nazwy RestartModule metody z następującym ładunkiem JSON:

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

Metody diagnostyczne bezpośrednie

• GetModuleLogs: pobieranie dzienników modułów w odpowiedzi metody bezpośredniej.
• UploadModuleLogs: pobieranie dzienników modułów i przekazywanie ich do usługi Azure Blob Storage.
• UploadSupportBundle: pobieranie dzienników modułów z pakietem pomocy technicznej i przekazywanie pliku zip do usługi Azure Blob Storage.
• GetTaskStatus: sprawdź status przesłanych dzienników lub żądania paczki pomocy technicznej.

Te metody diagnostyczne są dostępne w wersji 1.0.10.

Następne kroki

Właściwości agenta usługi IoT Edge i bliźniaczych reprezentacji modułów usługi IoT Edge