Monitorozási Azure IoT Hub referenciája

Cikk
06/01/2023

Az Azure Monitorozás használatának első lépéseiért lásd: Monitorozási Azure IoT Hub, amelyből megtudhatja, hogyan gyűjthet és elemezhet monitorozási adatokat Azure IoT Hub.

Ez a cikk az Azure monitorozás implementálásának referenciája.

A referenciacikk főbb szakaszai:

Metrikák: IoT Hub platformmetrikák listája témakör szerint
Metrikadimenziók: az útválasztás és az Event Grid-metrikák dimenziói
Erőforrásnaplók: a Azure IoT Hub gyűjtött kategóriatípusok és sémák szerinti naplók
Azure Monitor-naplók táblázatai: az Azure Monitor-naplók Kusto-tábláinak ismertetése

Vagy lépjen közvetlenül az Azure Monitor naplótáblájának referenciájára.

Mérőszámok

Ez a szakasz a Azure IoT Hub automatikusan gyűjtött platformmetrikáit sorolja fel. A IoT Hub metrikák erőforrás-szolgáltatói névtere a Microsoft.Devices, a Névtér típus pedig az IoTHubs.

Az alábbi alszakaszok a IoT Hub platformmetrikákat általános kategóriák szerint jelenítik meg, és a metrikákat a Azure Portal hozzárendelt megjelenítendő nevük alapján sorolják fel.

Egyetlen táblát is találhat, amely az Azure Monitor dokumentációjában megtalálja az összes IoT Hub platformmetrikát metrikanév alapján a Microsoft.Devices/IotHubs területen. Ez a táblázat nem biztosít minden információt, például a jelen cikkben elérhető egyes metrikák támogatott összesítéseit .

A más Azure-szolgáltatások által támogatott metrikákkal kapcsolatos további információkért lásd: Támogatott metrikák az Azure Monitorral.

A szakasz témakörei

Válasszon ki egy témakört, amely az ezen az oldalon található információkra ugrik.

Támogatott összesítések
Felhőből eszközre irányuló parancsmetrikák
Felhőből eszközre irányuló közvetlen metódusok metrikái
Felhőből eszközre irányuló ikerműveleti metrikák
Konfigurációs metrikák
Napi kvótametrikák
Eszközmetrikák
Eszköztelemetria-metrikák
Ikereszközök és felhők között végzett ikerműveleti metrikák
Event Grid-metrikák
Feladatok metrikái
Útválasztási metrikák
Iker lekérdezési metrikák

Támogatott összesítések

Az egyes táblák Aggregációtípus oszlopa megfelel annak az alapértelmezett összesítésnek, amelyet akkor használunk, amikor a metrika egy diagramhoz vagy riasztáshoz van kiválasztva.

A metrikák összesítését bemutató képernyőkép

A legtöbb metrika esetében az összes összesítési típus érvényes; a Darabszám oszlopértékkel rendelkező számlálómetrikák esetében azonban csak néhány aggregáció érvényes. A metrikák száma két típus egyike lehet:

Az egypontos számmetrikák esetében IoT Hub minden alkalommal regisztrál egy adatpontot (lényegében egy 1-et), amikor a mért művelet megtörténik. Az Azure Monitor ezután összegzi ezeket az adatpontokat a megadott részletesség alapján. Az egypontos metrikák közé tartoznak például az elküldött telemetriai üzenetek és a C2D-üzenetek kézbesítése. Ezeknél a metrikáknál az egyetlen releváns összesítési típus a Total (Sum). A portálon kiválaszthatja a minimumot, a maximumot és az átlagot; ezek az értékek azonban mindig 1 lesznek.
Pillanatképszám-metrikák esetén IoT Hub a mért művelet során regisztrálja a teljes számot. Jelenleg három pillanatkép-metrikát bocsát ki a IoT Hub: A felhasznált üzenetek teljes száma, Az összes eszköz és a Csatlakoztatott eszközök. Mivel ezek a metrikák minden kibocsátásukkor "teljes" mennyiséget mutatnak be, a megadott részletesség alapján történő összegzésnek nincs értelme. Az Azure Monitor a metrikák összesítési típusának átlagát, minimumát és maximumát korlátozza.

Felhőből eszközre irányuló parancsmetrikák

Metrika megjelenítendő neve	Metrika	Unit (Egység)	Aggregáció típusa	Description	Dimenziók
A C2D-üzenetek lejártak	C2DMessagesExpired	Darabszám	Összesen	Lejárt felhőből eszközre irányuló üzenetek száma	None
A C2D-üzenetek kézbesítése befejeződött	c2d.commands.egress.complete.success	Darabszám	Összesen	Az eszköz által sikeresen teljesített felhőből eszközre irányuló üzenetszállítások száma	None
C2D-üzenetek elhagyva	c2d.commands.egress.abandon.success	Darabszám	Összesen	Az eszköz által elhagyott felhőből eszközre irányuló üzenetek száma	None
C2D-üzenetek elutasítva	c2d.commands.egress.reject.success	Darabszám	Összesen	Az eszköz által elutasított felhőből eszközre irányuló üzenetek száma	None

A Darabszám egységértékkel rendelkező metrikák esetében csak az összesítés (összeg) érvényes. A minimális, maximális és átlagos összesítések mindig 1-et adnak vissza. További információ: Támogatott összesítések.

Felhőből eszközre irányuló közvetlen metódusok metrikái

