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

Platí pro: IoT Edge 1.5 IoT Edge 1.4

Důležité

Podporované verze ioT Edge 1.5 LTS a IoT Edge 1.4 LTS. IoT Edge 1.4 LTS je konec životnosti 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 zahrnutých v modulu agenta IoT Edge. Přímé metody se implementují na zařízení a pak je možné je vyvolat z cloudu. Agent IoT Edge obsahuje přímé metody, které vám pomůžou vzdáleně monitorovat a spravovat 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 se zpracovávají bez rozlišování velkých a malých písmen.

Ping

Metoda ping je užitečná pro kontrolu, 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 přímé metody můžete otestovat agenta IoT Edge příkazem ping a získat 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'

Na webu Azure Portal vyvoláte metodu s názvem ping metody a prázdnou datovou částí {}JSON.

Restartování modulu

Metoda RestartModule umožňuje vzdálenou správu modulů spuštěných na zařízení IoT Edge. Pokud modul hlásí stav selhání nebo jiné chování, které není v pořádku, můžete aktivovat agenta IoT Edge, aby ho restartoval. Příkaz úspěšného restartování vrátí prázdnou datovou část a stav: 200.

Metoda RestartModule je dostupná ve službě IoT Edge verze 1.0.9 a novější.

Tip

Stránka řešení potíží se službou IoT Edge na webu Azure Portal poskytuje zjednodušené prostředí pro 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 můžete použít na jakémkoli modulu spuštěném na zařízení IoT Edge, včetně samotného modulu edgeAgent. Pokud ale tuto přímou metodu použijete k vypnutí agenta edgeAgent, nedostanete výsledek úspěchu, protože připojení se přeruší při restartování modulu.

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 vyvolejte metodu s názvem RestartModule metody a následující datovou částí JSON:

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

Diagnostické přímé metody

• GetModuleLogs: Načtěte protokoly modulů vložené 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ů pomocí sady podpory a nahrajte soubor ZIP do 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