Referenční informace k datům monitorování Azure IoT Hub
Pokud chcete začít s monitorováním Azure, přečtěte si téma Monitorování Azure IoT Hub, kde zjistíte, jak shromažďovat a analyzovat data monitorování pro Azure IoT Hub.
Tento článek je referenční dokumentace k implementaci monitorování Azure.
Hlavní části tohoto referenčního článku:
Metriky: seznamy metrik IoT Hub platformy podle tématu
Dimenze metrik: dimenze pro směrování a metriky Event Gridu
Protokoly prostředků: Protokoly podle typů kategorií a schémat shromažďovaných pro Azure IoT Hub
Tabulky protokolů Azure Monitoru: probírá tabulky Kusto protokolů Azure Monitoru.
Nebo přejděte přímo k referenční tabulce protokolů služby Azure Monitor.
Metriky
Tato část obsahuje seznam všech automaticky shromažďovaných metrik platformy pro Azure IoT Hub. Obor názvů poskytovatele prostředků pro metriky IoT Hub je Microsoft.Devices a typ Obor názvů je IoTHubs.
Následující pododdíly zobrazují metriky platformy IoT Hub podle obecné kategorie a uvádějí metriky podle jejich zobrazovaných názvů, jak je přiřazeno v Azure Portal.
V dokumentaci ke službě Azure Monitor najdete také jednu tabulku, která uvádí všechny metriky IoT Hub platformy podle názvu metriky v části Microsoft.Devices/IotHubs. Tato tabulka neposkytuje všechny informace, jako jsou podporované agregace pro některé metriky, které jsou k dispozici v tomto článku.
Další informace o metrikách podporovaných jinými službami Azure najdete v tématu Podporované metriky ve službě Azure Monitor.
Témata v této části
Výběrem tématu přejdete na informace o tomto tématu na této stránce.
- Podporované agregace
- Metriky příkazů cloud-zařízení
- Metriky přímých metod cloud-zařízení
- Metriky operací z cloudu na dvojčete zařízení
- Metriky konfigurace
- Metriky denní kvóty
- Metriky zařízení
- Metriky telemetrie zařízení
- Metriky operací dvojčete zařízení-cloud
- Metriky Event Gridu
- Metriky úloh
- Metriky směrování
- Metriky dvojčete dotazů
Podporované agregace
Sloupec Typ agregace v každé tabulce odpovídá výchozí agregaci, která se používá při výběru metriky pro graf nebo výstrahu.
Pro většinu metrik jsou platné všechny typy agregace. Pro metriky počtu s hodnotou sloupce Unit (Jednotka ) count (Počet) jsou však platné pouze některé agregace. Metriky počtu můžou být jedním ze dvou typů:
U metrik počtu jednobodů IoT Hub registruje při každém výskytu měřené operace jeden datový bod (v podstatě 1). Azure Monitor pak tyto datové body sečte podle zadané členitosti. Mezi jednobodové metriky patří odesílané telemetrické zprávy a dokončené doručování zpráv C2D. Pro tyto metriky je jediným relevantním typem agregace Total (Součet). Portál umožňuje zvolit minimum, maximum a průměr. tyto hodnoty však budou vždy 1.
U metrik počtu snímků IoT Hub při výskytu měřené operace zaregistruje celkový počet. V současné době IoT Hub generují tři metriky snímků: Celkový počet použitých zpráv, Celkový počet zařízení a Připojená zařízení. Vzhledem k tomu, že tyto metriky představují "celkové" množství při každém vygenerování, nemá jejich sečtení v zadané členitosti smysl. Azure Monitor vás omezuje na výběr průměru, minima a maxima pro typ agregace pro tyto metriky.
Metriky příkazů cloud-zařízení
Zobrazovaný název metriky | Metric | Jednotka | Typ agregace | Popis | Dimenze |
---|---|---|---|---|---|
Vypršela platnost zpráv C2D | C2DMessagesExpired | Počet | Celkem | Počet zpráv typu cloud-zařízení s vypršenou platností | Žádné |
Doručování zpráv C2D bylo dokončeno | c2d.commands.egress.complete.success | Počet | Celkem | Počet úspěšně dokončených doručování zpráv z cloudu do zařízení zařízením | Žádné |
Zprávy C2D jsou opuštěné. | c2d.commands.egress.abandon.success | Počet | Celkem | Počet zpráv typu cloud-zařízení, které zařízení opustilo | Žádné |
Zprávy C2D byly odmítnuty | c2d.commands.egress.reject.success | Počet | Celkem | Počet zpráv typu cloud-zařízení odmítnutých zařízením | Žádné |
Pro metriky s jednotkovou hodnotou Count je platná pouze agregace celkového součtu. Minimální, maximální a průměrné agregace vždy vrátí hodnotu 1. Další informace najdete v tématu Podporované agregace.
Metriky přímých metod cloud-zařízení
Zobrazovaný název metriky | Metric | Jednotka | Typ agregace | Popis | Dimenze |
---|---|---|---|---|---|
Neúspěšné přímé vyvolání metody | c2d.methods.failure | Počet | Celkem | Počet všech neúspěšných volání přímé metody. | Žádné |
Velikost požadavku na vyvolání přímé metody | c2d.methods.requestSize | Bajty | Průměr | Počet všech úspěšných požadavků na přímé metody. | Žádné |
Velikost odpovědi vyvolání přímé metody | c2d.methods.responseSize | Bajty | Průměr | Počet všech úspěšných odpovědí přímých metod. | Žádné |
Úspěšná volání přímých metod | c2d.methods.success | Počet | Celkem | Počet všech úspěšných volání přímých metod. | Žádné |
Pro metriky s hodnotou Jednotkyje platná pouze agregace celkem (součet). Agregace minimum, maximum a průměr vždy vrátí hodnotu 1. Další informace najdete v tématu Podporované agregace.
Metriky operací z cloudu na dvojčete zařízení
Zobrazovaný název metriky | Metric | Jednotka | Typ agregace | Popis | Dimenze |
---|---|---|---|---|---|
Neúspěšné čtení dvojčete z back-endu | c2d.twin.read.failure | Počet | Celkem | Počet všech čtení dvojčat iniciovaných back-endem, která selhala. | Žádné |
Neúspěšné aktualizace dvojčete z back-endu | c2d.twin.update.failure | Počet | Celkem | Počet všech neúspěšných aktualizací dvojčat iniciovaných back-endem. | Žádné |
Velikost odpovědi dvojčete čtení z back-endu | c2d.twin.read.size | Bajty | Průměr | Počet všech úspěšných čtení dvojčat iniciovaných back-endem | Žádné |
Velikost aktualizací dvojčat z back-endu | c2d.twin.update.size | Bajty | Průměr | Celková velikost všech úspěšných aktualizací dvojčat iniciovaných back-endem. | Žádné |
Úspěšná čtení dvojčete z back-endu | c2d.twin.read.success | Počet | Celkem | Počet všech úspěšných čtení dvojčat iniciovaných back-endem | Žádné |
Úspěšné aktualizace dvojčete z back-endu | c2d.twin.update.success | Počet | Celkem | Počet všech úspěšných aktualizací dvojčat iniciovaných back-endem | Žádné |
Pro metriky s hodnotou Unit (Počet) je platná pouze agregace celkového součtu( celkem). Agregace minimum, maximum a průměr vždy vrátí hodnotu 1. Další informace najdete v tématu Podporované agregace.
Metriky konfigurace
Zobrazovaný název metriky | Metric | Jednotka | Typ agregace | Popis | Dimenze |
---|---|---|---|---|---|
Metriky konfigurace | Konfigurace | Počet | Celkem | Počet celkových operací CRUD provedených pro konfiguraci zařízení a nasazení IoT Edge na sadě cílových zařízení Zahrnuje počet operací, které kvůli těmto konfiguracím upravují dvojče zařízení nebo dvojče modulu. | Žádné |
Pro metriky s hodnotou Unit (Počet) je platná pouze agregace celkového součtu( celkem). Agregace minimum, maximum a průměr vždy vrátí hodnotu 1. Další informace najdete v tématu Podporované agregace.
Metriky denní kvóty
Zobrazovaný název metriky | Metric | Jednotka | Typ agregace | Popis | Dimenze |
---|---|---|---|---|---|
Celkové využití dat zařízení | deviceDataUsage | Bajty | Celkem | Bajty přenesené do a ze všech zařízení připojených k IotHubu | Žádné |
Celkové využití dat zařízení (Preview) | deviceDataUsageV2 | Bajty | Celkem | Bajty přenesené do a ze všech zařízení připojených k IotHubu | Žádné |
Celkový počet použitých zpráv | dailyMessageQuotaUsed | Počet | Průměr | Celkový počet zpráv, které se dnes používají Kumulativní hodnota, která se každý den v 00:00 UTC resetuje na nulu. | Žádné |
V poli Celkový počet použitých zpráv se podporují pouze agregace s minimálním, maximálním a průměrným počtem. Další informace najdete v tématu Podporované agregace.
Metriky zařízení
Zobrazovaný název metriky | Metric | Jednotka | Typ agregace | Popis | Dimenze |
---|---|---|---|---|---|
Celkový počet zařízení (zastaralá) | devices.totalDevices | Počet | Celkem | Počet zařízení zaregistrovaných ve službě IoT Hub | Žádné |
Připojená zařízení (zastaralá) | devices.connectedDevices.allProtocol | Počet | Celkem | Počet zařízení připojených k centru IoT | Žádné |
Celkový počet zařízení | totalDeviceCount | Počet | Průměr | Počet zařízení zaregistrovaných ve službě IoT Hub | Žádné |
Připojená zařízení | connectedDeviceCount | Počet | Průměr | Počet zařízení připojených k centru IoT | Žádné |
V části Celkový počet zařízení (zastaralá) a Připojená zařízení (zastaralá) je platná jenom agregace celkového součtu (celkem). Agregace minimum, maximum a průměr vždy vrátí hodnotu 1. Další informace najdete v tématu Podporované agregace.
V možnostech Celkový počet zařízení a Připojená zařízení jsou platné pouze minimální, maximální a průměrné agregace. Další informace najdete v tématu Podporované agregace.
Celkový počet zařízení a Připojená zařízení se nedají exportovat prostřednictvím nastavení diagnostiky.
Metriky telemetrie zařízení
Zobrazovaný název metriky | Metric | Jednotka | Typ agregace | Popis | Dimenze |
---|---|---|---|---|---|
Počet chyb omezování | d2c.telemetry.ingress.sendThrottle | Počet | Celkem | Počet chyb omezování kvůli omezování propustnosti zařízení | Žádné |
Pokusy o odeslání zprávy telemetrie | d2c.telemetry.ingress.allProtocol | Počet | Celkem | Počet zpráv telemetrie typu zařízení-cloud, které se pokusily odeslat do služby IoT Hub | Žádné |
Odeslané zprávy telemetrie | d2c.telemetry.ingress.success | Počet | Celkem | Počet zpráv telemetrie typu zařízení-cloud, které byly úspěšně odeslány do centra IoT | Žádné |
Pro metriky s hodnotou Unit (Počet) je platná pouze agregace celkového součtu( celkem). Agregace minimum, maximum a průměr vždy vrátí hodnotu 1. Další informace najdete v tématu Podporované agregace.
Metriky operací mezi zařízeními a cloudovými dvojčaty
Zobrazovaný název metriky | Metric | Jednotka | Typ agregace | Popis | Dimenze |
---|---|---|---|---|---|
Neúspěšné čtení dvojčat ze zařízení | d2c.twin.read.failure | Počet | Celkem | Počet všech neúspěšných čtení dvojčat iniciovaných zařízením. | Žádné |
Neúspěšné aktualizace dvojčat ze zařízení | d2c.twin.update.failure | Počet | Celkem | Počet všech neúspěšných aktualizací dvojčat iniciovaných zařízením. | Žádné |
Velikost odpovědi dvojčete ze zařízení | d2c.twin.read.size | Bajty | Průměr | Počet všech úspěšných čtení dvojčat iniciovaných zařízením. | Žádné |
Velikost aktualizací dvojčat ze zařízení | d2c.twin.update.size | Bajty | Průměr | Celková velikost všech úspěšných aktualizací dvojčat iniciovaných zařízením. | Žádné |
Úspěšná čtení dvojčat ze zařízení | d2c.twin.read.success | Počet | Celkem | Počet všech úspěšných čtení dvojčat iniciovaných zařízením. | Žádné |
Úspěšné aktualizace dvojčat ze zařízení | d2c.twin.update.success | Počet | Celkem | Počet všech úspěšných aktualizací dvojčat iniciovaných zařízením. | Žádné |
Pro metriky s hodnotou Unit (Počet) je platná pouze agregace celkového součtu( celkem). Agregace minimum, maximum a průměr vždy vrátí hodnotu 1. Další informace najdete v tématu Podporované agregace.
Metriky Event Gridu
Zobrazovaný název metriky | Metric | Jednotka | Typ agregace | Popis | Dimenze |
---|---|---|---|---|---|
Doručování službou Event Grid | EventGridDeliveries | Počet | Celkem | Počet událostí IoT Hub publikovaných ve službě Event Grid. Použijte dimenzi Výsledek pro počet úspěšných a neúspěšných požadavků. Dimenze EventType zobrazuje typ události (https://aka.ms/ioteventgrid). | Výsledek Typ události Další informace najdete v tématu Dimenze metrik. |
Latence Event Gridu | EventGridLatency | Milisekund | Průměr | Průměrná latence (milisekundy) od vygenerování události IoT Hubu do doby, kdy byla událost publikována do Event Gridu. Toto číslo představuje průměr mezi všemi typy událostí. Pomocí dimenze EventType můžete zobrazit latenci konkrétního typu události. | Typ události Další informace najdete v tématu Dimenze metrik. |
Pro metriky s hodnotou Unit (Počet) je platná pouze agregace celkového součtu( celkem). Agregace minimum, maximum a průměr vždy vrátí hodnotu 1. Další informace najdete v tématu Podporované agregace.
Metriky úloh
Zobrazovaný název metriky | Metric | Jednotka | Typ agregace | Popis | Dimenze |
---|---|---|---|---|---|
Dokončené úlohy | úlohy.completed | Počet | Celkem | Počet všech dokončených úloh. | Žádné |
Neúspěšná volání výpisu úloh | jobs.listJobs.failure | Počet | Celkem | Počet všech neúspěšných volání výpisu úloh. | Žádné |
Neúspěšné vytváření úloh vyvolání metody | jobs.createDirectMethodJob.failure | Počet | Celkem | Počet všech neúspěšných vytvoření úloh vyvolání přímé metody. | Žádné |
Neúspěšné vytváření úloh aktualizace dvojčete | jobs.createTwinUpdateJob.failure | Počet | Celkem | Počet všech neúspěšných vytvoření úloh aktualizace dvojčete. | Žádné |
Zrušení neúspěšných úloh | jobs.cancelJob.failure | Počet | Celkem | Počet všech neúspěšných volání ke zrušení úlohy. | Žádné |
Neúspěšné dotazy úloh | jobs.queryJobs.failure | Počet | Celkem | Počet všech neúspěšných volání úloh dotazů. | Žádné |
Neúspěšné úlohy | úlohy.failed | Počet | Celkem | Počet všech neúspěšných úloh. | Žádné |
Úspěšná volání výpisu úloh | jobs.listJobs.success | Počet | Celkem | Počet všech úspěšných volání výpisu úloh. | Žádné |
Úspěšné vytvoření úloh vyvolání metody | jobs.createDirectMethodJob.success | Počet | Celkem | Počet všech úspěšných vytvoření úloh vyvolání přímé metody | Žádné |
Úspěšné vytvoření úloh aktualizace dvojčat | jobs.createTwinUpdateJob. úspěch |
Počet | Celkem | Počet všech úspěšných vytvoření úloh aktualizace dvojčat. | Žádné |
Úspěšná zrušení úloh | jobs.cancelJob.success | Počet | Celkem | Počet všech úspěšných volání pro zrušení úlohy. | Žádné |
Úspěšné dotazy na úlohy | jobs.queryJobs.success | Počet | Celkem | Počet všech úspěšných volání úloh dotazů. | Žádné |
Pro metriky s jednotkovou hodnotou Count je platná pouze agregace celkového součtu. Minimální, maximální a průměrné agregace vždy vrátí hodnotu 1. Další informace najdete v tématu Podporované agregace.
Metriky směrování
Zobrazovaný název metriky | Metric | Jednotka | Typ agregace | Popis | Dimenze |
---|---|---|---|---|---|
Směrování doručení (Preview) | RoutingDeliveries | Počet | Celkem | Metrika doručování směrování Pomocí dimenzí identifikujte stav doručení pro konkrétní koncový bod nebo pro konkrétní zdroj směrování. | Výsledek RoutingSource, EndpointType, FailureReasonCategory, Název koncového bodu Další informace najdete v tématu Dimenze metrik. |
Velikost zprávy o doručení směrování v bajtech (Preview) | RoutingDataSizeInBytesDelivered | Bajty | Celkem | Celkový počet bajtů směrovaných IoT Hub do vlastního koncového bodu a integrovaného koncového bodu. Dimenze slouží k identifikaci velikosti dat směrovaných do konkrétního koncového bodu nebo pro konkrétní zdroj směrování. | RoutingSource, Typ koncového bodu Název koncového bodu Další informace najdete v tématu Dimenze metrik. |
Latence doručování směrování (Preview) | RoutingDeliveryLatency | Milisekund | Průměr | Metrika latence doručení směrování Dimenze slouží k identifikaci latence pro konkrétní koncový bod nebo pro konkrétní zdroj směrování. | RoutingSource, EndpointType, Název koncového bodu Další informace najdete v tématu Dimenze metrik. |
Směrování: Objekty blob doručované do úložiště | d2c.endpoints.egress.storage.blobs | Počet | Celkem | Kolikrát IoT Hub směrování objektů blob do koncových bodů úložiště. | Žádné |
Směrování: Data doručována do úložiště | d2c.endpoints.egress.storage.bytes | Bajty | Celkem | Množství dat (bajtů) IoT Hub směrování doručované do koncových bodů úložiště. | Žádné |
Směrování: latence zpráv pro službu Event Hubs | d2c.endpoints.latency.eventHubs | Milisekund | Průměr | Průměrná latence (v milisekundách) mezi příchozím přenosem dat zpráv do IoT Hub a příchozím přenosem zpráv do vlastních koncových bodů typu Event Hubs. Trasy zpráv do integrovaného koncového bodu (události) nejsou zahrnuté. | Žádné |
Směrování: latence zpráv pro frontu služby Service Bus | d2c.endpoints.latency.serviceBusQueues | Milisekund | Průměr | Průměrná latence (milisekundy) mezi příchozím přenosem dat zpráv do IoT Hub a příchozím přenosem zpráv do koncového bodu fronty služby Service Bus. | Žádné |
Směrování: latence zpráv pro téma služby Service Bus | d2c.endpoints.latency.serviceBusTopics | Milisekund | Průměr | Průměrná latence (milisekundy) mezi příchozím přenosem dat zpráv do IoT Hub a příchozím přenosem zpráv do koncového bodu tématu služby Service Bus. | Žádné |
Směrování: latence zpráv/událostí | d2c.endpoints.latency.builtIn.events | Milisekund | Průměr | Průměrná latence (v milisekundách) mezi příchozím přenosem dat zpráv do IoT Hub a příchozím přenosem zpráv do integrovaného koncového bodu (zprávy/události) a záložní trasou. | Žádné |
Směrování: latence zpráv pro úložiště | d2c.endpoints.latency.storage | Milisekund | Průměr | Průměrná latence (milisekundy) mezi příchozím přenosem dat zpráv do IoT Hub a příchozím přenosem zpráv do koncového bodu úložiště. | Žádné |
Směrování: zprávy doručované do služby Event Hubs | d2c.endpoints.egress.eventHubs | Počet | Celkem | Kolikrát IoT Hub úspěšně doručené zprávy do vlastních koncových bodů typu Event Hubs. Trasy zpráv do integrovaného koncového bodu (události) nejsou zahrnuté. | Žádné |
Směrování: zprávy doručované do fronty služby Service Bus | d2c.endpoints.egress.serviceBusQueues | Počet | Celkem | Kolikrát IoT Hub směrování úspěšně doručené zprávy do koncových bodů fronty služby Service Bus | Žádné |
Směrování: zprávy doručované do tématu služby Service Bus | d2c.endpoints.egress.serviceBusTopics | Počet | Celkem | Kolikrát IoT Hub směrování úspěšně doručených zpráv do koncových bodů témat služby Service Bus. | Žádné |
Směrování: zprávy doručované do záložní služby | d2c.telemetry.egress.fallback | Počet | Celkem | Kolikrát IoT Hub směrování zpráv doručovaných do koncového bodu přidruženého k náhradní trase. | Žádné |
Směrování: zprávy doručované do zpráv nebo událostí | d2c.endpoints.egress.builtIn.events | Počet | Celkem | Kolikrát IoT Hub směrování úspěšně doručí zprávy do integrovaného koncového bodu (zprávy/události) a záložní trasy. | Žádné |
Směrování: zprávy doručované do úložiště | d2c.endpoints.egress.storage | Počet | Celkem | Kolikrát IoT Hub směrování úspěšně doručené zprávy do koncových bodů úložiště | Žádné |
Směrování: Doručované telemetrické zprávy | d2c.telemetry.egress.success | Počet | Celkem | Počet úspěšných doručení zpráv do všech koncových bodů pomocí směrování IoT Hub. Pokud je zpráva směrována na více koncových bodů, zvýší se tato hodnota pro každé úspěšné doručení o jeden. Pokud je zpráva doručována do stejného koncového bodu vícekrát, tato hodnota se pro každé úspěšné doručení zvýší o jednu. | Žádné |
Směrování: Vyřazené zprávy telemetrie | d2c.telemetry.egress.dropped | Počet | Celkem | Počet vyřazení zpráv směrováním IoT Hub kvůli nedosaženým koncovým bodům. Tato hodnota nezapočítává zprávy doručené na záložní trasu, protože se tam nedoručují vynechané zprávy. | Žádné |
Směrování: Nekompatibilní zprávy telemetrie | d2c.telemetry.egress.invalid | Počet | Celkem | Kolikrát se IoT Hub směrování nepodařilo doručit zprávy kvůli nekompatibilitě s koncovým bodem. Zpráva není kompatibilní s koncovým bodem, když se Iot Hub pokusí zprávu doručit koncovému bodu a selže s nepředchýlnou chybou. Neplatné zprávy se neopakují. Tato hodnota nezahrnuje opakované pokusy. | Žádné |
Směrování: Osamocené telemetrické zprávy | d2c.telemetry.egress.orphaned | Počet | Celkem | Počet osamocených zpráv IoT Hub směrováním, protože neodpovídají žádnému dotazu směrování, když je záložní trasa zakázaná. | Žádné |
Pro metriky s jednotkovou hodnotou Count je platná pouze agregace celkového součtu. Minimální, maximální a průměrné agregace vždy vrátí hodnotu 1. Další informace najdete v tématu Podporované agregace.
Metriky dvojčete dotazů
Zobrazovaný název metriky | Metric | Jednotka | Typ agregace | Popis | Dimenze |
---|---|---|---|---|---|
Neúspěšné dotazy dvojčat | twinQueries.failure | Počet | Celkem | Počet všech neúspěšných dotazů dvojčat. | Žádné |
Úspěšné dotazy dvojčat | twinQueries.success | Počet | Celkem | Počet všech úspěšných dotazů dvojčat. | Žádné |
Velikost výsledku dotazů na dvojčata | twinQueries.resultSize | Bajty | Průměr | Celková velikost výsledku všech úspěšných dotazů dvojčat. | Žádné |
Pro metriky s hodnotou Unit (Počet) je platná pouze agregace celkového součtu( celkem). Agregace minimum, maximum a průměr vždy vrátí hodnotu 1. Další informace najdete v tématu Podporované agregace.
Rozměry metrik
Azure IoT Hub má k některým metrikám směrování a Event Gridu přidružené následující dimenze.
Název dimenze | Popis |
---|---|
Název koncového bodu | Název koncového bodu |
Typ koncového bodu | eventHubs, serviceBusQueues, cosmosDB, serviceBusTopics. builtin nebo blobStorage |
Eventtype | Microsoft.Devices.DeviceCreated. Microsoft.Devices.DeviceDeleted, Microsoft.Devices.DeviceConnected, Microsoft.Devices.DeviceDisconnected nebo Microsoft.Devices.DeviceTelemetry Další informace najdete v tématu Typy událostí. |
FailureReasonCategory | Jedna z následujících: neplatná, vyřazená, osamocené nebo null. |
Výsledek | Úspěch nebo neúspěch |
RoutingSource | Zprávy zařízení Události změny dvojčete Události životního cyklu zařízení |
Další informace o dimenzích metrik najdete v tématu Multidimenzionální metriky.
Protokoly prostředků
Tato část obsahuje seznam všech typů a schémat kategorií protokolu prostředků shromážděných pro Azure IoT Hub. Poskytovatel prostředků a typ pro všechny protokoly IoT Hub je Microsoft.Devices/IotHubs. Události se generují pouze pro chyby v některých kategoriích.
Témata v této části
- Připojení
- Telemetrie zařízení
- Příkazy cloud-zařízení
- Operace s identitou zařízení
- Operace nahrávání souborů
- Trasy
- Operace dvojčete zařízení-cloud
- Operace dvojčat typu cloud-zařízení
- Dotazy na dvojčata
- Operace úloh
- Přímé metody
- Distribuované trasování (Preview)
- Konfigurace
- Streamy zařízení (Preview)
Připojení
Kategorie připojení sleduje události připojení a odpojení zařízení od centra IoT a chyby. Tato kategorie je užitečná k identifikaci neoprávněných pokusů o připojení nebo k upozorňování na ztrátu připojení k zařízením.
Informace o spolehlivém stavu připojení zařízení najdete v tématu Monitorování stavu připojení zařízení.
{
"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"
}
]
}
Podrobné informace o používání protokolů připojení k monitorování připojení zařízení najdete v tématu Monitorování, diagnostika a řešení potíží s připojením zařízení k Azure IoT Hub.
Telemetrie zařízení
Kategorie telemetrie zařízení sleduje chyby, ke kterým dochází ve službě IoT Hub, a souvisí s kanálem telemetrie. Tato kategorie zahrnuje chyby, ke kterým dochází při odesílání událostí telemetrie (jako je omezování) a příjmu telemetrických událostí (například neautorizovaná čtečka). Tato kategorie nemůže zachytit chyby způsobené kódem spuštěným na samotném zařízení.
{
"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"
}
]
}
Příkazy cloud-zařízení
Kategorie příkazů cloud-zařízení sleduje chyby, ke kterým dochází ve službě IoT Hub, a souvisí s kanálem zpráv cloud-zařízení. Tato kategorie zahrnuje chyby, ke kterým dochází z:
- Odesílání zpráv typu cloud-zařízení (například chyby neoprávněného odesílatele),
- Příjem zpráv typu cloud-zařízení (například chyby překročení počtu doručení) a
- Příjem zpětné vazby zpráv typu cloud-zařízení (například chyby vypršení platnosti zpětné vazby)
Tato kategorie nezachytává chyby, když se zpráva z cloudu do zařízení úspěšně doručí, ale zařízení ji pak nesprávně zpracuje.
{
"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"
}
]
}
Operace s identitou zařízení
Kategorie operací identity zařízení sleduje chyby, ke kterým dochází při pokusu o vytvoření, aktualizaci nebo odstranění položky v registru identit služby IoT Hub. Sledování této kategorie je užitečné pro scénáře zřizování.
{
"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"
}
]
}
Operace nahrávání souborů
Kategorie nahrávání souborů sleduje chyby, ke kterým dochází ve službě IoT Hub, a souvisí s funkcí nahrávání souborů. Tato kategorie zahrnuje:
Chyby, ke kterým dochází u identifikátoru URI SAS, například když vyprší jeho platnost před tím, než zařízení oznámí centru dokončené nahrávání.
Neúspěšná nahrání nahlášená zařízením
Chyby, ke kterým dojde, když se v úložišti nenajde soubor během vytváření oznámení IoT Hub.
Tato kategorie nemůže zachytávat chyby, ke kterým přímo dochází, když zařízení nahrává soubor do úložiště.
{
"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"
}
]
}
Trasy
Kategorie směrování zpráv sleduje chyby, ke kterým dochází při vyhodnocování tras zpráv, a stav koncového bodu tak, jak ho IoT Hub. Tato kategorie zahrnuje události, jako jsou:
- Pravidlo se vyhodnotí jako nedefinované.
- IoT Hub označí koncový bod jako neaktivní nebo
- Všechny chyby přijaté z koncového bodu
Tato kategorie neobsahuje konkrétní chyby týkající se samotných zpráv (jako jsou chyby omezování zařízení), které se hlásí v kategorii Telemetrie zařízení.
{
"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"
}
]
}
Tady jsou další podrobnosti o protokolech směrování prostředků:
- Seznam kódů chyb protokolu prostředků směrování
- Seznam protokolů prostředků směrování – operationNames
Operace dvojčete zařízení-cloud
Kategorie operace dvojčete zařízení-cloud sleduje události iniciované zařízením ve dvojčatech zařízení. Mezi tyto operace patří získání dvojčete, aktualizace ohlášených vlastností a přihlášení k odběru požadovaných vlastností.
{
"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"
}
]
}
Operace dvojčat typu cloud-zařízení
Kategorie operací dvojčete typu cloud-zařízení sleduje události iniciované službou ve dvojčatech zařízení. Tyto operace můžou zahrnovat získání dvojčete, aktualizaci nebo nahrazení značek a aktualizaci nebo nahrazení požadovaných vlastností.
{
"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"
}
]
}
Dotazy na dvojčata
Kategorie dotazů dvojčete hlásí požadavky na dotazy na dvojčata zařízení, které se inicializovaly v cloudu.
{
"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"
}
]
}
Operace úloh
Kategorie operací úloh hlásí žádosti o úlohy pro aktualizaci dvojčat zařízení nebo vyvolání přímých metod na více zařízeních. Tyto požadavky se iniciují v cloudu.
{
"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"
}
]
}
Přímé metody
Kategorie přímé metody sleduje interakce požadavků a odpovědí odesílané do jednotlivých zařízení. Tyto požadavky se iniciují v cloudu.
{
"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"
}
]
}
Distribuované trasování (Preview)
Kategorie distribuovaného trasování sleduje ID korelace pro zprávy, které obsahují hlavičku kontextu trasování. Aby bylo možné plně povolit tyto protokoly, je potřeba aktualizovat kód na straně klienta podle pokynů v tématu Komplexní analýza a diagnostika aplikací IoT pomocí IoT Hub distribuovaného trasování (Preview).
Objekt correlationId
odpovídá návrhu kontextu trasování W3C , kde obsahuje trace-id
a span-id
.
IoT Hub protokoly D2C (zařízení-cloud)
IoT Hub zaznamenává tento protokol, když IoT Hub přijde zpráva obsahující platné vlastnosti trasování.
{
"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"
}
]
}
V této části se nepočítá, durationMs
protože hodiny IoT Hub nemusí být synchronizované s hodinami zařízení, a proto může být výpočet doby trvání zavádějící. K zachycení špiček latence zařízení-cloud doporučujeme napsat logiku pomocí časových razítek v properties
této části.
Vlastnost | Typ | Popis |
---|---|---|
messageSize | Integer | Velikost zpráv typu zařízení-cloud v bajtech |
Deviceid | Řetězec 7bitových alfanumerických znaků ASCII | Identita zařízení |
callerLocalTimeUtc | Časové razítko UTC | Čas vytvoření zprávy nahlášený místními hodinami zařízení |
calleeLocalTimeUtc | Časové razítko UTC | Čas doručení zprávy na bránu IoT Hub podle IoT Hub hodin služby |
IoT Hub protokolů příchozího přenosu dat
IoT Hub zaznamenává tento protokol, když zpráva obsahující platné vlastnosti trasování zapisuje do interního nebo integrovaného event hubs.
{
"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"
}
]
}
V části properties
tento protokol obsahuje další informace o příchozím přenosu dat zpráv.
Vlastnost | Typ | Popis |
---|---|---|
isRoutingEnabled | Řetězec | Hodnota true nebo false označuje, jestli je v IoT Hub povolené směrování zpráv. |
parentSpanId | Řetězec | Span-ID nadřazené zprávy, což by v tomto případě bylo trasování zpráv D2C. |
IoT Hub protokolů výchozího přenosu dat
IoT Hub zaznamenává tento protokol, když je povolené směrování a zpráva se zapisuje do koncového bodu. Pokud směrování není povolené, IoT Hub tento protokol nezaznamená.
{
"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"
}
]
}
V části properties
tento protokol obsahuje další informace o příchozím přenosu dat zpráv.
Vlastnost | Typ | Popis |
---|---|---|
název_koncového bodu | Řetězec | Název koncového bodu směrování |
endpointType | Řetězec | Typ koncového bodu směrování |
parentSpanId | Řetězec | Span-ID nadřazené zprávy, což by v tomto případě bylo trasování příchozích zpráv IoT Hub. |
Konfigurace
IoT Hub protokoly konfigurace sledují události a chyby sady funkcí Automatické Správa zařízení.
{
"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"
}
]
}
Streamy zařízení (Preview)
Kategorie streamů zařízení sleduje interakce požadavků a odpovědí odesílané do jednotlivých zařízení.
{
"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"
}
]
}
Tabulky protokolů služby Azure Monitor
Tato část odkazuje na všechny tabulky Kusto protokolů Azure Monitoru, které jsou relevantní pro Azure IoT Hub a jsou k dispozici pro dotazy log Analytics. Seznam těchto tabulek a odkazy na další informace o typu prostředku IoT Hub najdete v tématu IoT Hub v referenčních informacích k tabulce protokoly služby Azure Monitor.
Referenční informace o všech tabulkách protokolů služby Azure Monitor nebo Log Analytics najdete v referenčních informacích k tabulce protokolů služby Azure Monitor.
Viz také
- Popis Azure IoT Hub monitorování najdete v tématu Monitorování Azure IoT Hub.
- Podrobnosti o monitorování prostředků Azure najdete v tématu Monitorování prostředků Azure pomocí služby Azure Monitor .