Dela via

Kommunicera med edgeAgent med inbyggda direktmetoder

Gäller för:Bockmarkering för IoT Edge 1.5 IoT Edge 1.5

Viktigt!

IoT Edge 1.5 LTS är den version som stöds. IoT Edge 1.4 LTS upphör från och med den 12 november 2024. Om du har en tidigare version läser du Uppdatera IoT Edge.

Övervaka och hantera IoT Edge-distributioner med hjälp av direktmetoderna i IoT Edge-agentmodulen. Direktmetoder implementeras på enheten och kan anropas från molnet. IoT Edge-agenten innehåller direkta metoder för att fjärrövervaka och hantera IoT Edge-enheter.

Mer information om direkta metoder, hur du använder dem och hur du implementerar dem i dina egna moduler finns i Förstå och anropa direktmetoder från IoT Hub.

Namnen på dessa direkta metoder är skiftlägesokänsliga.

Ping

Ping-metoden kontrollerar om IoT Edge körs på en enhet eller om enheten har en öppen anslutning till IoT Hub. Använd den här metoden för att pinga IoT Edge-agenten och kontrollera dess status. En lyckad ping returnerar en tom nyttolast och en "status": 200.

Till exempel:

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

I Azure-portalen anropar du metoden med hjälp av metodnamnet ping och en tom JSON-nyttolast {}.

Skärmbild av hur du anropar direktmetods-ping i Azure-portalen.

Starta om modulen

Med metoden RestartModule kan du fjärrhantera moduler som körs på en IoT Edge-enhet. Om en modul rapporterar ett feltillstånd eller ohälsosamt beteende ska du aktivera IoT Edge-agenten för att starta om den. Ett lyckat omstartskommando returnerar en tom nyttolast med "status": 200.

Metoden RestartModule är tillgänglig från och med IoT Edge version 1.0.9.

Dricks

IoT Edge-felsökningssidan i Azure-portalen förenklar omstart av moduler. Mer information finns i Övervaka och felsöka IoT Edge-enheter från Azure Portal.

Använd direct-metoden RestartModule på valfri modul som körs på en IoT Edge-enhet, inklusive edgeAgent-modulen. Om du använder den här direktmetoden för att stänga av edgeAgent får du inget lyckat resultat eftersom anslutningen avbryts under modulomstarten.

Till exempel:

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

I Azure-portalen använder du metodnamnet RestartModule med följande JSON-nyttolast:

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

Skärmbild av att anropa direktmetoden RestartModule i Azure-portalen.

Diagnostikdirigeringsmetoder

  • GetModuleLogs: Hämta modulloggar som svar på direktmetoden.
  • UploadModuleLogs: Hämta modulloggar och ladda upp till Azure Blob Storage.
  • UploadSupportBundle: Hämta modulloggar med ett supportpaket och ladda upp en zip-fil till Azure Blob Storage.
  • GetTaskStatus: Kontrollera statusen för en begäran om uppladdningsloggar eller supportpaket.

Dessa diagnostikdirigeringsmetoder är tillgängliga från och med 1.0.10-versionen.

Nästa steg

Egenskaper för IoT Edge-agenten och IoT Edge-hubbmodultvillingar