Övervaka Azure IoT Hub datareferens

Information om hur du kommer igång med Azure-övervakning finns i Övervaka Azure IoT Hub för att förstå hur du samlar in och analyserar övervakningsdata för Azure IoT Hub.

Den här artikeln är en referens för implementering av Azure-övervakning.

De viktigaste avsnitten i den här referensartikeln:

• Mått: listor över IoT Hub plattformsmått efter ämne

• Måttdimensioner: dimensioner för routning och Event Grid-mått

• Resursloggar: loggar efter kategorityper och scheman som samlats in för Azure IoT Hub

• Tabeller för Azure Monitor-loggar: beskriver Kusto-tabeller för Azure Monitor-loggar

  Eller gå direkt till loggtabellreferensen för Azure Monitor.

Mått

I det här avsnittet visas alla automatiskt insamlade plattformsmått för Azure IoT Hub. Resursproviderns namnområde för IoT Hub mått är Microsoft.Devices och typen Namnområde är IoTHubs.

Följande underavsnitt visar IoT Hub plattformsmått efter allmän kategori och listmått efter deras visningsnamn som tilldelats i Azure Portal.

Du hittar också en enda tabell som visar alla IoT Hub plattformsmått efter måttnamn under Microsoft.Devices/IotHubs i Azure Monitor-dokumentationen. Den här tabellen innehåller inte all information, till exempel sammansättningar som stöds för vissa mått, som är tillgängliga i den här artikeln.

Mer information om mått som stöds av andra Azure-tjänster finns i Mått som stöds med Azure Monitor.

Ämnen i det här avsnittet

Välj ett ämne för att gå vidare till informationen på den här sidan.

• Sammansättningar som stöds
• Kommandomått för moln till enhet
• Mått för direktmetoder mellan moln och enhet
• Mått för åtgärder för moln-till-enhetstvillingar
• Konfigurationsmått
• Dagliga kvotmått
• Enhetsmått
• Mått för enhetstelemetri
• Mått för åtgärder mellan enheter och molntvillingar
• Event Grid-mått
• Jobbmått
• Routningsmått
• Tvillingfrågemått

Sammansättningar som stöds

Kolumnen Sammansättningstyp i varje tabell motsvarar den standardaggregering som används när måttet väljs för ett diagram eller en avisering.

För de flesta mått är alla sammansättningstyper giltiga. För antal mått med kolumnvärdet Antal enheter är dock endast vissa aggregeringar giltiga. Antalsmått kan vara en av två typer:

• För mått för antal enskilda punkter registrerar IoT Hub en enskild datapunkt (i princip en 1) varje gång den uppmätta åtgärden inträffar. Azure Monitor summerar sedan dessa datapunkter över den angivna kornigheten. Exempel på mått med en enda punkt är telemetrimeddelanden som skickas och C2D-meddelandeleveranser har slutförts. För dessa mått är den enda relevanta aggregeringstypen Total (summa). I portalen kan du välja minimum, maximum och average. Dessa värden är dock alltid 1.

• För mått för antal ögonblicksbilder registrerar IoT Hub ett totalt antal när den uppmätta åtgärden inträffar. För närvarande finns det tre mått för ögonblicksbilder som genereras av IoT Hub: Totalt antal meddelanden som används, Totalt antal enheter och Anslutna enheter. Eftersom dessa mått visar en "total" kvantitet varje gång de genereras, är det inte meningsfullt att summera dem över den angivna kornigheten. Azure Monitor begränsar dig till att välja medelvärde, minimum och maximum för aggregeringstypen för dessa mått.

Kommandomått för moln till enhet

Måttvisningsnamn	Metric	Enhet	Sammansättningstyp	Beskrivning	Dimensioner
C2D-meddelanden har upphört att gälla	C2DMessagesExpired	Antal	Totalt	Antal meddelanden från molnet till enheten som upphört att gälla	Ingen
C2D-meddelandeleveranser har slutförts	c2d.commands.egress.complete.success	Antal	Totalt	Antal meddelanden från moln till enhet som har slutförts av enheten	Ingen
C2D-meddelanden övergivna	c2d.commands.egress.abandon.success	Antal	Totalt	Antal meddelanden från moln till enhet som övergivits av enheten	Ingen
C2D-meddelanden avvisas	c2d.commands.egress.reject.success	Antal	Totalt	Antal meddelanden från molnet till enheten som avvisas av enheten	Ingen

