Självstudie: Övervaka IoT Edge-enheter

Gäller för: IoT Edge 1.5

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örutsättningar

Du behöver en IoT Edge-enhet med den simulerade temperatursensormodulen distribuerad. 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, så kallade runtime-moduler, som hanterar livscykeln och kommunikationen för alla andra moduler på en enhet. Dessa moduler är 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 presterar. IoT Edge-agenten rapporterar om tillståndet för enskilda moduler och värdenheten, så den skapar mått som hur länge en modul körs korrekt eller mängden RAM-minne och procentandel av processorn som används på enheten. IoT Edge-hubben rapporterar om kommunikation på enheten, så den skapar mått som det totala antalet meddelanden som skickas och tas emot eller den tid det tar att lösa en direktmetod. En fullständig lista över tillgängliga mått finns i Åtkomst till inbyggda mått.

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

Modulen måttinsamlare skickar dina mått till molnet på ett av två sätt. Det första alternativet, som används i den här självstudien, skickar måtten direkt till Log Analytics. Det andra alternativet rekommenderas endast om nätverksprinciperna kräver det. Den skickar måtten via IoT Hub och konfigurerar sedan en väg för att skicka måttmeddelandena till Log Analytics. Hur som helst, när måtten finns på Log Analytics-arbetsytan kan du visa dem via Azure Monitor-arbetsböcker.

Skapa en Log Analytics-arbetsyta

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

1. Logga in på Azure-portalen.

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

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

4. När arbetsområdet är klart väljer du Gå till resurs.

5. I huvudmenyn under Inställningar väljer du Agenter.

6. Kopiera värdena för arbetsyte-ID och primärnyckel under Log Analytics-agentinstruktioner. Du använder dessa värden senare i handledningen för att konfigurera mätinsamlaren för att skicka mått till den här arbetsytan.

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

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

1. Gå till din IoT-hubb i Azure-portalen.

2. Under Inställningar väljer du Egenskaper.

3. Kopiera värdet för resurs-ID. Formatet är /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å sedan till din IoT-hubb.

1.Under Enhetshantering väljer du Enheter.

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

2. I menyraden väljer du Ange moduler.

3. Det första steget för att distribuera moduler från portalen är att deklarera vilka moduler som finns på en enhet. Om du använder samma enhet som du skapade i snabbstarten visas redan 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
      Namn	SimulatedTemperatureSensorToIoTHub
      Värde	FROM /messages/modules/SimulatedTemperatureSensor/* INTO $upstream

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

   1. Välj Lägg till och 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 tillgängliga avbildningar i Microsoft Artifact Registry.

   1. Gå till fliken Miljövariabler .

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

      Namn	Värde
      ResourceId (på engelska)	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 skicka mått via IoT Hub lägger du till en väg till uppströms som liknar FROM /messages/modules/< FROM_MODULE_NAME >/* INTO $upstream. I denna handledning skickas mått direkt till Log Analytics, så denna väg behövs inte.

5. Välj Granska + skapa för att gå vidare till sista steget av att distribuera moduler.

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

När du har distribuerat modulerna går du tillbaka till sidan med enhetsinformation, där du ser 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 startat 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 15 minuter innan arbetsböckerna för enhetsövervakning är klara 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 anger länkar de inmatade måtten till rätt hubb. Därför hämtar de kurerade IoT Edge-arbetsböckerna mått genom att köra frågor mot måtttabellen med 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. I vyn kan du ange tröskelvärden för enhetens hälsotillstånd och visa aggregeringar av primära mått per enhet.
• Arbetsboken Enhetsinformation visar visualiseringar för 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.
• Arbetsboksvyn Aviseringar visar aviseringar för enheter över flera IoT-resurser.

Utforska översiktsvyn och hälsoögonblicksarbetsböckerna

Arbetsboken för fordonsvyn visar alla dina enheter och låter dig välja specifika enheter för att visa deras hälsotillstånd. Följ de här stegen för att utforska arbetsbokens visualiseringar:

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

2. I huvudmenyn rullar du ned till avsnittet Övervakning och väljer Arbetsböcker.

   

3. Välj arbetsboken Vy över flotta.

4. Du ser 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.

6. I ett tidsdiagram använder du pilikonerna under X-axeln eller väljer diagrammet och drar markören för att ändra tidsintervallet.

   

7. Stäng arbetsboken för hälsoögonblicksbild. I arbetsboken för vagnparksvyn väljer du Arbetsböcker för att återgå till arbetsboksgalleriet.

Utforska arbetsboken med enhetsinformation

Arbetsboken med enhetsinformation visar prestandainformation för en enskild enhet. Följ de här stegen för att utforska arbetsbokens visualiseringar:

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

2. Den första sidan 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 den här enheten tar den överordnade slutpunkten, som är termen för routning till IoT Hub, emot meddelanden från temperatureOutput-utdata från modulen simulerad temperatursensor.

   Till höger visar ett diagram antalet anslutna klienter över tid. Välj och dra diagrammet för att ändra tidsintervallet.

   

3. Välj diagramfliken för att se en annan visualisering av vägarna. På grafsidan drar och släpper du slutpunkterna för att ordna om diagrammet. Den här funktionen hjälper dig när du har många vägar att visualisera.

   

4. Fliken Hälsa visar 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. Välj en modul om du vill se information om processor- och minnesanvändningen.

   

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

Visa modulloggar

När du har visat 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 med enhetsinformation väljer du Felsöka live.

   

2. Felsökningssidan öppnas i edgeAgent-loggarna från din IoT Edge-enhet. Om du väljer ett visst tidsintervall i arbetsboken för enhetsinformation går 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 och använd knappen Starta om för att starta om en modul.

   

Du kan också komma åt felsökningssidan 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 går igenom resten av självstudierna behåller du modulen måttinsamlare på dina enheter och återgår till dessa arbetsböcker för att se hur informationen ändras när du lägger till mer komplexa moduler och routning.

Gå till nästa handledning för att konfigurera din utvecklarmiljö och börja distribuera dina anpassade moduler till dina enheter.