Självstudie: Övervaka IoT Edge-enheter

Gäller för: IoT Edge 1.5 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-agentenoch 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 Agenthantering.

6. Kopiera värdena för Arbetsyte-ID och Primärnyckel. 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-portalen går 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-portalen 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 för att öppna distributionssidan för trestegsmoduler.

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. Välj Lägg till och välj sedan Marketplace-modul på den nedrullningsbara menyn.

   2. Sök efter och välj SimulatedTemperatureSensor.

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

   1. Välj Lägg till och välj sedan Marketplace-modul på den nedrullningsbara menyn.

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

   3. Välj modulen för måttinsamlare i listan över moduler för att öppna sidan med konfigurationsinformation.

   4. Gå till fliken Miljövariabler .

   5. Uppdatera följande värden:

      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.

   6. Ta bort miljövariabeln OtherConfig, som är en platshållare för extra konfigurationsalternativ som du kanske vill lägga till i framtiden. Det är inte nödvändigt för den här självstudien.

   7. Spara ändringarna genom att välja Uppdatera .

7. Välj Nästa: Vägar för att fortsätta till det andra steget för att distribuera moduler.

8. Portalen lägger automatiskt till en väg för måttinsamlaren. Du skulle använda den här vägen om du konfigurerade insamlingsmodulen för att skicka måtten via IoT Hub, men i den här självstudien skickar vi måtten direkt till Log Analytics så att vi inte behöver det. Ta bort vägen FromMetricsCollectorToUpstream.

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

10. 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-portalen.

2. Rulla nedåt på huvudmenyn för att hitta avsnittet Övervakning och välj 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 klickar på diagrammet och drar markören 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 klicka och dra diagrammet för att ändra tidsintervallet.

   

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.

   

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.

   

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-portalen med en loggfunktion för livemoduler.

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

   

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.

   

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-portalen.

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