För mått med enhetsvärdetAntal är endast total (summa) aggregering giltig. Minsta, högsta och genomsnittliga sammansättningar returnerar alltid 1. Mer information finns i Sammansättningar som stöds.

Mått för direktmetoder mellan moln och enhet

Måttvisningsnamn	Metric	Enhet	Sammansättningstyp	Beskrivning	Dimensioner
Misslyckade direktmetodanrop	c2d.methods.failure	Antal	Totalt	Antalet misslyckade direktmetodanrop.	Ingen
Begärandestorlek för direktmetodanrop	c2d.methods.requestSize	Byte	Genomsnitt	Antalet lyckade direktmetodbegäranden.	Ingen
Svarsstorlek för direktmetodanrop	c2d.methods.responseSize	Byte	Genomsnitt	Antalet lyckade direktmetodsvar.	Ingen
Lyckade direktmetodanrop	c2d.methods.success	Antal	Totalt	Antalet lyckade direktmetodanrop.	Ingen

För mått med enhetsvärdetAntal är endast total (summa) aggregering giltig. Minsta, högsta och genomsnittliga sammansättningar returnerar alltid 1. Mer information finns i Sammansättningar som stöds.

Mått för åtgärder för moln-till-enhetstvillingar

Måttvisningsnamn	Metric	Enhet	Sammansättningstyp	Beskrivning	Dimensioner
Misslyckade tvillingläsningar från serverdelen	c2d.twin.read.failure	Antal	Totalt	Antalet misslyckade backend-initierade tvillingläsningar.	Ingen
Misslyckade tvillinguppdateringar från serverdelen	c2d.twin.update.failure	Antal	Totalt	Antalet misslyckade serverdelsinitierade tvillinguppdateringar.	Ingen
Svarsstorlek för tvillingläsningar från serverdelen	c2d.twin.read.size	Byte	Genomsnitt	Antalet lyckade backend-initierade tvillingläsningar.	Ingen
Storleken på tvillinguppdateringar från serverdelen	c2d.twin.update.size	Byte	Genomsnitt	Den totala storleken på alla lyckade serverdelsinitierade tvillinguppdateringar.	Ingen
Lyckade tvillingläsningar från serverdelen	c2d.twin.read.success	Antal	Totalt	Antalet lyckade backend-initierade tvillingläsningar.	Ingen
Lyckade tvillinguppdateringar från serverdelen	c2d.twin.update.success	Antal	Totalt	Antalet lyckade serverdelsinitierade tvillinguppdateringar.	Ingen

För mått med enhetsvärdetAntal är endast total (summa) aggregering giltig. Minsta, högsta och genomsnittliga sammansättningar returnerar alltid 1. Mer information finns i Sammansättningar som stöds.

Konfigurationsmått

Måttvisningsnamn	Metric	Enhet	Sammansättningstyp	Beskrivning	Dimensioner
Konfigurationsmått	Konfigurationer	Antal	Totalt	Antal totala CRUD-åtgärder som utförts för enhetskonfiguration och IoT Edge distribution på en uppsättning målenheter. Här ingår antalet åtgärder som ändrar enhetstvillingen eller modultvillingen på grund av dessa konfigurationer.	Ingen

För mått med enhetsvärdetAntal är endast total (summa) aggregering giltig. Minsta, högsta och genomsnittliga sammansättningar returnerar alltid 1. Mer information finns i Sammansättningar som stöds.

Dagliga kvotmått

Måttvisningsnamn	Metric	Enhet	Sammansättningstyp	Beskrivning	Dimensioner
Total användning av enhetsdata	deviceDataUsage	Byte	Totalt	Byte som överförs till och från enheter som är anslutna till IotHub	Ingen
Total användning av enhetsdata (förhandsversion)	deviceDataUsageV2	Byte	Totalt	Byte som överförs till och från enheter som är anslutna till IotHub	Ingen
Totalt antal meddelanden som används	dailyMessageQuotaUsed	Antal	Genomsnitt	Antal meddelanden som används i dag. Ett kumulativt värde som återställs till noll vid 00:00 UTC varje dag.	Ingen

