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.