Metrika megjelenítendő neve	Metrika	Unit (Egység)	Aggregáció típusa	Description	Dimenziók
Sikertelen közvetlen metódushívások	c2d.methods.failure	Darabszám	Összesen	A sikertelen közvetlen metódushívások száma.	None
Közvetlen metódushívások kérésmérete	c2d.methods.requestSize	Bájt	Átlag	Az összes sikeres közvetlen metóduskérés száma.	None
Közvetlen metódushívások válaszmérete	c2d.methods.responseSize	Bájt	Átlag	Az összes sikeres közvetlen metódusválasz száma.	None
Sikeres közvetlen metódushívások	c2d.methods.success	Darabszám	Összesen	Az összes sikeres közvetlen metódushívás száma.	None

A Csak a darabszám (összeg) aggregáció egységértékkel rendelkező metrikák esetében érvényes. A minimális, maximális és átlagos összesítések mindig 1-et adnak vissza. További információ: Támogatott összesítések.

Felhőből eszközre irányuló ikerműveleti metrikák

Metrika megjelenítendő neve	Metrika	Unit (Egység)	Aggregáció típusa	Description	Dimenziók
Sikertelen ikerolvasások a háttérrendszerből	c2d.twin.read.failure	Darabszám	Összesen	Az összes sikertelen háttérrendszeri ikerolvasás száma.	None
Sikertelen ikerfrissítések a háttérrendszerből	c2d.twin.update.failure	Darabszám	Összesen	A háttérrendszer által kezdeményezett ikerfrissítések száma.	None
Az ikeroldali olvasások válaszmérete a háttérrendszerből	c2d.twin.read.size	Bájt	Átlag	Az összes sikeres háttérbeli ikerolvasás száma.	None
Ikerfrissítések mérete a háttérrendszerből	c2d.twin.update.size	Bájt	Átlag	Az összes sikeres háttérbeli ikerfrissítés teljes mérete.	None
Sikeres ikerolvasások a háttérrendszerből	c2d.twin.read.success	Darabszám	Összesen	Az összes sikeres háttérbeli ikerolvasás száma.	None
Sikeres ikerfrissítések a háttérrendszerből	c2d.twin.update.success	Darabszám	Összesen	A háttérrendszerben kezdeményezett összes sikeres ikerfrissítés száma.	None

Konfigurációs metrikák

Metrika megjelenítendő neve	Metrika	Unit (Egység)	Aggregáció típusa	Description	Dimenziók
Konfigurációs metrikák	Konfigurációk	Darabszám	Összesen	Az eszközkonfigurációhoz és IoT Edge üzembe helyezéshez végrehajtott összes CRUD-művelet száma a céleszközök halmazán. Ezek közé tartozik azoknak a műveleteknek a száma, amelyek ezen konfigurációk miatt módosítják az ikereszközt vagy a modul ikerpéldányát.	None

Napi kvótametrikák

Metrika megjelenítendő neve	Metrika	Unit (Egység)	Aggregáció típusa	Description	Dimenziók
Eszközadatok teljes kihasználtsága	deviceDataUsage	Bájt	Összesen	Az IotHubhoz csatlakoztatott eszközökre és eszközökről átvitt bájtok	None
Eszközadatok teljes kihasználtsága (előzetes verzió)	deviceDataUsageV2	Bájt	Összesen	Az IotHubhoz csatlakoztatott eszközökre és eszközökről átvitt bájtok	None
Felhasznált üzenetek teljes száma	dailyMessageQuotaUsed	Darabszám	Átlag	A ma használt összes üzenet száma. Egy összegző érték, amely minden nap 00:00-kor (UTC) nullára áll vissza.	None

A felhasznált üzenetek teljes száma esetén csak a minimális, maximális és átlagos összesítések támogatottak. További információ: Támogatott összesítések.

Eszközmetrikák

Metrika megjelenítendő neve	Metrika	Unit (Egység)	Aggregáció típusa	Description	Dimenziók
Összes eszköz (elavult)	devices.totalDevices	Darabszám	Összesen	Az IoT Hubon regisztrált eszközök száma	None
Csatlakoztatott eszközök (elavult)	devices.connectedDevices.allProtocol	Darabszám	Összesen	Az IoT Hubhoz csatlakoztatott eszközök száma	None
Eszközök összesen	totalDeviceCount	Darabszám	Átlag	Az IoT Hubon regisztrált eszközök száma	None
Csatlakoztatott eszközök	connectedDeviceCount	Darabszám	Átlag	Az IoT Hubhoz csatlakoztatott eszközök száma	None

Az Összes eszköz (elavult) és a Csatlakoztatott eszközök (elavult) esetében csak az összesítés (összeg) érvényes. A minimális, maximális és átlagos összesítések mindig 1-et adnak vissza. További információ: Támogatott összesítések.

Az Összes eszköz és a Csatlakoztatott eszközök esetében csak a minimális, maximális és átlagos összesítések érvényesek. További információ: Támogatott összesítések.

Az összes eszköz és csatlakoztatott eszköz nem exportálható a diagnosztikai beállításokon keresztül.

Eszköztelemetria-metrikák

Metrika megjelenítendő neve	Metrika	Unit (Egység)	Aggregáció típusa	Description	Dimenziók
Szabályozási hibák száma	d2c.telemetry.ingress.sendThrottle	Darabszám	Összesen	Az eszköz átviteli sebességének szabályozása miatti szabályozási hibák száma	None
"Üzenetküldési" telemetriakísérletek	d2c.telemetry.ingress.allProtocol	Darabszám	Összesen	Az IoT Hubra küldött eszközről a felhőbe irányuló telemetriai üzenetek száma	None
Elküldött telemetriai üzenetek	d2c.telemetry.ingress.success	Darabszám	Összesen	Az IoT Hubnak sikeresen elküldött eszközről a felhőbe irányuló telemetriai üzenetek száma	None