För Totalt antal meddelanden som används stöds endast lägsta, högsta och genomsnittliga aggregeringar. Mer information finns i Sammansättningar som stöds.

Enhetsmått

Visningsnamn för mått	Metric	Enhet	Sammansättningstyp	Beskrivning	Dimensioner
Totalt antal enheter (inaktuell)	devices.totalDevices	Antal	Totalt	Antal enheter som är registrerade på din IoT-hubb	Ingen
Anslutna enheter (inaktuella)	devices.connectedDevices.allProtocol	Antal	Totalt	Antal enheter som är anslutna till din IoT-hubb	Ingen
Totalt antal enheter	totalDeviceCount	Antal	Genomsnitt	Antal enheter som är registrerade på din IoT-hubb	Ingen
Anslutna enheter	connectedDeviceCount	Antal	Genomsnitt	Antal enheter som är anslutna till din IoT-hubb	Ingen

För Totalt antal enheter (inaktuella) och Anslutna enheter (inaktuella) är endast total (summa) aggregering giltig. Minsta, högsta och genomsnittliga aggregeringar returnerar alltid 1. Mer information finns i Sammansättningar som stöds.

För Totalt antal enheter och Anslutna enheter är endast lägsta, högsta och genomsnittliga aggregeringar giltiga. Mer information finns i Sammansättningar som stöds.

Totalt antal enheter och Anslutna enheter kan inte exporteras via diagnostikinställningar.

Mått för enhetstelemetri

Visningsnamn för mått	Metric	Enhet	Sammansättningstyp	Beskrivning	Dimensioner
Antal begränsningsfel	d2c.telemetry.ingress.sendThrottle	Antal	Totalt	Antal begränsningsfel på grund av enhetsgenomflödesbegränsningar	Ingen
Försök att skicka meddelanden med telemetri	d2c.telemetry.ingress.allProtocol	Antal	Totalt	Antal telemetrimeddelanden från enhet till moln som försökt skickas till din IoT-hubb	Ingen
Skickade telemetrimeddelanden	d2c.telemetry.ingress.success	Antal	Totalt	Antal telemetrimeddelanden från enhet till moln som skickats till din IoT-hubb	Ingen

För mått med enhetsvärdetAntal är endast total (summa) aggregering giltig. Minsta, högsta och genomsnittliga aggregeringar returnerar alltid 1. Mer information finns i Sammansättningar som stöds.

Mått för åtgärder mellan enheter och molntvillingar

Visningsnamn för mått	Metric	Enhet	Sammansättningstyp	Beskrivning	Dimensioner
Misslyckade tvillingläsningar från enheter	d2c.twin.read.failure	Antal	Totalt	Antalet misslyckade enhetsinitierade tvillingläsningar.	Ingen
Misslyckade tvillinguppdateringar från enheter	d2c.twin.update.failure	Antal	Totalt	Antalet misslyckade enhetsinitierade tvillinguppdateringar.	Ingen
Svarsstorlek för tvillingläsningar från enheter	d2c.twin.read.size	Byte	Genomsnitt	Antalet lyckade enhetsinitierade tvillingläsningar.	Ingen
Storleken på tvillinguppdateringar från enheter	d2c.twin.update.size	Byte	Genomsnitt	Den totala storleken på alla lyckade enhetsinitierade tvillinguppdateringar.	Ingen
Lyckade tvillingläsningar från enheter	d2c.twin.read.success	Antal	Totalt	Antalet lyckade enhetsinitierade tvillingläsningar.	Ingen
Lyckade tvillinguppdateringar från enheter	d2c.twin.update.success	Antal	Totalt	Antalet lyckade enhetsinitierade tvillinguppdateringar.	Ingen

För mått med enhetsvärdetAntal är endast total (summa) aggregering giltig. Minsta, högsta och genomsnittliga aggregeringar returnerar alltid 1. Mer information finns i Sammansättningar som stöds.

Event Grid-mått

