Egyéni metrikák hozzáadása

A következőkre vonatkozik: IoT Edge 1.5 IoT Edge 1.4

Fontos

Az IoT Edge 1.5 LTS és az IoT Edge 1.4 LTS támogatott kiadások. Az IoT Edge 1.4 LTS 2024. november 12-én megszűnik. Ha egy korábbi kiadáson dolgozik, olvassa el az IoT Edge frissítése című témakört.

Gyűjtsön egyéni metrikákat az IoT Edge-modulokból a rendszermodulok által biztosított beépített metrikák mellett. A beépített metrikák kiváló alapkonfigurációs láthatóságot biztosítanak az üzembe helyezés állapotához. A kép befejezéséhez azonban szükség lehet további információkra az egyéni moduloktól. Az egyéni modulok a megfelelő Prometheus ügyfélkódtár használatával integrálhatók a monitorozási megoldásba metrikák kibocsátásához. Ez a további információ lehetővé teszi a követelményekre specializált új nézeteket vagy riasztásokat.

Mintamodulok adattára

Az azure-samples adattárban példákat talál a metrikák kibocsátására szolgáló egyéni modulokra. Még ha a választott nyelven még nem érhető el minta, az általános megközelítés segíthet.

Elnevezési konvenciók

Általános útmutatásért tekintse meg a Prometheus docs ajánlott eljárásait . Az alábbi további javaslatok hasznosak lehetnek az IoT Edge-forgatókönyvekhez.

• Adja meg a modul nevét a metrikanév elején, hogy egyértelmű legyen, melyik modul bocsátotta ki a metrikát.

• Minden metrika tartalmazza az IoT Hub vagy az IoT Central-alkalmazás nevét, az IoT Edge-eszközazonosítót és a modulazonosítót címkékként (más néven címkék/dimenziói). Ez az információ környezeti változóként érhető el az IoT Edge-ügynök által indított minden modulhoz. Ezt a megközelítést a minta-adattárban található példa szemlélteti . E kontextus nélkül lehetetlen egy adott metrikaértéket egy adott eszközhöz társítani.

• Adjon meg egy példányazonosítót a címkékben. A példányazonosító lehet bármilyen egyedi azonosító, például egy GUID , amely a modul indításakor jön létre. A példányazonosító adatai segíthetnek összeegyeztetni a modul újraindítását a modul metrikáinak háttérrendszerbeli feldolgozásakor.

A metrikák gyűjtőjének konfigurálása egyéni metrikák gyűjtésére

Miután egy egyéni modul metrikákat bocsát ki, a következő lépés a metrikák gyűjtő moduljának konfigurálása az egyéni metrikák gyűjtésére és átvitelére.

A környezeti változót MetricsEndpointsCSV frissíteni kell, hogy tartalmazza az egyéni modul metrikák végpontjának URL-címét. A környezeti változó frissítésekor mindenképpen vegye fel a rendszermodul végpontjait a metrikagyűjtő konfigurációs példájában látható módon.

Feljegyzés

Alapértelmezés szerint az egyéni modul metrikák végpontját nem kell egy gazdagépportra leképezni, hogy a metrikák gyűjtője elérhesse azt. Ha nincs explicit módon felülírva, Linuxon mindkét modul egy azure-iot-edge nevű, felhasználó által definiált Docker-hídhálózaton indul el.

A felhasználó által definiált Docker-hálózatok tartalmaznak egy alapértelmezett DNS-feloldót, amely lehetővé teszi a modulközi kommunikációt modulnevek használatával. Ha például egy modul1 nevű egyéni modul metrikákat bocsát ki a 9600-ás http-porton az elérési út /metrikák között, a gyűjtőt úgy kell konfigurálni, hogy a végpontról http://module1:9600/metricsgyűjtsön.

Futtassa a következő parancsot az IoT Edge-eszközön annak ellenőrzéséhez, hogy egy egyéni modul által a 9600-at futtató http-porton kibocsátott metrikák elérhetők-e a elérési úton/metrikákban:

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

Egyéni vizualizációk hozzáadása

Miután egyéni metrikákat kapott a Log Analyticsben, egyéni vizualizációkat és riasztásokat hozhat létre. A monitorozási munkafüzetek bővíthetők lekérdezésalapú vizualizációk hozzáadásához.

Minden metrika az IoT Hub vagy az IoT Central-alkalmazás erőforrás-azonosítójával van társítva. Ezért ellenőrizheti, hogy az egyéni metrikák megfelelően ömlöttek-e be a társított IoT Hub vagy IoT Central-alkalmazás Naplók oldaláról a háttérbeli Log Analytics-munkaterület helyett. Ezt az egyszerű KQL-lekérdezést használva ellenőrizze a következőt:

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

Miután megerősítette a betöltést, létrehozhat egy új munkafüzetet, vagy bővíthet egy meglévő munkafüzetet. Útmutatóként használhatja a válogatott IoT Edge-munkafüzetekből származó munkafüzeteket és lekérdezéseket.

Ha elégedett az eredménnyel, megoszthatja a munkafüzetet a csapatával, vagy programozott módon helyezheti üzembe őket a szervezet erőforrás-üzembe helyezésének részeként.

Következő lépések

További metrikák vizualizációs lehetőségeinek megismerése válogatott munkafüzetekkel.