A Darabegységértékkel rendelkező metrikák esetében csak az összesítés (összeg) érvényes. A minimális, maximális és átlagos összesítések mindig 1-et adnak vissza. További információ: Támogatott összesítések.

Ikereszközök és felhőalapú ikerműveletek metrikái

Metrika megjelenítendő neve	Metrika	Unit (Egység)	Aggregáció típusa	Description	Dimenziók
Sikertelen ikerpéldány-beolvasások az eszközökről	d2c.twin.read.failure	Darabszám	Összesen	Az eszköz által kezdeményezett ikerpéldányok összes sikertelen olvasásának száma.	None
Sikertelen ikerfrissítések az eszközökről	d2c.twin.update.failure	Darabszám	Összesen	Az eszköz által kezdeményezett ikerpéldány-frissítések száma.	None
Az ikereszközökről beolvasott ikerpéldányok válaszmérete	d2c.twin.read.size	Bájt	Átlag	Az összes sikeres, eszköz által kezdeményezett ikerpéldány beolvasásának száma.	None
Ikerfrissítések mérete az eszközökről	d2c.twin.update.size	Bájt	Átlag	Az eszköz által kezdeményezett összes sikeres ikerfrissítés teljes mérete.	None
Sikeres ikerolvasások az eszközökről	d2c.twin.read.success	Darabszám	Összesen	Az összes sikeres, eszköz által kezdeményezett ikerpéldány olvasásának száma.	None
Sikeres ikerfrissítések az eszközökről	d2c.twin.update.success	Darabszám	Összesen	Az eszköz által kezdeményezett összes sikeres ikerfrissítés száma.	None

Event Grid-metrikák