Visningsnamn för mått	Metric	Enhet	Sammansättningstyp	Beskrivning	Dimensioner
Event Grid-leveranser	EventGridDeliveries	Antal	Totalt	Antalet IoT Hub händelser som publicerats i Event Grid. Använd måttet Resultat för antalet lyckade och misslyckade begäranden. Dimensionen EventType visar typen av händelse (https://aka.ms/ioteventgrid).	Resultat, Eventtype Mer information finns i Måttdimensioner.
Event Grid-svarstid	EventGridLatency	Millisekunder	Genomsnitt	Den genomsnittliga svarstiden (millisekunder) från när Iot Hub-händelsen genererades till när händelsen publicerades till Event Grid. Det här talet är ett genomsnitt mellan alla händelsetyper. Använd dimensionen EventType för att se svarstiden för en viss typ av händelse.	Eventtype Mer information finns i Måttdimensioner.

För mått med enhetsvärdetAntal är endast total (summa) aggregering giltig. Minsta, högsta och genomsnittliga aggregeringar returnerar alltid 1. Mer information finns i Sammansättningar som stöds.

Jobbmått

Visningsnamn för mått	Metric	Enhet	Sammansättningstyp	Beskrivning	Dimensioner
Slutförda jobb	jobs.completed	Antal	Totalt	Antalet slutförda jobb.	Ingen
Misslyckade anrop till listjobb	jobs.listJobs.failure	Antal	Totalt	Antalet misslyckade anrop till listjobb.	Ingen
Det gick inte att skapa metodanropsjobb	jobs.createDirectMethodJob.failure	Antal	Totalt	Antalet misslyckade skapande av direktmetodanropsjobb.	Ingen
Det gick inte att skapa tvillinguppdateringsjobb	jobs.createTwinUpdateJob.failure	Antal	Totalt	Antalet misslyckade skapande av tvillinguppdateringsjobb.	Ingen
Misslyckade uppsägningar av jobb	jobs.cancelJob.failure	Antal	Totalt	Antalet misslyckade anrop för att avbryta ett jobb.	Ingen
Misslyckade jobbfrågor	jobs.queryJobs.failure	Antal	Totalt	Antalet misslyckade anrop till frågejobb.	Ingen
Misslyckade jobb	jobs.failed	Antal	Totalt	Antalet misslyckade jobb.	Ingen
Lyckade anrop till listjobb	jobs.listJobs.success	Antal	Totalt	Antalet lyckade anrop till listjobb.	Ingen
Lyckade skapanden av metodanropsjobb	jobs.createDirectMethodJob.success	Antal	Totalt	Antalet lyckade skapande av direktmetodanropsjobb.	Ingen
Lyckade skapanden av tvillinguppdateringsjobb	jobs.createTwinUpdateJob. lyckades	Antal	Totalt	Antalet lyckade skapande av tvillinguppdateringsjobb.	Ingen
Lyckade uppsägningar av jobb	jobs.cancelJob.success	Antal	Totalt	Antalet lyckade anrop för att avbryta ett jobb.	Ingen
Lyckade jobbfrågor	jobs.queryJobs.success	Antal	Totalt	Antalet lyckade anrop för att fråga jobb.	Ingen

För mått med enhetsvärdetAntal är endast total (summa) aggregering giltig. Minsta, högsta och genomsnittliga sammansättningar returnerar alltid 1. Mer information finns i Sammansättningar som stöds.

Routningsmått

Måttvisningsnamn	Metric	Enhet	Sammansättningstyp	Beskrivning	Dimensioner
Routningsleveranser (förhandsversion)	RoutningDeliveries	Antal	Totalt	Måttet för routningsleverans. Använd dimensionerna för att identifiera leveransstatus för en specifik slutpunkt eller för en specifik routningskälla.	Resultat, RoutingSource, EndpointType, FailureReasonCategory, EndpointName Mer information finns i Måttdimensioner.
Meddelandestorlek för routningsleverans i byte (förhandsversion)	RoutingDataSizeInBytesDelivered	Byte	Totalt	Det totala antalet byte som dirigeras av IoT Hub till anpassad slutpunkt och inbyggd slutpunkt. Använd dimensionerna för att identifiera datastorlek som dirigeras till en specifik slutpunkt eller för en specifik routningskälla.	RoutingSource, EndpointType EndpointName Mer information finns i Måttdimensioner.
Svarstid för routningsleverans (förhandsversion)	RoutingDeliveryLatency	Millisekunder	Genomsnitt	Måttet för svarstid för routningsleverans. Använd dimensionerna för att identifiera svarstiden för en specifik slutpunkt eller för en specifik routningskälla.	RoutingSource, EndpointType, EndpointName Mer information finns i Måttdimensioner.
Routning: blobar som levereras till lagring	d2c.endpoints.egress.storage.blobs	Antal	Totalt	Antalet gånger IoT Hub att routning levererade blobar till lagringsslutpunkter.	Ingen
Routning: data som levereras till lagring	d2c.endpoints.egress.storage.bytes	Byte	Totalt	Mängden data (byte) IoT Hub routning som levereras till lagringsslutpunkter.	Ingen
Routning: meddelandefördröjning för Event Hubs	d2c.endpoints.latency.eventHubs	Millisekunder	Genomsnitt	Den genomsnittliga svarstiden (millisekunder) mellan meddelandeingressen till IoT Hub och meddelandeingressen till anpassade slutpunkter av typen Event Hubs. Meddelandevägar till den inbyggda slutpunkten (händelser) ingår inte.	Ingen
Routning: meddelandefördröjning för Service Bus-kö	d2c.endpoints.latency.serviceBusQueues	Millisekunder	Genomsnitt	Den genomsnittliga svarstiden (millisekunder) mellan meddelandeingressen till IoT Hub och meddelandeingressen till en Service Bus-köslutpunkt.	Ingen
Routning: meddelandefördröjning för Service Bus-ämne	d2c.endpoints.latency.serviceBusTopics	Millisekunder	Genomsnitt	Den genomsnittliga svarstiden (millisekunder) mellan meddelandeingressen till IoT Hub och meddelandeingressen till en Service Bus-ämnesslutpunkt.	Ingen
Routning: meddelandefördröjning för meddelanden/händelser	d2c.endpoints.latency.builtIn.events	Millisekunder	Genomsnitt	Den genomsnittliga svarstiden (millisekunder) mellan meddelandeingressen till IoT Hub och meddelandeingressen till den inbyggda slutpunkten (meddelanden/händelser) och återställningsvägen.	Ingen
Routning: meddelandefördröjning för lagring	d2c.endpoints.latency.storage	Millisekunder	Genomsnitt	Den genomsnittliga svarstiden (millisekunder) mellan meddelandeingressen till IoT Hub och meddelandeingressen till en lagringsslutpunkt.	Ingen
Routning: meddelanden som levereras till Event Hubs	d2c.endpoints.egress.eventHubs	Antal	Totalt	Antalet gånger IoT Hub att routning har levererat meddelanden till anpassade slutpunkter av typen Event Hubs. Meddelandevägar till den inbyggda slutpunkten (händelser) ingår inte.	Ingen
Routning: meddelanden som levereras till Service Bus-kön	d2c.endpoints.egress.serviceBusQueues	Antal	Totalt	Antalet gånger IoT Hub routning har levererat meddelanden till Service Bus-köslutpunkter.	Ingen
Routning: meddelanden som levereras till Service Bus-ämnet	d2c.endpoints.egress.serviceBusTopics	Antal	Totalt	Antalet gånger IoT Hub routning har levererat meddelanden till Service Bus-ämnesslutpunkter.	Ingen
Routning: meddelanden som levereras till återställning	d2c.telemetry.egress.fallback	Antal	Totalt	Antalet gånger IoT Hub routning levererade meddelanden till slutpunkten som är associerad med återställningsvägen.	Ingen
Routning: meddelanden som levereras till meddelanden/händelser	d2c.endpoints.egress.builtIn.events	Antal	Totalt	Antalet gånger IoT Hub routning har levererat meddelanden till den inbyggda slutpunkten (meddelanden/händelser) och återställningsvägen.	Ingen
Routning: meddelanden som levereras till lagring	d2c.endpoints.egress.storage	Antal	Totalt	Antalet gånger IoT Hub routning har levererat meddelanden till lagringsslutpunkter.	Ingen
Routning: telemetrimeddelanden levereras	d2c.telemetry.egress.success	Antal	Totalt	Antalet gånger meddelanden har levererats till alla slutpunkter med hjälp av IoT Hub routning. Om ett meddelande dirigeras till flera slutpunkter ökar det här värdet med en för varje lyckad leverans. Om ett meddelande levereras till samma slutpunkt flera gånger ökar det här värdet med ett för varje lyckad leverans.	Ingen
Routning: telemetrimeddelanden har släppts	d2c.telemetry.egress.dropped	Antal	Totalt	Antalet gånger meddelanden togs bort av IoT Hub routning på grund av döda slutpunkter. Det här värdet räknar inte meddelanden som levereras till återställningsvägen eftersom borttagna meddelanden inte levereras där.	Ingen
Routning: telemetrimeddelanden är inkompatibla	d2c.telemetry.egress.invalid	Antal	Totalt	Antalet gånger IoT Hub routning inte kunde leverera meddelanden på grund av en inkompatibilitet med slutpunkten. Ett meddelande är inte kompatibelt med en slutpunkt när Iot Hub försöker leverera meddelandet till en slutpunkt och det misslyckas med ett icke-tillfälligt fel. Ogiltiga meddelanden prövas inte igen. Det här värdet innehåller inte återförsök.	Ingen
Routning: telemetrimeddelanden överblivna	d2c.telemetry.egress.orphaned	Antal	Totalt	Antalet gånger meddelanden överblivnas av IoT Hub routning eftersom de inte matchade någon routningsfråga när återställningsvägen är inaktiverad.	Ingen

För mått med enhetsvärdetAntal är endast total (summa) aggregering giltig. Minsta, högsta och genomsnittliga sammansättningar returnerar alltid 1. Mer information finns i Sammansättningar som stöds.

Tvillingfrågemått

Måttvisningsnamn	Metric	Enhet	Sammansättningstyp	Beskrivning	Dimensioner
Misslyckade tvillingfrågor	twinQueries.failure	Antal	Totalt	Antalet misslyckade tvillingfrågor.	Ingen
Lyckade tvillingfrågor	twinQueries.success	Antal	Totalt	Antalet lyckade tvillingfrågor.	Ingen
Resultatstorlek för tvillingfrågor	twinQueries.resultSize	Byte	Genomsnitt	Summan av resultatstorleken för alla lyckade tvillingfrågor.	Ingen

För mått med enhetsvärdetAntal är endast total (summa) aggregering giltig. Minsta, högsta och genomsnittliga sammansättningar returnerar alltid 1. Mer information finns i Sammansättningar som stöds.

Måttdimensioner

Azure IoT Hub har följande dimensioner associerade med några av dess routnings- och Event Grid-mått.

Dimensionsnamn	Beskrivning
EndpointName	Slutpunktsnamnet
EndpointType	eventHubs, serviceBusQueues, cosmosDB, serviceBusTopics. builtin eller blobStorage
Eventtype	Microsoft.Devices.DeviceCreated. Microsoft.Devices.DeviceDeleted, Microsoft.Devices.DeviceConnected, Microsoft.Devices.DeviceDisconnected eller Microsoft.Devices.DeviceTelemetry Mer information finns i Händelsetyper.
FailureReasonCategory	Något av följande: ogiltigt, borttaget, överblivet eller null.
Resultat	Antingen lyckades eller misslyckades
RoutingSource	Enhetsmeddelanden Ändringshändelser för tvilling Händelser i enhetens livscykel

Mer information om måttdimensioner finns i Flerdimensionella mått.

Resursloggar

I det här avsnittet visas alla typer av resursloggkategorier och scheman som samlas in för Azure IoT Hub. Resursprovidern och typen för alla IoT Hub loggar är Microsoft.Devices/IotHubs. Händelser genereras endast för fel i vissa kategorier.

Ämnen i det här avsnittet

• Anslutningar
• Enhetstelemetri
• Moln till enhet-kommandon
• Enhetsidentitetsåtgärder
• Filöverföringsåtgärder
• Vägar
• Åtgärder för enhets-till-moln-tvilling
• Åtgärder för moln-till-enhet-tvilling
• Tvillingfrågor
• Jobbåtgärder
• Direktmetoder
• Distribuerad spårning (förhandsversion)
  • IoT Hub D2C-loggar (enhet till moln)
  • IoT Hub inkommande loggar
  • IoT Hub utgående loggar
• Konfigurationer
• Enhetsströmmar (förhandsversion)

Anslutningar

Anslutningskategorin spårar enhetsanslutnings- och frånkopplingshändelser från en IoT-hubb och fel. Den här kategorin är användbar för att identifiera obehöriga anslutningsförsök och eller aviseringar när du förlorar anslutningen till enheter.

Tillförlitlig anslutningsstatus för enheter finns i Övervaka enhetens anslutningsstatus.

{
   "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"
        }
    ]
}

