Přidání vlastních metrik

  • Článek

Platí pro:Značka zaškrtnutí IoT Edge 1.5 IoT Edge 1.5 Značka zaškrtnutí IoT Edge 1.4 IoT Edge 1.4

Důležité

Podporované verze ioT Edge 1.5 LTS a IoT Edge 1.4 LTS. IoT Edge 1.4 LTS je konec životnosti 12. listopadu 2024. Pokud používáte starší verzi, podívejte se na článek Aktualizace IoT Edge.

Shromážděte vlastní metriky z modulů IoT Edge kromě integrovaných metrik, které poskytují systémové moduly. Integrované metriky poskytují skvělý přehled o stavu nasazení. K dokončení obrázku však můžete vyžadovat další informace z vlastních modulů. Vlastní moduly je možné integrovat do řešení monitorování pomocí příslušné klientské knihovny Prometheus k generování metrik. Tyto další informace můžou povolit nová zobrazení nebo výstrahy specializované na vaše požadavky.

Úložiště ukázkových modulů

Příklady vlastních modulů instrumentovaných k generování metrik najdete v úložišti azure-samples. I když ještě není k dispozici ukázka ve vašem jazyce, může vám pomoct obecný přístup.

Zásady vytváření názvů

Obecné pokyny najdete v osvědčených postupech z dokumentace k Prometheus. Následující další doporučení můžou být užitečná pro scénáře IoT Edge.

  • Zahrňte název modulu na začátek názvu metriky, aby bylo jasné, který modul metriku vygeneroval.

  • Do každé metriky zahrňte název centra IoT Hub nebo název aplikace IoT Central, ID zařízení IoT Edge a ID modulu (označované také jako dimenze značek/). Tyto informace jsou k dispozici jako proměnné prostředí pro každý modul spuštěný agentem IoT Edge. Tento přístup ukazuje příklad v úložišti ukázek. Bez tohoto kontextu není možné přidružit danou hodnotu metriky k určitému zařízení.

  • Do popisků uveďte ID instance. ID instance může být jakékoli jedinečné ID, jako je identifikátor GUID , který se vygeneruje během spouštění modulu. Informace o ID instance můžou pomoct sloučit restartování modulu při zpracování metrik modulu v back-endu.

Konfigurace kolektoru metrik pro shromažďování vlastních metrik

Jakmile vlastní modul generuje metriky, dalším krokem je konfigurace modulu kolektoru metrik pro shromažďování a přenos vlastních metrik.

Proměnná MetricsEndpointsCSV prostředí se musí aktualizovat tak, aby zahrnovala adresu URL koncového bodu metriky vlastního modulu. Při aktualizaci proměnné prostředí nezapomeňte zahrnout koncové body systémového modulu, jak je znázorněno v příkladu konfigurace kolektoru metrik.

Poznámka:

Ve výchozím nastavení nemusí být koncový bod metrik vlastního modulu namapovaný na port hostitele, aby k němu kolektor metrik mohl přistupovat. Pokud explicitně nepřepíšete, v Linuxu se oba moduly spustí v uživatelem definované síti mostu Docker s názvem azure-iot-edge.

Uživatelem definované sítě Dockeru zahrnují výchozí překladač DNS, který umožňuje komunikaci mezi moduly pomocí názvů modulů (kontejneru). Pokud například vlastní modul s názvem module1 vysílá metriky na portu HTTP 9600 na cestě /metrics, měl by být kolektor nakonfigurovaný tak, aby shromažďoval z koncového bodu http://module1:9600/metrics.

Spuštěním následujícího příkazu na zařízení IoT Edge otestujte, jestli jsou metriky generované vlastním modulem na portu HTTP 9600 na cestě /metriky přístupné:

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

Přidání vlastních vizualizací

Jakmile dostáváte vlastní metriky v Log Analytics, můžete vytvářet vlastní vizualizace a upozornění. Sešity monitorování je možné rozšířit o přidání vizualizací založených na dotazech.

Každá metrika je přidružená k ID prostředku centra IoT nebo aplikace IoT Central. Proto můžete zkontrolovat, jestli se vaše vlastní metriky správně ingestují ze stránky Protokolů přidružené aplikace IoT Hub nebo IoT Central místo pracovního prostoru služby Log Analytics. K ověření použijte tento základní dotaz KQL:

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

Po potvrzení příjmu dat můžete vytvořit nový sešit nebo rozšířit existující sešit. Jako vodítko používejte dokumenty a dotazy sešitů ze kurátorovaných sešitů IoT Edge.

Až budete s výsledky spokojení, můžete sešit sdílet s týmem nebo ho nasadit programově jako součást nasazení prostředků vaší organizace.

Další kroky

Prozkoumejte další možnosti vizualizace metrik pomocí kurátorovaných sešitů.