Dela via

Självstudie: Övervaka IoT Edge-enheter

  • Artikel

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

Viktigt!

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

Använd Azure Monitor-arbetsböcker för att övervaka hälsotillståndet och prestandan för dina Azure IoT Edge-distributioner.

I den här självstudien lär du dig att:

  • Förstå vilka mått som delas av IoT Edge-enheter och hur modulen för måttinsamlare hanterar dem.
  • Distribuera modulen för måttinsamlare till en IoT Edge-enhet.
  • Visa utvalda visualiseringar av måtten som samlats in från enheten.

Förutsättningar

En IoT Edge-enhet med modulen simulerad temperatursensor distribuerad till den. Om du inte har en enhet redo följer du stegen i Distribuera din första IoT Edge-modul till en virtuell Linux-enhet för att skapa en med hjälp av en virtuell dator.

Förstå IoT Edge-mått

Varje IoT Edge-enhet förlitar sig på två moduler, runtime-modulerna, som hanterar livscykeln och kommunikationen för alla andra moduler på en enhet. Dessa moduler kallas IoT Edge-agenten och IoT Edge-hubben. Mer information om dessa moduler finns i Förstå Azure IoT Edge-körningen och dess arkitektur.

Båda körningsmodulerna skapar mått som gör att du kan fjärrövervaka hur en IoT Edge-enhet eller dess enskilda moduler fungerar. IoT Edge-agenten rapporterar om tillståndet för enskilda moduler och värdenheten, så skapar mått som hur länge en modul har körts korrekt, eller mängden RAM-minne och procent av processorn som används på enheten. IoT Edge-hubben rapporterar om kommunikation på enheten, så skapar mått som det totala antalet meddelanden som skickas och tas emot, eller den tid det tar att lösa en direkt metod. En fullständig lista över tillgängliga mått finns i Åtkomst till inbyggda mått.

Dessa mått exponeras automatiskt av båda modulerna så att du kan skapa egna lösningar för att komma åt och rapportera om dessa mått. För att göra den här processen enklare tillhandahåller Microsoft modulen azureiotedge-metrics-collector som hanterar den här processen för dem som inte har eller vill ha en anpassad lösning. Modulen måttinsamlare samlar in mått från de två körningsmodulerna och andra moduler som du kanske vill övervaka och transporterar dem utanför enheten.

Modulen måttinsamlare fungerar som ett av två sätt att skicka dina mått till molnet. Det första alternativet, som vi använder i den här självstudien, är att skicka måtten direkt till Log Analytics. Det andra alternativet, som bara rekommenderas om dina nätverksprinciper kräver det, är att skicka måtten via IoT Hub och sedan konfigurera en väg för att skicka måttmeddelandena till Log Analytics. Hur som helst, när måtten finns på din Log Analytics-arbetsyta är de tillgängliga för visning via Azure Monitor-arbetsböcker.

Skapa en Log Analytics-arbetsyta

En Log Analytics-arbetsyta krävs för att samla in måttdata och tillhandahåller ett frågespråk och integrering med Azure Monitor så att du kan övervaka dina enheter.

  1. Logga in på Azure-portalen.

  2. Sök efter och välj Log Analytics-arbetsytor.

  3. Välj Skapa och följ sedan anvisningarna för att skapa en ny arbetsyta.

  4. När arbetsytan har skapats väljer du Gå till resurs.

  5. På huvudmenyn under Inställningar väljer du Agenter.

  6. Kopiera värdena för arbetsyte-ID och primärnyckel, som är tillgängliga under "Log Analytics-agentinstruktioner". Du använder dessa två värden senare i självstudien för att konfigurera modulen måttinsamlare för att skicka måtten till den här arbetsytan.

Hämta ditt resurs-ID för IoT Hub

När du konfigurerar modulen måttinsamlare ger du den Azure Resource Manager-resurs-ID:t för din IoT-hubb. Hämta det ID:t nu.

  1. Från Azure Portal navigerar du till din IoT-hubb.

  2. Välj Egenskaper under Inställningar på menyn till vänster.

  3. Kopiera värdet för resurs-ID. Det bör ha formatet /subscriptions/<subscription_id>/resourceGroups/<resource_group_name>/providers/Microsoft.Devices/IoTHubs/<iot_hub_name>.

Distribuera modulen för måttinsamlare

Distribuera modulen för måttinsamlare till varje enhet som du vill övervaka. Den körs på enheten som vilken annan modul som helst och bevakar dess tilldelade slutpunkter för mått som ska samlas in och skickas till molnet.