Detaljerad information om hur du använder anslutningsloggar för att övervaka enhetsanslutningen finns i Övervaka, diagnostisera och felsöka enhetsanslutningar till Azure IoT Hub.

Enhetstelemetri

Kategorin enhetstelemetri spårar fel som inträffar vid IoT-hubben och som är relaterade till telemetripipelinen. Den här kategorin innehåller fel som inträffar när telemetrihändelser skickas (till exempel begränsning) och tar emot telemetrihändelser (till exempel obehörig läsare). Den här kategorin kan inte identifiera fel som orsakas av kod som körs på själva enheten.

{
    "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"
        }
    ]
}

Moln till enhet-kommandon

Kategorin kommandon från moln till enhet spårar fel som inträffar på IoT-hubben och som är relaterade till meddelandepipelinen från moln till enhet. Den här kategorin innehåller fel som inträffar från:

• Skicka meddelanden från molnet till enheten (till exempel otillåtna avsändarfel)
• Ta emot meddelanden från moln till enhet (till exempel att leveransantalet överskred fel) och
• Få feedback om meddelanden från moln till enhet (till exempel att feedback upphörde att gälla).

Den här kategorin fångar inte upp fel när meddelandet från moln till enhet levereras utan hanteras felaktigt av enheten.

{
    "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"
        }
    ]
}

