Referenční informace k datům monitorování Azure IoT Hub

  • Článek

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

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

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.

Snímek obrazovky znázorňující agregaci metrik

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í

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ů:

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é