Udostępnij za pośrednictwem


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

Dotyczy: Znacznik wyboru usługi IoT Edge 1.5 IoT Edge 1.5 Znacznik wyboru usługi IoT Edge 1.4 IoT Edge 1.4

Ważne

Obsługiwane są wersje usługi IoT Edge 1.5 LTS i IoT Edge 1.4 LTS. Usługa IoT Edge 1.4 LTS kończy się 12 listopada 2024 r. Jeśli korzystasz z wcześniejszej wersji, zobacz aktualizację Azure IoT Edge.

Monitorowanie wdrożeń usługi IoT Edge i zarządzanie nimi przy użyciu metod bezpośrednich zawartych w module agenta usługi IoT Edge. Metody bezpośrednie są implementowane na urządzeniu, a następnie mogą być wywoływane z chmury. Agent usługi IoT Edge zawiera metody bezpośrednie, które ułatwiają zdalne monitorowanie urządzeń usługi IoT Edge i zarządzanie 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ą obsługiwane bez uwzględniania wielkości liter.

Polecenie ping

Metoda ping jest przydatna do sprawdzania, czy usługa IoT Edge jest uruchomiona na urządzeniu, czy też ma otwarte połączenie z usługą IoT Hub. Użyj tej metody bezpośredniej, aby wysłać polecenie ping do agenta usługi IoT Edge i uzyskać jego stan. Pomyślne polecenie ping zwraca pusty ładunek i "status": 200.

Na przykład:

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

W witrynie Azure Portal wywołaj metodę z nazwą ping metody i pustym ładunkiem {}JSON .

Zrzut ekranu przedstawiający sposób wywoływania polecenia ping metody bezpośredniej w witrynie Azure Portal.

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 niepowodzenia lub inne zachowanie w złej kondycji, możesz wyzwolić agenta usługi IoT Edge, aby go uruchomić ponownie. Pomyślne ponowne uruchomienie polecenia zwraca pusty ładunek i "status": 200.

Metoda RestartModule jest dostępna w usłudze IoT Edge w wersji 1.0.9 lub nowszej.

Napiwek

Strona rozwiązywania problemów z usługą IoT Edge w witrynie Azure Portal zapewnia uproszczone środowisko ponownego uruchamiania modułów. Aby uzyskać więcej informacji, zobacz Monitorowanie i rozwiązywanie problemów z urządzeniami usługi IoT Edge w witrynie Azure Portal.

Możesz użyć metody bezpośredniej RestartModule w dowolnym module uruchomionym na urządzeniu usługi IoT Edge, w tym samego modułu edgeAgent. Jeśli jednak użyjesz tej metody bezpośredniej do zamknięcia agenta edgeAgent, nie otrzymasz wyniku powodzenia, ponieważ połączenie zostanie przerwane podczas ponownego uruchamiania 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 wywołaj metodę z nazwą RestartModule metody i następującym ładunkiem JSON:

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

Zrzut ekranu przedstawiający sposób wywoływania metody bezpośredniej RestartModule w witrynie Azure Portal.

Metody diagnostyczne bezpośrednie

  • GetModuleLogs: pobierz wbudowane dzienniki 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 przy użyciu pakietu pomocy technicznej i przekazywanie pliku zip do usługi Azure Blob Storage.
  • GetTaskStatus: sprawdź stan dzienników przekazywania lub żądania pakietu 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