Enhetsidentitetsåtgärder

Kategorin enhetsidentitetsåtgärder spårar fel som uppstår när du försöker skapa, uppdatera eller ta bort en post i IoT-hubbens identitetsregister. Att spåra den här kategorin är användbart för etableringsscenarier.

{
    "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"
        }
    ]
}

Filöverföringsåtgärder

Filuppladdningskategorin spårar fel som inträffar på IoT-hubben och är relaterade till filuppladdningsfunktioner. Den här kategorin omfattar:

• Fel som uppstår med SAS-URI:n, till exempel när den upphör att gälla innan en enhet meddelar hubben för en slutförd uppladdning.

• Misslyckade uppladdningar som rapporterats av enheten.

• Fel som uppstår när en fil inte hittas i lagringen när IoT Hub meddelande skapas.

Den här kategorin kan inte fånga upp fel som inträffar direkt när enheten laddar upp en fil till lagring.

{
    "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"
        }
    ]
}

Vägar

Kategorin för meddelanderoutning spårar fel som inträffar under utvärdering av meddelandevägar och slutpunktshälsa enligt IoT Hub. Den här kategorin innehåller händelser som:

• En regel utvärderas till "odefinierad",
• IoT Hub markerar en slutpunkt som död, eller
• Eventuella fel som tas emot från en slutpunkt.

