Aangepaste metrische gegevens toevoegen
Van toepassing op:
IoT Edge 1.5 IoT Edge 1.4
Belangrijk
IoT Edge 1.5 LTS en IoT Edge 1.4 LTS worden ondersteund releases. IoT Edge 1.4 LTS eindigt op 12 november 2024. Raadpleeg IoT Edge bijwerken als u een eerdere versie hebt.
Verzamel aangepaste metrische gegevens uit uw IoT Edge-modules naast de ingebouwde metrische gegevens die de systeemmodules bieden. De ingebouwde metrische gegevens bieden een uitstekend inzicht in de status van uw implementatie. Mogelijk hebt u echter aanvullende informatie van aangepaste modules nodig om de afbeelding te voltooien. Aangepaste modules kunnen worden geïntegreerd in uw bewakingsoplossing met behulp van de juiste Prometheus-clientbibliotheek om metrische gegevens te verzenden. Met deze aanvullende informatie kunt u nieuwe weergaven of waarschuwingen inschakelen die speciaal zijn voor uw vereisten.
Opslagplaats met voorbeeldmodules
Zie de opslagplaats azure-samples voor voorbeelden van aangepaste modules die zijn geïnstrueerd om metrische gegevens te verzenden. Zelfs als een voorbeeld in uw keuzetaal nog niet beschikbaar is, kan de algemene benadering u helpen.
Naamconventies
Raadpleeg de best practices van Prometheus-documenten voor algemene richtlijnen. De volgende aanvullende aanbevelingen kunnen nuttig zijn voor IoT Edge-scenario's.
Neem de modulenaam aan het begin van de metrische naam op om duidelijk te maken welke module de metrische gegevens heeft verzonden.
Neem de naam van de IoT-hub of de naam van de IoT Central-toepassing, de ioT Edge-apparaat-id en de module-id op als labels (ook wel tagsdimensies/ genoemd) in elke metrische waarde. Deze informatie is beschikbaar als omgevingsvariabelen voor elke module die is gestart door de IoT Edge-agent. De benadering wordt gedemonstreerd door het voorbeeld in de opslagplaats met voorbeelden. Zonder deze context is het onmogelijk om een bepaalde metrische waarde aan een bepaald apparaat te koppelen.
Neem een exemplaar-id op in de labels. Een exemplaar-id kan elke unieke id zijn, zoals een GUID die wordt gegenereerd tijdens het opstarten van de module. Informatie over exemplaar-id's kan helpen bij het opnieuw opstarten van de module bij het verwerken van de metrische gegevens van een module in de back-end.
De collector voor metrische gegevens configureren om aangepaste metrische gegevens te verzamelen
Zodra een aangepaste module metrische gegevens verzendt, is de volgende stap het configureren van de module metrics-collector om aangepaste metrische gegevens te verzamelen en te transporteren.
De omgevingsvariabele MetricsEndpointsCSV moet worden bijgewerkt om de URL van het eindpunt voor metrische gegevens van de aangepaste module op te nemen. Wanneer u de omgevingsvariabele bijwerkt, moet u de eindpunten van de systeemmodule opnemen, zoals wordt weergegeven in het configuratievoorbeeld van de metrische collector.
Notitie
Standaard hoeft het eindpunt voor metrische gegevens van een aangepaste module niet aan een hostpoort te worden toegewezen, zodat de collector voor metrische gegevens toegang tot deze gegevens kan krijgen. Tenzij deze expliciet wordt overschreven, worden beide modules in Linux gestart op een door de gebruiker gedefinieerd Docker Bridge-netwerk met de naam azure-iot-edge.
Door de gebruiker gedefinieerde Docker-netwerken bevatten een standaard-DNS-resolver waarmee communicatie tussen modules mogelijk is met behulp van modulenamen (container). Als een aangepaste module met de naam module1 bijvoorbeeld metrische gegevens verzendt op http-poort 9600 bij pad /metrische gegevens, moet de collector worden geconfigureerd voor het verzamelen van eindpunten http://module1:9600/metrics.
Voer de volgende opdracht uit op het IoT Edge-apparaat om te testen of metrische gegevens die zijn verzonden door een aangepaste module op http-poort 9600 op pad /metrische gegevens toegankelijk zijn:
sudo docker exec replace-with-metrics-collector-module-name curl http://replace-with-custom-module-name:9600/metrics
Aangepaste visualisaties toevoegen
Zodra u aangepaste metrische gegevens in Log Analytics ontvangt, kunt u aangepaste visualisaties en waarschuwingen maken. De bewakingswerkmappen kunnen worden uitgebreid om visualisaties met query's toe te voegen.
Elke metriek is gekoppeld aan de resource-id van de IoT-hub of de IoT Central-toepassing. Daarom kunt u controleren of uw aangepaste metrische gegevens correct zijn opgenomen op de pagina Logboeken van de bijbehorende IoT Hub of IoT Central-toepassing in plaats van de log analytics-werkruimte. Gebruik deze eenvoudige KQL-query om het volgende te controleren:
InsightsMetrics
| where Name == 'replace-with-custom-metric-name'
Zodra u de opname hebt bevestigd, kunt u een nieuwe werkmap maken of een bestaande werkmap uitbreiden. Gebruik werkmappen en query's uit de gecureerde IoT Edge-werkmappen als richtlijn.
Wanneer u tevreden bent met de resultaten, kunt u de werkmap delen met uw team of deze programmatisch implementeren als onderdeel van de resource-implementaties van uw organisatie.
Volgende stappen
Verken aanvullende visualisatieopties voor metrische gegevens met gecureerde werkmappen.