Lägga till anpassade mått

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.

Samla in anpassade mått från dina IoT Edge-moduler utöver de inbyggda mått som systemmodulerna tillhandahåller. De inbyggda måtten ger bra baslinjesynlighet i distributionshälsan. Du kan dock behöva ytterligare information från anpassade moduler för att slutföra bilden. Anpassade moduler kan integreras i din övervakningslösning med hjälp av lämpligt Prometheus-klientbibliotek för att generera mått. Den här ytterligare informationen kan aktivera nya vyer eller aviseringar som är specialiserade på dina behov.

Lagringsplats för exempelmoduler

Se lagringsplatsen azure-samples för exempel på anpassade moduler som har instrumenterats för att generera mått. Även om ett exempel på valfritt språk ännu inte är tillgängligt kan den allmänna metoden hjälpa dig.

Namngivningskonventioner

Mer allmän vägledning finns i metodtipsen i Prometheus-dokumenten. Följande ytterligare rekommendationer kan vara till hjälp för IoT Edge-scenarier.

• Ta med modulnamnet i början av måttnamnet för att klargöra vilken modul som har genererat måttet.

• Inkludera IoT Hub-namnet eller IoT Central-programnamnet, IoT Edge-enhets-ID och modul-ID som etiketter (kallas även taggar/för dimensioner) i varje mått. Den här informationen är tillgänglig som miljövariabler för varje modul som startas av IoT Edge-agenten. Metoden visas i exemplet i exempellagringsplatsen. Utan den här kontexten är det omöjligt att associera ett visst måttvärde till en viss enhet.

• Inkludera ett instans-ID i etiketterna. Ett instans-ID kan vara ett unikt ID som ett GUID som genereras under modulstarten. Information om instans-ID kan hjälpa dig att stämma av omstarter av modulen när du bearbetar en moduls mått i serverdelen.

Konfigurera måttinsamlaren för att samla in anpassade mått

När en anpassad modul genererar mått är nästa steg att konfigurera modulen metrics-collector för att samla in och transportera anpassade mått.

Miljövariabeln MetricsEndpointsCSV måste uppdateras för att inkludera URL:en för den anpassade modulens måttslutpunkt. När du uppdaterar miljövariabeln måste du ta med systemmodulens slutpunkter enligt konfigurationsexemplet för måttinsamlaren.

Kommentar

Som standard behöver inte en anpassad moduls måttslutpunkt mappas till en värdport så att måttinsamlaren kan komma åt den. Om de inte uttryckligen åsidosätts i Linux startas båda modulerna i ett användardefinierat Docker-bryggnätverk med namnet azure-iot-edge.

Användardefinierade Docker-nätverk innehåller en standard-DNS-matchare som tillåter kommunikation mellan moduler med hjälp av modulnamn (container). Om till exempel en anpassad modul med namnet module1 genererar mått på http-port 9600 vid sökvägen /mått, bör insamlaren konfigureras för att samla in från slutpunkten http://module1:9600/metrics.

Kör följande kommando på IoT Edge-enheten för att testa om mått som genereras av en anpassad modul på http-port 9600 vid sökväg /mått är tillgängliga:

sudo docker exec replace-with-metrics-collector-module-name curl http://replace-with-custom-module-name:9600/metrics

Lägga till anpassade visualiseringar

När du får anpassade mått i Log Analytics kan du skapa anpassade visualiseringar och aviseringar. Övervakningsarbetsböckerna kan utökas för att lägga till frågebaserade visualiseringar.

Varje mått är associerat med resurs-ID:t för IoT-hubben eller IoT Central-programmet. Därför kan du kontrollera om dina anpassade mått matas in korrekt från sidan Loggar i det associerade IoT-hubben eller IoT Central-programmet i stället för log analytics-arbetsytan. Använd den här grundläggande KQL-frågan för att verifiera:

InsightsMetrics
| where Name == 'replace-with-custom-metric-name'

När du har bekräftat inmatningen kan du antingen skapa en ny arbetsbok eller utöka en befintlig arbetsbok. Använd dokument och frågor för arbetsböcker från de kurerade IoT Edge-arbetsböckerna som en guide.

När du är nöjd med resultaten kan du dela arbetsboken med ditt team eller distribuera dem programmatiskt som en del av organisationens resursdistributioner.

Nästa steg

Utforska ytterligare visualiseringsalternativ för mått med utvalda arbetsböcker.