Den här kategorin innehåller inte specifika fel om själva meddelandena (till exempel enhetsbegränsningsfel), som rapporteras under kategorin "enhetstelemetri".

{
    "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"
        }
    ]
}

Här är mer information om routning av resursloggar:

• Lista över felkoder för routningsresurslogg
• Lista över operationsnamn för routningsresursloggar

Åtgärder för enhets-till-moln-tvilling

Åtgärdskategorin enhets-till-moln-tvilling spårar enhetsinitierade händelser på enhetstvillingar. Dessa åtgärder kan omfatta hämta tvilling, uppdatera rapporterade egenskaper och prenumerera på önskade egenskaper.

{
    "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"
        }
    ]
}

Åtgärder för moln-till-enhet-tvilling

Åtgärdskategorin moln-till-enhet-tvilling spårar tjänstinitierade händelser på enhetstvillingar. Dessa åtgärder kan omfatta hämta tvilling, uppdatera eller ersätta taggar och uppdatera eller ersätta önskade egenskaper.

{
    "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"
        }
    ]
}

Tvillingfrågor

Tvillingen frågar kategorirapporter om frågebegäranden för enhetstvillingar som initieras i molnet.

{
    "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"
        }
    ]
}

Jobbåtgärder

Kategorin jobbåtgärder rapporterar om jobbbegäranden om att uppdatera enhetstvillingar eller anropa direktmetoder på flera enheter. Dessa begäranden initieras i molnet.

