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 IoT Edge 1.4 pipa IoT Edge 1.4

Fontos

Az IoT Edge 1.5 LTS és az IoT Edge 1.4 LTS támogatott kiadások. 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