Följ de här stegen för att distribuera och konfigurera insamlarmodulen:

  1. Logga in på Azure Portal och gå till din IoT-hubb.

  2. På menyn till vänster väljer du Enheter under menyn Enhetshantering .

  3. Välj målenhetens enhets-ID i listan över IoT Edge-enheter för att öppna sidan med enhetsinformation.

  4. På den övre menyraden väljer du Ange moduler.

  5. Det första steget för att distribuera moduler från portalen är att deklarera vilka moduler som ska finnas på en enhet. Om du använder samma enhet som du skapade i snabbstarten bör du redan se SimulatedTemperatureSensor i listan. Om inte lägger du till det nu:

    1. I avsnittet IoT Edge-moduler väljer du Lägg till och sedan IoT Edge-modul.

    2. Uppdatera följande modulinställningar:

      Inställning Värde
      Namn på IoT-modul SimulatedTemperatureSensor
      URI för avbildning mcr.microsoft.com/azureiotedge-simulated-temperature-sensor:latest
      Omstartsprincip alltid
      Önskad status körs

    3. Välj Nästa: Vägar för att fortsätta konfigurera vägar.

    4. Lägg till en väg som skickar alla meddelanden från modulen för simulerad temperatur till IoT Hub.

      Inställning Värde
      Name SimulatedTemperatureSensorToIoTHub
      Värde FROM /messages/modules/SimulatedTemperatureSensor/* INTO $upstream

  6. Lägg till och konfigurera modulen för måttinsamlare:

    1. Välj Lägg till och välj sedan IoT Edge-modul.

    2. Sök efter och välj IoT Edge Metrics Collector.

    3. Uppdatera följande modulinställningar:

      Inställning Värde
      Namn på IoT-modul IoTEdgeMetricsCollector
      URI för avbildning mcr.microsoft.com/azureiotedge-metrics-collector:latest
      Omstartsprincip alltid
      Önskad status körs

    Om du vill använda en annan version eller arkitektur för modulen måttinsamlare hittar du de tillgängliga bilderna i Microsofts artefaktregister.

    1. Gå till fliken Miljövariabler .

    2. Lägg till följande miljövariabler för texttyp:

      Name Värde
      ResourceId Ditt IoT Hub-resurs-ID som du hämtade i ett tidigare avsnitt.
      UploadTarget AzureMonitor
      LogAnalyticsWorkspaceId Ditt Log Analytics-arbetsyte-ID som du hämtade i ett tidigare avsnitt.
      LogAnalyticsSharedKey Din Log Analytics-nyckel som du hämtade i ett tidigare avsnitt.

      Mer information om miljövariabler finns i Konfiguration av måttinsamlare.

    3. Tryck på Apply (Verkställ) för att spara ändringarna.

    Kommentar

    Om du vill att insamlaremodulen ska skicka måtten via IoT Hub lägger du till en väg till uppströms som liknar FROM /messages/modules/< FROM_MODULE_NAME >/* INTO $upstream. Men i den här självstudien skickar vi måtten direkt till Log Analytics. Därför behövs det inte.

  7. Välj Granska + skapa för att fortsätta till det sista steget för att distribuera moduler.

  8. Välj Skapa för att slutföra distributionen.

När du har slutfört moduldistributionen går du tillbaka till sidan med enhetsinformation där du kan se fyra moduler som anges som Angivna i Distribution. Det kan ta en stund innan alla fyra modulerna visas som Rapporterade av enhet, vilket innebär att de har startats och rapporterat sin status till IoT Hub. Uppdatera sidan för att se den senaste statusen.

Övervaka enhetens hälsotillstånd

Det kan ta upp till femton minuter innan arbetsböckerna för enhetsövervakning är redo att visas. När du har distribuerat modulen måttinsamlare börjar den skicka måttmeddelanden till Log Analytics där de är ordnade i en tabell. Resurs-ID:t för IoT Hub som du angav länkar måtten som matas in till den hubb som de tillhör. Därför kan de kurerade IoT Edge-arbetsböckerna hämta mått genom att köra frågor mot måtttabellen med hjälp av resurs-ID:t.

Azure Monitor innehåller tre standardarbetsboksmallar för IoT:

  • Arbetsboken Fleet View visar hälsotillståndet för enheter över flera IoT-resurser. Vyn gör det möjligt att konfigurera tröskelvärden för att fastställa enhetens hälsa och visar aggregeringar av primära mått per enhet.
  • Arbetsboken Enhetsinformation innehåller visualiseringar i tre kategorier: meddelanden, moduler och värd. Meddelandevyn visualiserar meddelandevägarna för en enhet och rapporterar om meddelandesystemets övergripande hälsa. Modulvyn visar hur de enskilda modulerna på en enhet fungerar. Värdvyn visar information om värdenheten, inklusive versionsinformation för värdkomponenter och resursanvändning.
  • Arbetsboken Aviseringar visar aviseringar för enheter över flera IoT-resurser.

Utforska översiktsvyn och hälsoögonblicksarbetsböckerna

Arbetsboken för vagnparksvyn visar alla dina enheter och låter dig välja specifika enheter för att visa deras hälsoögonblicksbilder. Använd följande steg för att utforska arbetsbokens visualiseringar:

  1. Gå tillbaka till din IoT Hub-sida i Azure Portal.

  2. Rulla nedåt på huvudmenyn för att hitta avsnittet Övervakning och välj Arbetsböcker.

    Välj arbetsböcker för att öppna galleriet för Azure Monitor-arbetsböcker.

  3. Välj arbetsboken Vy över flotta.

  4. Du bör se din enhet som kör modulen måttinsamlare. Enheten visas som felfri eller inte felfri.

  5. Välj enhetsnamnet för att visa detaljerade mått från enheten.

  6. I något av tidsdiagrammen använder du pilikonerna under X-axeln eller väljer diagrammet och drar markören för att ändra tidsintervallet.

    Skärmbild som visar hur du väljer och drar eller använder pilikonerna i ett diagram för att ändra tidsintervallet.

  7. Stäng arbetsboken för hälsoögonblicksbild. Välj Arbetsböcker från arbetsboken för vagnparksvyn för att återgå till galleriet för arbetsböcker.

Utforska arbetsboken med enhetsinformation

Arbetsboken med enhetsinformation visar prestandainformation för en enskild enhet. Använd följande steg för att utforska arbetsbokens visualiseringar:

  1. I arbetsboksgalleriet väljer du arbetsboken IoT Edge-enhetsinformation .

  2. Den första sidan som visas i arbetsboken för enhetsinformation är meddelandevyn med fliken routning markerad.

    Till vänster visar en tabell vägarna på enheten, ordnade efter slutpunkt. För vår enhet ser vi att den överordnade slutpunkten, som är den särskilda termen som används för routning till IoT Hub, tar emot meddelanden från temperatureOutput-utdata från modulen simulerad temperatursensor.

    Till höger håller ett diagram reda på antalet anslutna klienter över tid. Du kan välja och dra diagrammet för att ändra tidsintervallet.

    Välj meddelandevyn för att se status för kommunikation på enheten.

  3. Välj diagramfliken för att se en annan visualisering av vägarna. På grafsidan kan du dra och släppa de olika slutpunkterna för att ordna om diagrammet. Den här funktionen är användbar när du har många vägar att visualisera.

    Välj grafvyn för att se ett interaktivt diagram över enhetsvägarna.

  4. Fliken Hälsa rapporterar eventuella problem med meddelanden, till exempel borttagna meddelanden eller frånkopplade klienter.

  5. Välj modulvyn för att se status för alla moduler som distribuerats på enheten. Du kan välja var och en av modulerna för att se information om hur mycket processor och minne de använder.

    Välj modulvyn för att se statusen för varje modul som distribueras till enheten.

  6. Välj värdvyn för att se information om värdenheten, inklusive dess operativsystem, IoT Edge-daemonversionen och resursanvändning.

Visa modulloggar

När du har tittat på måtten för en enhet kanske du vill gå vidare och inspektera de enskilda modulerna. IoT Edge tillhandahåller felsökningsstöd i Azure Portal med en loggfunktion för livemoduler.

  1. I arbetsboken för enhetsinformation väljer du Felsöka live.

    Välj knappen Felsök live längst upp till höger i arbetsboken för enhetsinformation.

  2. Felsökningssidan öppnas i edgeAgent-loggarna från din IoT Edge-enhet. Om du har valt ett visst tidsintervall i arbetsboken för enhetsinformation skickas den inställningen vidare till felsökningssidan.

  3. Använd den nedrullningsbara menyn för att växla till loggarna för andra moduler som körs på enheten. Använd knappen Starta om för att starta om en modul.

    Använd den nedrullningsbara menyn för att visa loggarna för olika moduler och använd omstartsknappen för att starta om moduler.

Felsökningssidan kan också nås från en IoT Edge-enhets informationssida. Mer information finns i Felsöka IoT Edge-enheter från Azure Portal.

Nästa steg

När du fortsätter med resten av självstudierna behåller du modulen måttinsamlare på dina enheter och återgår till arbetsböckerna för att se hur informationen ändras när du lägger till mer komplexa moduler och routning.

Fortsätt till nästa självstudie där du konfigurerar utvecklarmiljön för att börja distribuera anpassade moduler till dina enheter.

Utveckla Azure IoT Edge-moduler med Hjälp av Visual Studio Code