{
    "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"
        }
    ]
}

Direktmetoder

Kategorin direkta metoder spårar interaktioner mellan begäranden och svar som skickas till enskilda enheter. Dessa begäranden initieras i molnet.

{
    "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"
        }
    ]
}

Distribuerad spårning (förhandsversion)

Den distribuerade spårningskategorin spårar korrelations-ID:t för meddelanden som bär spårningskontextrubriken. För att de här loggarna ska kunna aktiveras fullt ut måste koden på klientsidan uppdateras genom att följa Analysera och diagnostisera IoT-program från slutpunkt till slutpunkt med IoT Hub distribuerad spårning (förhandsversion).

Överensstämmer correlationId med W3C Trace Context-förslaget , där det innehåller en trace-id och en span-id.

IoT Hub D2C-loggar (enhet till moln)

IoT Hub registrerar den här loggen när ett meddelande som innehåller giltiga spårningsegenskaper kommer till 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"
        }
    ]
}

durationMs Här beräknas inte eftersom IoT Hub klocka kanske inte är synkroniserad med enhetens klocka, och därför kan en varaktighetsberäkning vara vilseledande. Vi rekommenderar att du skriver logik med hjälp av tidsstämplarna properties i avsnittet för att samla in toppar i svarstid från enhet till moln.

Egenskap	Typ	Beskrivning
messageSize	Integer	Storleken på meddelande från enhet till moln i byte
Deviceid	Sträng med 7-bitars alfanumeriska ASCII-tecken	Enhetens identitet
callerLocalTimeUtc	UTC-tidsstämpel	Skapandetiden för meddelandet enligt rapporten från enhetens lokala klocka
calleeLocalTimeUtc	UTC-tidsstämpel	Tidpunkten för meddelandets ankomst till IoT Hub gateway enligt IoT Hub klockan på tjänstsidan

IoT Hub inkommande loggar

IoT Hub registrerar den här loggen när ett meddelande som innehåller giltiga spårningsegenskaper skriver till interna eller inbyggda Händelsehubbar.

{
    "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"
        }
    ]
}

I avsnittet properties innehåller den här loggen ytterligare information om inkommande meddelanden.

Egenskap	Typ	Beskrivning
isRoutingEnabled	Sträng	Antingen sant eller falskt anger om meddelanderoutning är aktiverat i IoT Hub
parentSpanId	Sträng	Span-id för det överordnade meddelandet, som skulle vara D2C-meddelandespårningen i det här fallet

IoT Hub utgående loggar

IoT Hub registrerar den här loggen när routning är aktiverad och meddelandet skrivs till en slutpunkt. Om routning inte är aktiverat registrerar IoT Hub inte den här loggen.

{
    "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"
        }
    ]
}

I avsnittet properties innehåller den här loggen ytterligare information om inkommande meddelanden.

Egenskap	Typ	Beskrivning
endpointName	Sträng	Namnet på routningsslutpunkten
endpointType	Sträng	Typ av routningsslutpunkt
parentSpanId	Sträng	Span-id för det överordnade meddelandet, vilket skulle vara den IoT Hub inkommande meddelandespårningen i det här fallet

Konfigurationer

IoT Hub konfigurationsloggar spårar händelser och fel för funktionen Automatisk Enhetshantering.

{
    "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"
         }
    ]
}

Enhetsströmmar (förhandsversion)

Kategorin enhetsströmmar spårar interaktioner mellan begäranden och svar som skickas till enskilda enheter.

{
    "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"
         }
    ]
}

Tabeller för Azure Monitor-loggar

Det här avsnittet refererar till alla Kusto-tabeller för Azure Monitor-loggar som är relevanta för Azure IoT Hub och som är tillgängliga för frågor från Log Analytics. En lista över dessa tabeller och länkar till mer information om IoT Hub resurstyp finns i IoT Hub i tabellreferensen för Azure Monitor-loggar.

En referens till alla Azure Monitor-loggar/Log Analytics-tabeller finns i Referens för Loggtabell för Azure Monitor.

Se även

• En beskrivning av Azure IoT Hub finns i Övervaka Azure IoT Hub.
• Mer information om övervakning av Azure-resurser finns i Övervaka Azure-resurser med Azure Monitor .