Metrika megjelenítendő neve	Metrika	Unit (Egység)	Aggregáció típusa	Description	Dimenziók
Event Grid-kézbesítések	EventGridDeliveries	Darabszám	Összesen	Az Event Gridben közzétett IoT Hub események száma. Használja az Eredmény dimenziót a sikeres és sikertelen kérések számához. Az EventType dimenzió az esemény típusát (https://aka.ms/ioteventgrid) jeleníti meg.	Eredmény, EventType További információ: Metrikadimenziók.
Event Grid-késés	EventGridLatency	Ezredmásodperc	Átlag	Az átlagos késés (ezredmásodperc) az Iot Hub-esemény létrehozása és az esemény Event Gridben való közzététele között. Ez a szám az összes eseménytípus átlaga. Az EventType dimenzióval megtekintheti egy adott eseménytípus késését.	EventType További információ: Metrikadimenziók.

Feladatok metrikái

Metrika megjelenítendő neve	Metrika	Unit (Egység)	Aggregáció típusa	Description	Dimenziók
Befejezett feladatok	jobs.completed	Darabszám	Összesen	Az összes befejezett feladat száma.	None
Sikertelen hívások a feladatok listázásához	jobs.listJobs.failure	Darabszám	Összesen	Az összes sikertelen hívás száma a feladatok listázásához.	None
Metódushívási feladatok sikertelen létrehozása	jobs.createDirectMethodJob.failure	Darabszám	Összesen	A közvetlen metódushívási feladatok összes sikertelen létrehozásának száma.	None
Ikerpéldány-frissítési feladatok sikertelen létrehozása	jobs.createTwinUpdateJob.failure	Darabszám	Összesen	Az ikerpéldány-frissítési feladatok sikertelen létrehozásának száma.	None
Sikertelen feladatlemondások	jobs.cancelJob.failure	Darabszám	Összesen	A feladat megszakítására irányuló összes sikertelen hívás száma.	None
Sikertelen feladat-lekérdezések	jobs.queryJobs.failure	Darabszám	Összesen	A feladatok lekérdezésére irányuló összes sikertelen hívás száma.	None
Sikertelen feladatok	jobs.failed	Darabszám	Összesen	Az összes sikertelen feladat száma.	None
Sikeres hívások a feladatok listázásához	jobs.listJobs.success	Darabszám	Összesen	A feladatok listázására irányuló összes sikeres hívás száma.	None
Metódushívási feladatok sikeres létrehozása	jobs.createDirectMethodJob.success	Darabszám	Összesen	A közvetlen metódushívási feladatok sikeres létrehozásának száma.	None
Ikerpéldány-frissítési feladatok sikeres létrehozása	jobs.createTwinUpdateJob. sikeres	Darabszám	Összesen	Az ikerpéldány-frissítési feladatok sikeres létrehozásának száma.	None
Sikeres feladatlemondások	jobs.cancelJob.success	Darabszám	Összesen	A feladat megszakítására irányuló összes sikeres hívás száma.	None
Sikeres feladat-lekérdezések	jobs.queryJobs.success	Darabszám	Összesen	A lekérdezési feladatokra irányuló összes sikeres hívás száma.	None

Útválasztási metrikák

Metrika megjelenítendő neve	Metrika	Unit (Egység)	Aggregáció típusa	Description	Dimenziók
Útválasztási kézbesítések (előzetes verzió)	RoutingDeliveries	Darabszám	Összesen	Az útválasztási kézbesítési metrika. A dimenziókkal azonosíthatja egy adott végpont vagy egy adott útválasztási forrás kézbesítési állapotát.	Eredmény, RoutingSource, EndpointType, FailureReasonCategory, EndpointName További információ: Metrikadimenziók.
Útválasztási kézbesítési üzenet mérete bájtban (előzetes verzió)	RoutingDataSizeInBytesDelivered	Bájt	Összesen	A IoT Hub által az egyéni végpontra és a beépített végpontra irányított bájtok teljes száma. A dimenziókkal azonosíthatja az adott végpontra vagy egy adott útválasztási forrásra irányított adatméretet.	RoutingSource, EndpointType EndpointName További információ: Metrikadimenziók.
Útválasztási kézbesítés késése (előzetes verzió)	RoutingDeliveryLatency	Ezredmásodperc	Átlag	Az útválasztás kézbesítési késésének metrikája. A dimenziókkal azonosíthatja egy adott végpont vagy egy adott útválasztási forrás késését.	RoutingSource, EndpointType, EndpointName További információ: Metrikadimenziók.
Útválasztás: Tárolóba kézbesített blobok	d2c.endpoints.egress.storage.blobs	Darabszám	Összesen	A kézbesített blobok tárolási végpontokra való IoT Hub hányszor.	None
Útválasztás: a tárolóba szállított adatok	d2c.endpoints.egress.storage.bytes	Bájt	Összesen	A tárvégpontokra küldött IoT Hub adatmennyiség (bájt).	None
Útválasztás: üzenetkésés az Event Hubs esetében	d2c.endpoints.latency.eventHubs	Ezredmásodperc	Átlag	Az üzenetbe IoT Hub bejövő üzenetek és az Event Hubs típusú egyéni végpontokba bejövő üzenetek közötti átlagos késés (ezredmásodperc). A beépített végpontra (eseményekre) vezető üzenetek nem jelennek meg.	None
Útválasztás: a Service Bus-üzenetsor üzenetkésése	d2c.endpoints.latency.serviceBusQueues	Ezredmásodperc	Átlag	Az üzenetek IoT Hub és a Service Bus-üzenetsor végpontjára bejövő üzenetek közötti átlagos késés (ezredmásodperc).	None
Útválasztás: a Service Bus-témakör üzenetkésése	d2c.endpoints.latency.serviceBusTopics	Ezredmásodperc	Átlag	Az üzenetek IoT Hub bejövő és a Service Bus-témakör végpontjára bejövő üzenetek közötti átlagos késés (ezredmásodperc).	None
Útválasztás: üzenetek/események üzenetkésése	d2c.endpoints.latency.builtIn.events	Ezredmásodperc	Átlag	Az üzenetek bejövő IoT Hub és a beépített végpontba (üzenetek/események) és tartalék útvonalba bejövő üzenetek közötti átlagos késés (ezredmásodperc).	None
Útválasztás: üzenetkésés a tároláshoz	d2c.endpoints.latency.storage	Ezredmásodperc	Átlag	Az üzenetek IoT Hub és a tárolási végpontba bejövő üzenetek közötti átlagos késés (ezredmásodperc).	None
Útválasztás: az Event Hubsba küldött üzenetek	d2c.endpoints.egress.eventHubs	Darabszám	Összesen	Azon alkalmak száma, amikor IoT Hub sikeresen kézbesített üzeneteket az Event Hubs típusú egyéni végpontokra. A beépített végpontra (eseményekre) vezető üzenetek nem jelennek meg.	None
Útválasztás: a Service Bus-üzenetsorba kézbesített üzenetek	d2c.endpoints.egress.serviceBusQueues	Darabszám	Összesen	Azon alkalmak száma, amikor IoT Hub sikeresen kézbesített üzeneteket a Service Bus-üzenetsorvégpontokra.	None
Útválasztás: a Service Bus-témakörbe kézbesített üzenetek	d2c.endpoints.egress.serviceBusTopics	Darabszám	Összesen	Azon alkalmak száma, amikor IoT Hub sikeresen kézbesített üzeneteket a Service Bus-témakör végpontjaira.	None
Útválasztás: tartalékba küldött üzenetek	d2c.telemetry.egress.fallback	Darabszám	Összesen	Hányszor IoT Hub útválasztással kézbesített üzeneteket a tartalék útvonalhoz társított végpontra.	None
Útválasztás: üzeneteknek/eseményeknek kézbesített üzenetek	d2c.endpoints.egress.builtIn.events	Darabszám	Összesen	Az a szám, amikor IoT Hub útválasztás sikeresen kézbesítette az üzeneteket a beépített végpontra (üzenetek/események) és tartalék útvonalra.	None
Útválasztás: a tárolóba kézbesített üzenetek	d2c.endpoints.egress.storage	Darabszám	Összesen	Azon alkalmak száma, amikor IoT Hub sikeresen kézbesített üzeneteket a tárolási végpontokra.	None
Útválasztás: telemetriaüzenetek kézbesítve	d2c.telemetry.egress.success	Darabszám	Összesen	Az üzenetek sikeres kézbesítésének száma az összes végpontra IoT Hub útválasztással. Ha egy üzenet több végpontra van irányítva, ez az érték minden sikeres kézbesítéshez egy-egyvel nő. Ha egy üzenet többször is ugyanahhoz a végponthoz érkezik, ez az érték minden sikeres kézbesítés esetén egy-egy értékkel nő.	None
Útválasztás: elvetett telemetriaüzenetek	d2c.telemetry.egress.dropped	Darabszám	Összesen	Azon alkalmak száma, amikor IoT Hub útválasztás megszakadt végpontok miatt elvetett üzeneteket. Ez az érték nem számítja meg a tartalék útvonalra kézbesített üzeneteket, mivel az elvetett üzenetek nem érkeznek oda.	None
Útválasztás: a telemetriai üzenetek nem kompatibilisek	d2c.telemetry.egress.invalid	Darabszám	Összesen	Azon alkalmak száma, amikor IoT Hub útválasztás nem tudta kézbesíteni az üzeneteket a végponttal való kompatibilitás miatt. Az üzenetek nem kompatibilisek egy végponttal, amikor az Iot Hub megpróbálja kézbesíteni az üzenetet egy végpontnak, és nem átmeneti hibával meghiúsul. Az érvénytelen üzeneteket a rendszer nem próbálkozik újra. Ez az érték nem tartalmazza az újrapróbálkozásokat.	None
Útválasztás: a telemetriai üzenetek árvaak	d2c.telemetry.egress.orphaned	Darabszám	Összesen	Azon alkalmak száma, amikor az IoT Hub útválasztás elárvult, mert nem egyeztek meg egyetlen útválasztási lekérdezéssel sem, amikor a tartalék útvonal le van tiltva.	None

Iker lekérdezési metrikák

Metrika megjelenítendő neve	Metrika	Unit (Egység)	Aggregáció típusa	Description	Dimenziók
Sikertelen iker lekérdezések	twinQueries.failure	Darabszám	Összesen	Az összes sikertelen iker lekérdezés száma.	None
Sikeres iker lekérdezések	twinQueries.success	Darabszám	Összesen	Az összes sikeres iker lekérdezés száma.	None
Iker lekérdezések eredményének mérete	twinQueries.resultSize	Bájt	Átlag	Az összes sikeres iker lekérdezés eredményméretének összege.	None

Metrikadimenziók

Azure IoT Hub néhány útválasztási és Event Grid-metrikához a következő dimenziók vannak társítva.

Dimenzió neve	Description

EndpointName	A végpont neve
EndpointType	eventHubs, serviceBusQueues, cosmosDB, serviceBusTopics. builtin vagy blobStorage
EventType	Microsoft.Devices.DeviceCreated. Microsoft.Devices.DeviceDeleted, Microsoft.Devices.DeviceConnected, Microsoft.Devices.DeviceDisconnected vagy Microsoft.Devices.DeviceTelemetry További információ: Eseménytípusok.
FailureReasonCategory	Az alábbiak egyike: érvénytelen, elvetett, árva vagy null.
Eredmény	Sikeres vagy sikertelen
RoutingSource	Eszközüzenetek Ikermódosítási események Eszközéletciklus-események

A metrikadimenziókkal kapcsolatos további információkért lásd: Többdimenziós metrikák.

Erőforrásnaplók

Ez a szakasz a Azure IoT Hub gyűjtött erőforrásnapló-kategóriatípusokat és sémákat sorolja fel. Az összes IoT Hub napló erőforrás-szolgáltatója és típusa a Microsoft.Devices/IotHubs. Az események csak bizonyos kategóriákban előforduló hibák esetén lesznek kibocsátva.

A szakasz témakörei

Kapcsolatok
Eszköztelemetria
Felhő–eszköz irányú parancsok
Eszközidentitás-műveletek
Fájlfeltöltési műveletek
Útvonalak
Ikereszközök között végzett ikerműveletek
Ikerműveletek a felhőből az eszközre
Iker lekérdezések
Feladatműveletek
Közvetlen metódusok
Elosztott nyomkövetés (előzetes verzió)
Konfigurációk
Eszközstreamek (előzetes verzió)

Kapcsolatok

A kapcsolatok kategória nyomon követi az eszközök IoT Hubbal való csatlakoztatását és leválasztását, valamint a hibákat. Ez a kategória akkor hasznos, ha jogosulatlan csatlakozási kísérleteket észlel, vagy riasztást küld, ha megszakad a kapcsolat az eszközökkel.

Az eszközök megbízható kapcsolati állapotáról az Eszközkapcsolat állapotának figyelése című témakörben olvashat.

{
   "records":
   [
        {
            "time": " UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "deviceConnect",
            "category": "Connections",
            "level": "Information",
            "properties": "{\"deviceId\":\"<deviceId>\",\"sdkVersion\":\"<sdkVersion>\",\"protocol\":\"<protocol>\",\"authType\":\"{\\\"scope\\\":\\\"device\\\",\\\"type\\\":\\\"sas\\\",\\\"issuer\\\":\\\"iothub\\\",\\\"acceptingIpFilterRule\\\":null}\",\"maskedIpAddress\":\"<maskedIpAddress>\"}",
            "location": "Resource location"
        }
    ]
}

Az eszközkapcsolatok kapcsolati naplók használatával kapcsolatos részletes információkért lásd: Az Azure IoT Hub eszközkapcsolatainak monitorozása, diagnosztizálása és hibaelhárítása.

Eszköztelemetria

Az eszköz telemetriai kategóriája nyomon követi az IoT Hubon előforduló és a telemetriai folyamattal kapcsolatos hibákat. Ebbe a kategóriába tartoznak a telemetriai események (például szabályozás) és a telemetriaesemények (például jogosulatlan olvasó) fogadása során előforduló hibák. Ez a kategória nem képes észlelni az eszközön futó kód által okozott hibákat.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "ingress",
            "category": "DeviceTelemetry",
            "level": "Error",
            "resultType": "Event status",
            "resultDescription": "MessageDescription",
            "properties": "{\"deviceId\":\"<deviceId>\",\"batching\":\"0\",\"messageSizeInBytes\":\"<messageSizeInBytes>\",\"EventProcessedUtcTime\":\"<UTC timestamp>\",\"EventEnqueuedUtcTime\":\"<UTC timestamp>\",\"partitionId\":\"1\"}", 
            "location": "Resource location"
        }
    ]
}

