Komunikace s agentem edgeAgent pomocí integrovaných přímých metod

Platí pro: IoT Edge 1.5

Důležité

Podporovanou verzí je IoT Edge 1.5 LTS. IoT Edge 1.4 LTS je konec životnosti od 12. listopadu 2024. Pokud používáte starší verzi, podívejte se na článek Aktualizace IoT Edge.

Monitorování a správa nasazení IoT Edge pomocí přímých metod v modulu agenta IoT Edge. Přímé metody jsou na zařízení implementovány a lze je vyvolat z cloudu. Agent IoT Edge zahrnuje přímé metody pro vzdálené monitorování a správu zařízení IoT Edge.

Další informace o přímých metodách, jejich použití a způsobu jejich implementace ve vlastních modulech najdete v tématu Vysvětlení a vyvolání přímých metod ze služby IoT Hub.

Názvy těchto přímých metod nerozlišují velká a malá písmena.

Pingnout

Metoda ping zkontroluje, jestli je IoT Edge spuštěná na zařízení nebo jestli má zařízení otevřené připojení ke službě IoT Hub. Pomocí této metody otestujte agenta IoT Edge příkazem ping a zkontrolujte jeho stav. Úspěšný příkaz ping vrátí prázdnou datovou část a stav: 200.

Příklad:

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

V Azure portálu vyvolejte metodu pomocí názvu metody ping a prázdného JSON payloadu {}.

Restartování modulu

Metoda RestartModule umožňuje vzdáleně spravovat moduly spuštěné na zařízení IoT Edge. Pokud modul hlásí stav selhání nebo chování, které není v pořádku, aktivujte agenta IoT Edge, aby ho restartoval. Příkaz úspěšného restartování vrátí prázdnou datovou část se stavem 200.

Metoda RestartModule je dostupná od IoT Edge verze 1.0.9.

Návod

Stránka řešení potíží se službou IoT Edge na webu Azure Portal zjednodušuje restartování modulů. Další informace najdete v tématu Monitorování a řešení potíží se zařízeními IoT Edge na webu Azure Portal.

Přímou metodu RestartModule použijte na libovolném modulu spuštěném na zařízení IoT Edge, včetně modulu edgeAgent. Pokud tuto přímou metodu použijete k vypnutí agenta EdgeAgent, neobdržíte výsledek úspěchu, protože během restartování modulu dojde k přerušení připojení.

Příklad:

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

Na webu Azure Portal použijte název RestartModule metody s následující datovou částí JSON:

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

Diagnostické přímé metody

• GetModuleLogs: Načtěte protokoly modulů v odpovědi přímé metody.
• UploadModuleLogs: Načtěte protokoly modulů a nahrajte je do služby Azure Blob Storage.
• UploadSupportBundle: Načtěte protokoly modulů s balíčkem podpory a nahrajte soubor ZIP do služby Azure Blob Storage.
• GetTaskStatus: Zkontrolujte stav nahrání protokolů nebo žádosti o sadu podpory.

Tyto diagnostické přímé metody jsou k dispozici od verze 1.0.10.

Další kroky

Vlastnosti dvojčat modulů ioT Edge a agenta IoT Edge