Megosztás a következőn keresztül:

Beépített közvetlen metódusok használatával végzett kommunikáció az edgeAgenttel

  • Cikk

A következőkre vonatkozik:IoT Edge 1.5 pipa IoT Edge 1.5

Fontos

Az IoT Edge 1.5 LTS a támogatott kiadás. Az IoT Edge 1.4 LTS 2024. november 12-én megszűnik. Ha egy korábbi kiadáson dolgozik, olvassa el az IoT Edge frissítése című témakört.

Az IoT Edge-környezetek monitorozása és kezelése az IoT Edge-ügynökmodulban található közvetlen módszerekkel. A közvetlen metódusok implementálva vannak az eszközön, majd meghívhatók a felhőből. Az IoT Edge-ügynök közvetlen metódusokat tartalmaz, amelyekkel távolról monitorozhatja és kezelheti az IoT Edge-eszközöket.

A közvetlen metódusokról, azok használatáról és a saját modulokban való implementálásukról további információt az IoT Hub közvetlen metódusainak ismertetése és meghívása című témakörben talál.

A közvetlen metódusok nevei a kis- és nagybetűket nem érzékenyen kezelik.

Ping

A pingelési módszer hasznos annak ellenőrzéséhez, hogy az IoT Edge fut-e egy eszközön, vagy hogy az eszköz nyitott kapcsolattal rendelkezik-e az IoT Hubhoz. Ezzel a közvetlen módszerrel pingelheti az IoT Edge-ügynököt, és lekérheti annak állapotát. A sikeres ping üres hasznos adatokat és "állapotot" ad vissza: 200.

Példa:

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

Az Azure Portalon hívja meg a metódust a metódus nevével ping és egy üres JSON hasznos adattal {}.

Képernyőkép a közvetlen metódus pingelésének meghívásáról az Azure Portalon.

Modul újraindítása

A RestartModule metódus lehetővé teszi az IoT Edge-eszközön futó modulok távoli kezelését. Ha egy modul hibás állapotot vagy egyéb nem megfelelő működést jelez, az IoT Edge-ügynök újraindításához aktiválhatja azt. A sikeres újraindítási parancs üres hasznos adatokat és "állapotot" ad vissza: 200.

A RestartModule metódus az IoT Edge 1.0.9-es és újabb verziójában érhető el.

Tipp.

Az IoT Edge hibaelhárítási oldala az Azure Portalon egyszerűsített felületet biztosít a modulok újraindításához. További információ: IoT Edge-eszközök monitorozása és hibaelhárítása az Azure Portalról.

Az RestartModule közvetlen metódust bármely IoT Edge-eszközön futó modulon használhatja, beleértve magát az edgeAgent modult is. Ha azonban ezt a közvetlen módszert használja az edgeAgent leállításához, nem fog sikeres eredményt kapni, mivel a kapcsolat megszakad a modul újraindítása közben.

Példa:

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

Az Azure Portalon hívja meg a metódust a metódus nevével RestartModule és a következő JSON hasznos adatokkal:

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

Képernyőkép a RestartModule közvetlen metódus meghívásáról az Azure Portalon.

Közvetlen diagnosztikai módszerek

  • GetModuleLogs: A modulnaplók beolvasása a közvetlen metódus válaszában.
  • UploadModuleLogs: Modulnaplók lekérése és feltöltése az Azure Blob Storage-ba.
  • UploadSupportBundle: A modulnaplók lekérése támogatási csomag használatával, és zip-fájl feltöltése az Azure Blob Storage-ba.
  • GetTaskStatus: Ellenőrizze a feltöltési naplók vagy a támogatási csomagkérelmek állapotát.

Ezek a közvetlen diagnosztikai módszerek az 1.0.10-es kiadástól érhetők el.

Következő lépések

Az IoT Edge-ügynök és az IoT Edge Hub-modul ikerpéldányainak tulajdonságai