Felhő–eszköz irányú parancsok

A felhőből az eszközre irányuló parancsok kategória nyomon követi az IoT Hubon előforduló és a felhőből az eszközre irányuló üzenetfolyamathoz kapcsolódó hibákat. Ebbe a kategóriába tartoznak a következő hibák:

Felhőből eszközre irányuló üzenetek küldése (például jogosulatlan feladói hibák),
A felhőből az eszközre irányuló üzenetek fogadása (például a kézbesítési szám túllépte a hibákat) és
A felhőből az eszközre irányuló üzenetekre vonatkozó visszajelzések (például lejárt visszajelzési hibák) érkeznek.

Ez a kategória nem észleli a hibákat, ha a felhőből az eszközre irányuló üzenet sikeresen kézbesítve van, de az eszköz helytelenül kezeli.

{
    "records":
    [
        {
            "time": " UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "messageExpired",
            "category": "C2DCommands",
            "level": "Error",
            "resultType": "Event status",
            "resultDescription": "MessageDescription",
            "properties": "{\"deviceId\":\"<deviceId>\",\"messageId\":\"<messageId>\",\"messageSizeInBytes\":\"<messageSize>\",\"protocol\":\"Amqp\",\"deliveryAcknowledgement\":\"<None, NegativeOnly, PositiveOnly, Full>\",\"deliveryCount\":\"0\",\"expiryTime\":\"<timestamp>\",\"timeInSystem\":\"<timeInSystem>\",\"ttl\":<ttl>, \"EventProcessedUtcTime\":\"<UTC timestamp>\",\"EventEnqueuedUtcTime\":\"<UTC timestamp>\", \"maskedIpAddress\": \"<maskedIpAddress>\", \"statusCode\": \"4XX\"}",
            "location": "Resource location"
        }
    ]
}

Eszközidentitás-műveletek

Az eszközidentitás-műveletek kategóriája nyomon követi azokat a hibákat, amelyek akkor fordulnak elő, amikor bejegyzést próbál létrehozni, frissíteni vagy törölni az IoT Hub identitásjegyzékében. A kategória nyomon követése hasznos a kiépítési forgatókönyvek esetében.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "get",
            "category": "DeviceIdentityOperations",
            "level": "Error",
            "resultType": "Event status",
            "resultDescription": "MessageDescription",
            "properties": "{\"maskedIpAddress\":\"<maskedIpAddress>\",\"deviceId\":\"<deviceId>\", \"statusCode\":\"4XX\"}",
            "location": "Resource location"
        }
    ]
}

Fájlfeltöltési műveletek

A fájlfeltöltési kategória nyomon követi az IoT Hubon előforduló és a fájlfeltöltési funkcióval kapcsolatos hibákat. Ez a kategória a következőket tartalmazza:

Az SAS URI-val kapcsolatos hibák, például amikor lejárnak, mielőtt egy eszköz értesíti a befejezett feltöltés központját.
Az eszköz által jelentett sikertelen feltöltések.
Hibák, amelyek akkor fordulnak elő, ha egy fájl nem található a tárolóban IoT Hub értesítési üzenet létrehozása során.

Ez a kategória nem tudja észlelni azokat a hibákat, amelyek közvetlenül akkor fordulnak elő, amikor az eszköz feltölt egy fájlt a tárolóba.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "ingress",
            "category": "FileUploadOperations",
            "level": "Error",
            "resultType": "Event status",
            "resultDescription": "MessageDescription",
            "durationMs": "1",
            "properties": "{\"deviceId\":\"<deviceId>\",\"protocol\":\"<protocol>\",\"authType\":\"{\\\"scope\\\":\\\"device\\\",\\\"type\\\":\\\"sas\\\",\\\"issuer\\\":\\\"iothub\\\",\\\"acceptingIpFilterRule\\\":null}\",\"blobUri\":\"http//bloburi.com\"}",
            "location": "Resource location"
        }
    ]
}

Útvonalak

Az üzenetútvonal-kategória nyomon követi az üzenetútvonal kiértékelése és a végpont állapota során IoT Hub észlelt hibákat. Ez a kategória az alábbi eseményeket foglalja magában:

Egy szabály "meghatározatlan" értéket ad vissza,
IoT Hub a végpontot halottként jelöli meg, vagy
A végponttól kapott hibák.

Ez a kategória nem tartalmaz konkrét hibákat magukról az üzenetekről (például az eszközszabályozási hibákról), amelyek az "eszköztelemetria" kategóriában vannak jelentve.

{
    "records":
    [
        {
            "time":"2019-12-12T03:25:14Z",
            "resourceId":"/SUBSCRIPTIONS/91R34780-3DEC-123A-BE2A-213B5500DFF0/RESOURCEGROUPS/ANON-TEST/PROVIDERS/MICROSOFT.DEVICES/IOTHUBS/ANONHUB1",
            "operationName":"endpointUnhealthy",
            "category":"Routes",
            "level":"Error",
            "resultType":"403004",
            "resultDescription":"DeviceMaximumQueueDepthExceeded",
            "properties":"{\"deviceId\":null,\"endpointName\":\"anon-sb-1\",\"messageId\":null,\"details\":\"DeviceMaximumQueueDepthExceeded\",\"routeName\":null,\"statusCode\":\"403\"}",
            "location":"westus"
        }
    ]
}

További részletek az erőforrásnaplók útválasztásáról:

Ikereszközök között végzett ikerműveletek

Az eszközről a felhőbe irányuló ikerműveletek kategóriája nyomon követi az ikereszközök eszköz által kezdeményezett eseményeit. Ezek közé tartozhat az ikerpéldány lekérése, a jelentett tulajdonságok frissítése és a kívánt tulajdonságokra való feliratkozás.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "update",
            "category": "D2CTwinOperations",
            "level": "Information",
            "durationMs": "1",
            "properties": "{\"deviceId\":\"<deviceId>\",\"protocol\":\"<protocol>\",\"authenticationType\":\"{\\\"scope\\\":\\\"device\\\",\\\"type\\\":\\\"sas\\\",\\\"issuer\\\":\\\"iothub\\\",\\\"acceptingIpFilterRule\\\":null}\"}",
            "location": "Resource location"
        }
    ]
}

Ikerműveletek a felhőből az eszközre

A felhőből az eszközre irányuló ikerműveletek kategória nyomon követi a szolgáltatás által kezdeményezett eseményeket az ikereszközökön. Ilyen művelet lehet az ikerpéldány lekérése, a címkék frissítése vagy cseréje, valamint a kívánt tulajdonságok frissítése vagy cseréje.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "read",
            "category": "C2DTwinOperations",
            "level": "Information",
            "durationMs": "1",
            "properties": "{\"deviceId\":\"<deviceId>\",\"sdkVersion\":\"<sdkVersion>\",\"messageSize\":\"<messageSize>\"}",
            "location": "Resource location"
        }
    ]
}

Iker lekérdezések

Az iker lekérdezések kategória a felhőben kezdeményezett ikereszközök lekérdezési kérelmeiről számol be.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "query",
            "category": "TwinQueries",
            "level": "Information",
            "durationMs": "1",
            "properties": "{\"query\":\"<twin query>\",\"sdkVersion\":\"<sdkVersion>\",\"messageSize\":\"<messageSize>\",\"pageSize\":\"<pageSize>\", \"continuation\":\"<true, false>\", \"resultSize\":\"<resultSize>\"}",
            "location": "Resource location"
        }
    ]
}

Feladatműveletek

A feladatműveletek kategóriája jelentést készít az ikereszközök frissítésére vagy közvetlen metódusok meghívására irányuló feladatkérésekről több eszközön. Ezeket a kéréseket a felhőben kezdeményezik.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "jobCompleted",
            "category": "JobsOperations",
            "level": "Information",
            "durationMs": "1",
            "properties": "{\"jobId\":\"<jobId>\", \"sdkVersion\": \"<sdkVersion>\",\"messageSize\": <messageSize>,\"filter\":\"DeviceId IN ['1414ded9-b445-414d-89b9-e48e8c6285d5']\",\"startTimeUtc\":\"Wednesday, September 13, 2017\",\"duration\":\"0\"}",
            "location": "Resource location"
        }
    ]
}

Közvetlen metódusok

A közvetlen metódusok kategória nyomon követi az egyes eszközöknek küldött kérés-válasz interakciókat. Ezeket a kéréseket a felhőben kezdeményezik.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "send",
            "category": "DirectMethods",
            "level": "Information",
            "durationMs": "1",
            "properties": "{\"deviceId\":<messageSize>, \"RequestSize\": 1, \"ResponseSize\": 1, \"sdkVersion\": \"2017-07-11\"}",
            "location": "Resource location"
        }
    ]
}

Elosztott nyomkövetés (előzetes verzió)

Az elosztott nyomkövetési kategória nyomon követi a nyomkövetési környezet fejlécét tartalmazó üzenetek korrelációs azonosítóit. A naplók teljes körű engedélyezéséhez az ügyféloldali kódot frissíteni kell az IoT-alkalmazások teljes körű elemzése és diagnosztizálása IoT Hub elosztott nyomkövetéssel (előzetes verzió) című témakörben.

A correlationId megfelel a W3C Trace Context javaslatnak, amelyben egy trace-id és egy span-id.

IoT Hub D2C-naplók (eszközről felhőre)

IoT Hub rögzíti ezt a naplót, amikor egy érvényes nyomkövetési tulajdonságokat tartalmazó üzenet érkezik IoT Hub.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "DiagnosticIoTHubD2C",
            "category": "DistributedTracing",
            "correlationId": "00-8cd869a412459a25f5b4f31311223344-0144d2590aacd909-01",
            "level": "Information",
            "resultType": "Success",
            "resultDescription":"Receive message success",
            "durationMs": "",
            "properties": "{\"messageSize\": 1, \"deviceId\":\"<deviceId>\", \"callerLocalTimeUtc\": : \"2017-02-22T03:27:28.633Z\", \"calleeLocalTimeUtc\": \"2017-02-22T03:27:28.687Z\"}",
            "location": "Resource location"
        }
    ]
}

Itt nem számítjuk ki, mert előfordulhat, durationMs hogy IoT Hub órája nincs szinkronban az eszközórával, így az időtartamszámítás félrevezető lehet. Javasoljuk, hogy a szakaszban szereplő időbélyegek használatával írjon logikát az properties eszközről a felhőbe irányuló késési csúcsok rögzítéséhez.

Tulajdonság	Típus	Description
messageSize	Egész szám	Az eszközről a felhőbe irányuló üzenet mérete bájtban
Deviceid	ASCII 7 bites alfanumerikus karakterek sztringje	Az eszköz identitása
hívóLocalTimeUtc	UTC időbélyeg	Az üzenet létrehozási ideje az eszköz helyi órája által jelentett módon
calleeLocalTimeUtc	UTC időbélyeg	Az üzenet érkezésének időpontja az IoT Hub átjárójára a IoT Hub szolgáltatásoldali óra által jelentett módon

bejövő naplók IoT Hub

IoT Hub rögzíti ezt a naplót, amikor az érvényes nyomkövetési tulajdonságokat tartalmazó üzenet belső vagy beépített Event Hubsba ír.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "DiagnosticIoTHubIngress",
            "category": "DistributedTracing",
            "correlationId": "00-8cd869a412459a25f5b4f31311223344-349810a9bbd28730-01",
            "level": "Information",
            "resultType": "Success",
            "resultDescription":"Ingress message success",
            "durationMs": "10",
            "properties": "{\"isRoutingEnabled\": \"true\", \"parentSpanId\":\"0144d2590aacd909\"}",
            "location": "Resource location"
        }
    ]
}

A szakaszban ez a properties napló további információkat tartalmaz az üzenetek bejövő forgalmáról.

Tulajdonság	Típus	Description
isRoutingEnabled	Sztring	Igaz vagy hamis, azt jelzi, hogy engedélyezve van-e az üzenet útválasztása a IoT Hub
parentSpanId	Sztring	A szülőüzenet span-id azonosítója, amely ebben az esetben a D2C-üzenet nyomkövetése lenne

kimenő naplók IoT Hub

IoT Hub rögzíti ezt a naplót, amikor az útválasztás engedélyezve van, és az üzenet egy végpontra van írva. Ha az útválasztás nincs engedélyezve, IoT Hub nem rögzíti ezt a naplót.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "DiagnosticIoTHubEgress",
            "category": "DistributedTracing",
            "correlationId": "00-8cd869a412459a25f5b4f31311223344-98ac3578922acd26-01",
            "level": "Information",
            "resultType": "Success",
            "resultDescription":"Egress message success",
            "durationMs": "10",
            "properties": "{\"endpointType\": \"EventHub\", \"endpointName\": \"myEventHub\", \"parentSpanId\":\"349810a9bbd28730\"}",
            "location": "Resource location"
        }
    ]
}

A szakaszban ez a properties napló további információkat tartalmaz az üzenetek bejövő forgalmáról.

Tulajdonság	Típus	Description
endpointName	Sztring	Az útválasztási végpont neve
endpointType	Sztring	Az útválasztási végpont típusa
parentSpanId	Sztring	A szülőüzenet span-id azonosítója, amely ebben az esetben a IoT Hub bejövő üzenetek nyomkövetése lenne

Konfigurációk

IoT Hub konfigurációs naplók nyomon követik az Automatikus Eszközkezelés funkciókészlet eseményeit és hibáit.

{
    "records":
    [
         {
             "time": "2019-09-24T17:21:52Z",
             "resourceId": "Resource Id",
             "operationName": "ReadManyConfigurations",
             "category": "Configurations",
             "resultType": "",
             "resultDescription": "",
             "level": "Information",
             "durationMs": "17",
             "properties": "{\"configurationId\":\"\",\"sdkVersion\":\"2018-06-30\",\"messageSize\":\"0\",\"statusCode\":null}",
             "location": "southcentralus"
         }
    ]
}

Eszközstreamek (előzetes verzió)

Az eszközstreamek kategória nyomon követi az egyes eszközöknek küldött kérés-válasz interakciókat.

{
    "records":
    [
         {
             "time": "2019-09-19T11:12:04Z",
             "resourceId": "Resource Id",
             "operationName": "invoke",
             "category": "DeviceStreams",
             "resultType": "",
             "resultDescription": "",    
             "level": "Information",
             "durationMs": "74",
             "properties": "{\"deviceId\":\"myDevice\",\"moduleId\":\"myModule\",\"sdkVersion\":\"2019-05-01-preview\",\"requestSize\":\"3\",\"responseSize\":\"5\",\"statusCode\":null,\"requestName\":\"myRequest\",\"direction\":\"c2d\"}",
             "location": "Central US"
         }
    ]
}

Azure Monitor-naplók táblái

Ez a szakasz az összes Olyan Azure Monitor-napló Kusto-táblára vonatkozik, amely Azure IoT Hub kapcsolatos, és a Log Analytics által elérhető lekérdezésekhez érhető el. A táblák listájáért és a IoT Hub erőforrástípussal kapcsolatos további információkra mutató hivatkozásokért lásd: IoT Hub az Azure Monitor Naplók táblahivatkozásában.

Az összes Azure Monitor-napló/Log Analytics-tábla referenciáját lásd az Azure Monitor-naplótáblák referenciájában.

Lásd még:

A monitorozási Azure IoT Hub leírását lásd: Monitorozási Azure IoT Hub.
Az Azure-erőforrások monitorozásával kapcsolatos részletekért lásd: Azure-erőforrások monitorozása az Azure Monitorral .

Monitorozási Azure IoT Hub referenciája

Mérőszámok

Támogatott összesítések

Felhőből eszközre irányuló parancsmetrikák

Felhőből eszközre irányuló közvetlen metódusok metrikái

Felhőből eszközre irányuló ikerműveleti metrikák

Konfigurációs metrikák

Napi kvótametrikák

Eszközmetrikák

Eszköztelemetria-metrikák

Ikereszközök és felhőalapú ikerműveletek metrikái

Event Grid-metrikák

Feladatok metrikái

Útválasztási metrikák

Iker lekérdezési metrikák

Metrikadimenziók

Erőforrásnaplók

Kapcsolatok

Eszköztelemetria

Felhő–eszköz irányú parancsok

Eszközidentitás-műveletek

Fájlfeltöltési műveletek

Útvonalak

Ikereszközök között végzett ikerműveletek

Ikerműveletek a felhőből az eszközre

Iker lekérdezések

Feladatműveletek

Közvetlen metódusok

Elosztott nyomkövetés (előzetes verzió)

IoT Hub D2C-naplók (eszközről felhőre)

bejövő naplók IoT Hub

kimenő naplók IoT Hub

Konfigurációk

Eszközstreamek (előzetes verzió)

Azure Monitor-naplók táblái

Lásd még:

További források