Naslaginformatie over Azure IoT Hub controleren

  • Artikel

Zie Azure IoT Hub bewaken om aan de slag te gaan met Azure-bewaking om te begrijpen hoe u bewakingsgegevens voor Azure IoT Hub verzamelt en analyseert.

Dit artikel is een referentie voor het implementeren van Azure-bewaking.

De belangrijkste secties in dit naslagartikel:

Metrische gegevens

In deze sectie vindt u alle automatisch verzamelde platformgegevens voor Azure IoT Hub. De naamruimte van de resourceprovider voor IoT Hub metrische gegevens is Microsoft.Devices en het type Naamruimte is IoTHubs.

De volgende subsecties tonen de IoT Hub metrische platformgegevens per algemene categorie en vermelden metrische gegevens op basis van hun weergavenaam zoals toegewezen in de Azure Portal.

U vindt ook één tabel met alle metrische gegevens van het IoT Hub-platform op metrische naam onder Microsoft.Devices/IotHubs in de Documentatie van Azure Monitor. Deze tabel bevat niet alle informatie, zoals ondersteunde aggregaties voor sommige metrische gegevens, die in dit artikel beschikbaar zijn.

Zie Ondersteunde metrische gegevens met Azure Monitor voor meer informatie over metrische gegevens die worden ondersteund door andere Azure-services.

Onderwerpen in dit gedeelte

Selecteer een onderwerp om naar de informatie op deze pagina te gaan.

Ondersteunde aggregaties

De kolom Aggregatietype in elke tabel komt overeen met de standaardaggregatie die wordt gebruikt wanneer de metrische waarde wordt geselecteerd voor een grafiek of waarschuwing.

Schermopname van aggregatie voor metrische gegevens

Voor de meeste metrische gegevens zijn alle aggregatietypen geldig; Voor metrische gegevens voor tellingen met de kolomWaarde Eenheid van Aantal zijn echter slechts enkele aggregaties geldig. Metrische gegevens voor tellingen kunnen uit twee typen worden gerekend:

  • Voor metrische gegevens over het aantal één punten registreert IoT Hub één gegevenspunt (in feite een 1) telkens wanneer de gemeten bewerking plaatsvindt. Azure Monitor telt deze gegevenspunten vervolgens op over de opgegeven granulariteit. Voorbeelden van metrische gegevens met één punt zijn verzonden telemetrieberichten en C2D-berichtleveringen voltooid. Voor deze metrische gegevens is het enige relevante aggregatietype Totaal (Som). In de portal kunt u minimum, maximum en gemiddelde kiezen; Deze waarden zijn echter altijd 1.

  • Voor metrische gegevens van het aantal momentopnamen registreert IoT Hub een totaalaantal wanneer de gemeten bewerking plaatsvindt. Op dit moment worden er drie momentopnamegegevens verzonden door IoT Hub: Totaal aantal gebruikte berichten, Totaal aantal apparaten en Verbonden apparaten. Omdat deze metrische gegevens elke keer dat ze worden verzonden een 'totale' hoeveelheid bieden, heeft het geen zin om ze op te sommen over de opgegeven granulariteit. Azure Monitor beperkt u tot het selecteren van gemiddelde, minimum en maximum voor het aggregatietype voor deze metrische gegevens.

Metrische gegevens van cloud-naar-apparaat-opdrachten

Weergavenaam van metrische gegevens Metrisch Eenheid Aggregatietype Description Dimensies
C2D-berichten verlopen C2DMessagesExpired Aantal Totaal Aantal verlopen cloud-naar-apparaat-berichten Geen
C2D-berichtleveringen voltooid c2d.commands.egress.complete.success Aantal Totaal Het aantal leveringen van cloud-naar-apparaat-berichten is voltooid door het apparaat Geen
C2D-berichten afgestaan c2d.commands.egress.abandon.success Aantal Totaal Aantal cloud-naar-apparaat-berichten dat door het apparaat is verlaten Geen
C2D-berichten geweigerd c2d.commands.egress.reject.success Aantal Totaal Aantal cloud-naar-apparaat-berichten geweigerd door het apparaat Geen

Voor metrische gegevens met een eenheidswaardevan Aantal is alleen de aggregatie totaal (som) geldig. Minimum-, maximum- en gemiddeldeaggregaties retourneren altijd 1. Zie Ondersteunde aggregaties voor meer informatie.

Metrische gegevens over directe methoden van cloud-naar-apparaat

Weergavenaam van metrische gegevens Metrisch Eenheid Aggregatietype Description Dimensies
Mislukte directe methode-aanroepen c2d.methods.failure Aantal Totaal Het aantal mislukte directe methode-aanroepen. Geen
Aanvraaggrootte van aanroepen van directe methoden c2d.methods.requestSize Bytes Gemiddeld Het aantal geslaagde aanvragen voor directe methoden. Geen
Antwoordgrootte van aanroepen van directe methoden c2d.methods.responseSize Bytes Gemiddeld Het aantal geslaagde antwoorden op de directe methode. Geen
Geslaagde directe methode-aanroepen c2d.methods.success Aantal Totaal Het aantal geslaagde directe methode-aanroepen. Geen

Voor metrische gegevens met een eenheidswaarde van Aantal is alleen de totale aggregatie (som) geldig. Minimum-, maximum- en gemiddeldeaggregaties retourneren altijd 1. Zie Ondersteunde aggregaties voor meer informatie.

Metrische gegevens van cloud-naar-apparaatdubbelbewerkingen

Weergavenaam van metrische gegevens Metrisch Eenheid Aggregatietype Description Dimensies
Mislukte dubbelleesbewerkingen vanaf back-end c2d.twin.read.failure Aantal Totaal Het aantal mislukte door de back-end geïnitieerde dubbelleesbewerkingen. Geen
Mislukte dubbelupdates van back-end c2d.twin.update.failure Aantal Totaal Het aantal mislukte updates voor door de back-end geïnitieerde dubbels. Geen
Antwoordgrootte van dubbele leesbewerkingen vanaf back-end c2d.twin.read.size Bytes Gemiddeld Het aantal geslaagde door de back-end geïnitieerde dubbelleesbewerkingen. Geen
Grootte van dubbelupdates van back-end c2d.twin.update.size Bytes Gemiddeld De totale grootte van alle geslaagde door de back-end geïnitieerde dubbelupdates. Geen
Geslaagde dubbele leesbewerkingen vanaf back-end c2d.twin.read.success Aantal Totaal Het aantal geslaagde door de back-end geïnitieerde dubbelleesbewerkingen. Geen
Geslaagde dubbelupdates van back-end c2d.twin.update.success Aantal Totaal Het aantal geslaagde updates voor door de back-end geïnitieerde dubbels. Geen

Voor metrische gegevens met een eenheidswaardevan Aantal is alleen de aggregatie totaal (som) geldig. Minimum-, maximum- en gemiddeldeaggregaties retourneren altijd 1. Zie Ondersteunde aggregaties voor meer informatie.

Metrische configuratiegegevens

Weergavenaam van metrische gegevens Metrisch Eenheid Aggregatietype Description Dimensies
Metrische configuratiegegevens Configuraties Aantal Totaal Het totale aantal CRUD-bewerkingen dat is uitgevoerd voor apparaatconfiguratie en IoT Edge implementatie, op een set doelapparaten. Inbegrepen is het aantal bewerkingen dat de apparaatdubbel of moduledubbel wijzigt vanwege deze configuraties. Geen

Voor metrische gegevens met een eenheidswaardevan Aantal is alleen de aggregatie totaal (som) geldig. Minimum-, maximum- en gemiddeldeaggregaties retourneren altijd 1. Zie Ondersteunde aggregaties voor meer informatie.

Metrische dagelijkse quotumgegevens

Weergavenaam van metrische gegevens Metrisch Eenheid Aggregatietype Description Dimensies
Totaal gegevensgebruik van apparaat deviceDataUsage Bytes Totaal Bytes overgedragen naar en van alle apparaten die zijn verbonden met IotHub Geen
Totaal gegevensgebruik van apparaat (preview) deviceDataUsageV2 Bytes Totaal Bytes overgedragen naar en van alle apparaten die zijn verbonden met IotHub Geen
Totaal aantal gebruikte berichten dailyMessageQuotaUsed Count Gemiddeld Het totale aantal berichten dat vandaag is gebruikt. Een cumulatieve waarde die elke dag om 00:00 UTC op nul wordt ingesteld. Geen

Voor Totaal aantal gebruikte berichten worden alleen minimale, maximale en gemiddelde aggregaties ondersteund. Zie Ondersteunde aggregaties voor meer informatie.

Metrische apparaatgegevens

Weergavenaam van metrische waarde Metrisch Eenheid Aggregatietype Description Dimensies
Totaal aantal apparaten (afgeschaft) devices.totalDevices Aantal Totaal Aantal apparaten dat is geregistreerd bij uw IoT-hub Geen
Verbonden apparaten (afgeschaft) devices.connectedDevices.allProtocol Aantal Totaal Aantal apparaten dat is verbonden met uw IoT-hub Geen
Totaal aantal apparaten totalDeviceCount Count Gemiddeld Aantal apparaten dat is geregistreerd bij uw IoT-hub Geen
Verbonden apparaten connectedDeviceCount Count Gemiddeld Aantal apparaten dat is verbonden met uw IoT-hub Geen

Voor Totaal aantal apparaten (afgeschaft) en Verbonden apparaten (afgeschaft) is alleen de totale aggregatie (som) geldig. Minimale, maximale en gemiddelde aggregaties retourneren altijd 1. Zie Ondersteunde aggregaties voor meer informatie.

Voor Totaal aantal apparaten en Verbonden apparaten zijn alleen minimum-, maximum- en gemiddelde aggregaties geldig. Zie Ondersteunde aggregaties voor meer informatie.

Het totale aantal apparaten en verbonden apparaten kan niet worden geëxporteerd via diagnostische instellingen.

Metrische gegevens van apparaattelemetrie

Weergavenaam van metrische waarde Metrisch Eenheid Aggregatietype Description Dimensies
Aantal beperkingsfouten d2c.telemetry.ingress.sendThrottle Aantal Totaal Aantal beperkingsfouten vanwege doorvoerbeperkingen van apparaten Geen
Pogingen om berichten te verzenden via telemetrie d2c.telemetry.ingress.allProtocol Aantal Totaal Het aantal apparaat-naar-cloud-telemetrieberichten dat naar uw IoT-hub is verzonden Geen
Verzonden telemetrieberichten d2c.telemetry.ingress.success Aantal Totaal Het aantal apparaat-naar-cloud-telemetrieberichten dat naar uw IoT-hub is verzonden Geen

Voor metrische gegevens met een eenheidswaardevan Aantal is alleen de aggregatie totaal (som) geldig. Minimale, maximale en gemiddelde aggregaties retourneren altijd 1. Zie Ondersteunde aggregaties voor meer informatie.

Metrische gegevens van apparaat-naar-clouddubbelbewerkingen

Weergavenaam van metrische waarde Metrisch Eenheid Aggregatietype Description Dimensies
Mislukte dubbelleesbewerkingen van apparaten d2c.twin.read.failure Aantal Totaal Het aantal mislukte door het apparaat geïnitieerde dubbelleesbewerkingen. Geen
Mislukte dubbelupdates van apparaten d2c.twin.update.failure Aantal Totaal Het aantal mislukte door het apparaat geïnitieerde dubbelupdates. Geen
Antwoordgrootte van dubbelleesbewerkingen van apparaten d2c.twin.read.size Bytes Gemiddeld Het aantal geslaagde door het apparaat geïnitieerde dubbelleesbewerkingen. Geen
Grootte van tweelingupdates van apparaten d2c.twin.update.size Bytes Gemiddeld De totale grootte van alle geslaagde door het apparaat geïnitieerde dubbelupdates. Geen
Geslaagde dubbele leesbewerkingen van apparaten d2c.twin.read.success Aantal Totaal Het aantal geslaagde door het apparaat geïnitieerde dubbelleesbewerkingen. Geen
Geslaagde dubbelupdates van apparaten d2c.twin.update.success Aantal Totaal Het aantal geslaagde door het apparaat geïnitieerde dubbelupdates. Geen

Voor metrische gegevens met een eenheidswaardevan Aantal is alleen de aggregatie totaal (som) geldig. Minimum-, maximum- en gemiddeldeaggregaties retourneren altijd 1. Zie Ondersteunde aggregaties voor meer informatie.

Metrische gegevens van Event Grid

Weergavenaam van metrische gegevens Metrisch Eenheid Aggregatietype Description Dimensies
Event Grid-leveringen EventGridDeliveries Aantal Totaal Het aantal IoT Hub gebeurtenissen dat is gepubliceerd naar Event Grid. Gebruik de dimensie Resultaat voor het aantal geslaagde en mislukte aanvragen. EventType-dimensie toont het type gebeurtenis (https://aka.ms/ioteventgrid). Resultaat,
EventType
Zie Metrische dimensies voor meer informatie.
Event Grid-latentie EventGridLatency Milliseconden Gemiddeld De gemiddelde latentie (milliseconden) vanaf het moment dat de IoT Hub-gebeurtenis werd gegenereerd tot het moment waarop de gebeurtenis werd gepubliceerd naar Event Grid. Dit getal is een gemiddelde tussen alle gebeurtenistypen. Gebruik de dimensie EventType om de latentie van een specifiek type gebeurtenis te bekijken. EventType
Zie Metrische dimensies voor meer informatie.

Voor metrische gegevens met een eenheidswaardevan Aantal is alleen de aggregatie totaal (som) geldig. Minimum-, maximum- en gemiddeldeaggregaties retourneren altijd 1. Zie Ondersteunde aggregaties voor meer informatie.

Metrische gegevens voor taken

Weergavenaam van metrische gegevens Metrisch Eenheid Aggregatietype Description Dimensies
Voltooide taken jobs.completed Aantal Totaal Het aantal voltooide taken. Geen
Mislukte aanroepen om taken weer te geven jobs.listJobs.failure Aantal Totaal Het aantal mislukte aanroepen om taken weer te geven. Geen
Mislukte aanroeptaken van methoden jobs.createDirectMethodJob.failure Aantal Totaal Het aantal mislukte aanroeptaken voor directe methoden. Geen
Mislukte creaties van updatetaken voor dubbels jobs.createTwinUpdateJob.failure Aantal Totaal Het aantal mislukte aanmaaktaken van dubbelupdatetaken. Geen
Mislukte taakannuleringen jobs.cancelJob.failure Aantal Totaal Het aantal mislukte aanroepen om een taak te annuleren. Geen
Mislukte taakquery's jobs.queryJobs.failure Aantal Totaal Het aantal mislukte aanroepen voor querytaken. Geen
Mislukte taken jobs.failed Aantal Totaal Het aantal mislukte taken. Geen
Geslaagde aanroepen om taken weer te geven jobs.listJobs.success Aantal Totaal Het aantal geslaagde aanroepen om taken weer te geven. Geen
Geslaagde aanroeptaken voor methoden jobs.createDirectMethodJob.success Aantal Totaal Het aantal geslaagde aanroeptaken voor directe methoden. Geen
Geslaagde creaties van dubbelupdatetaken jobs.createTwinUpdateJob.
voltooid		 Aantal Totaal Het aantal geslaagde bijwerktaken voor dubbels. Geen
Geslaagde taakannuleringen jobs.cancelJob.success Aantal Totaal Het aantal geslaagde aanroepen om een taak te annuleren. Geen
Geslaagde taakquery's jobs.queryJobs.success Aantal Totaal Het aantal geslaagde aanroepen voor querytaken. Geen

Voor metrische gegevens met een eenheidswaardevan Aantal is alleen de aggregatie totaal (som) geldig. Minimale, maximale en gemiddelde aggregaties retourneren altijd 1. Zie Ondersteunde aggregaties voor meer informatie.

Metrische routeringsgegevens

Weergavenaam van metrische waarde Metrisch Eenheid Aggregatietype Description Dimensies
Routeringsleveringen (preview) RouteringLeveringen Aantal Totaal De metrische gegevens voor routeringslevering. Gebruik de dimensies om de leveringsstatus voor een specifiek eindpunt of voor een specifieke routeringsbron te identificeren. Resultaat,
Routeringsbron,
EndpointType,
FailureReasonCategory,
EndpointName
Zie Metrische dimensies voor meer informatie.
Grootte van bezorgingsbericht routeren in bytes (preview) RoutingDataSizeInBytesDelivered Bytes Totaal Het totale aantal bytes dat door IoT Hub naar een aangepast eindpunt en ingebouwd eindpunt wordt gerouteerd. Gebruik de dimensies om de gegevensgrootte te identificeren die wordt gerouteerd naar een specifiek eindpunt of voor een specifieke routeringsbron. Routeringsbron,
EndpointType
EndpointName
Zie Metrische dimensies voor meer informatie.
Latentie van routeringslevering (preview) RoutingDeliveryLatency Milliseconden Gemiddeld De metrische gegevens over leveringslatentie van routering. Gebruik de dimensies om de latentie voor een specifiek eindpunt of voor een specifieke routeringsbron te identificeren. Routeringsbron,
EndpointType,
EndpointName
Zie Metrische dimensies voor meer informatie.
Routering: blobs die aan de opslag worden geleverd d2c.endpoints.egress.storage.blobs Aantal Totaal Het aantal keren IoT Hub routering blobs geleverd aan opslageindpunten. Geen
Routering: gegevens die aan de opslag worden geleverd d2c.endpoints.egress.storage.bytes Bytes Totaal De hoeveelheid gegevens (bytes) IoT Hub routering die aan opslageindpunten wordt geleverd. Geen
Routering: berichtlatentie voor Event Hubs d2c.endpoints.latency.eventHubs Milliseconden Gemiddeld De gemiddelde latentie (milliseconden) tussen inkomend bericht naar IoT Hub en inkomend bericht in aangepaste eindpunten van het type Event Hubs. Berichtenroutes naar ingebouwd eindpunt (gebeurtenissen) worden niet opgenomen. Geen
Routering: berichtlatentie voor Service Bus-wachtrij d2c.endpoints.latency.serviceBusQueues Milliseconden Gemiddeld De gemiddelde latentie (milliseconden) tussen inkomend bericht tot IoT Hub en inkomend bericht in een Service Bus-wachtrijeindpunt. Geen
Routering: berichtlatentie voor Service Bus-onderwerp d2c.endpoints.latency.serviceBusTopics Milliseconden Gemiddeld De gemiddelde latentie (milliseconden) tussen inkomend bericht tot IoT Hub en inkomend bericht in een Service Bus-onderwerpeindpunt. Geen
Routering: berichtlatentie voor berichten/gebeurtenissen d2c.endpoints.latency.builtIn.events Milliseconden Gemiddeld De gemiddelde latentie (milliseconden) tussen het inkomend bericht naar IoT Hub en het inkomend bericht in het ingebouwde eindpunt (berichten/gebeurtenissen) en de terugvalroute. Geen
Routering: berichtlatentie voor opslag d2c.endpoints.latency.storage Milliseconden Gemiddeld De gemiddelde latentie (milliseconden) tussen inkomend bericht tot IoT Hub en inkomend bericht in een opslageindpunt. Geen
Routering: berichten die worden bezorgd bij Event Hubs d2c.endpoints.egress.eventHubs Aantal Totaal Het aantal keren IoT Hub dat berichten zijn bezorgd bij aangepaste eindpunten van het type Event Hubs. Berichtroutes naar ingebouwd eindpunt (gebeurtenissen) zijn niet opgenomen. Geen
Routering: berichten die worden bezorgd bij Service Bus-wachtrij d2c.endpoints.egress.serviceBusQueues Aantal Totaal Het aantal keren dat IoT Hub routering berichten heeft bezorgd bij Service Bus-wachtrijeindpunten. Geen
Routering: berichten bezorgd bij Service Bus-onderwerp d2c.endpoints.egress.serviceBusTopics Aantal Totaal Het aantal keren dat IoT Hub routering berichten heeft afgeleverd bij Service Bus-onderwerpeindpunten. Geen
Routering: berichten geleverd aan terugval d2c.telemetry.egress.fallback Aantal Totaal Het aantal keren IoT Hub het routeren van berichten die zijn geleverd aan het eindpunt dat is gekoppeld aan de terugvalroute. Geen
Routering: berichten geleverd aan berichten/gebeurtenissen d2c.endpoints.egress.builtIn.events Aantal Totaal Het aantal keren dat IoT Hub routering berichten heeft bezorgd bij het ingebouwde eindpunt (berichten/gebeurtenissen) en de terugvalroute. Geen
Routering: berichten die in de opslag worden afgeleverd d2c.endpoints.egress.storage Aantal Totaal Het aantal keren dat IoT Hub routering berichten heeft afgeleverd bij opslageindpunten. Geen
Routering: telemetrieberichten bezorgd d2c.telemetry.egress.success Aantal Totaal Het aantal keren dat berichten zijn bezorgd bij alle eindpunten met behulp van IoT Hub routering. Als een bericht wordt doorgestuurd naar meerdere eindpunten, wordt deze waarde met één verhoogd voor elke geslaagde bezorging. Als een bericht meerdere keren bij hetzelfde eindpunt wordt bezorgd, wordt deze waarde voor elke geslaagde bezorging met één verhoogd. Geen
Routering: telemetrieberichten verwijderd d2c.telemetry.egress.dropped Aantal Totaal Het aantal keren dat berichten zijn verwijderd door IoT Hub routering vanwege dode eindpunten. Met deze waarde worden berichten die zijn geleverd aan de terugvalroute niet meegeteld omdat verwijderde berichten daar niet worden bezorgd. Geen
Routering: telemetrieberichten zijn niet compatibel d2c.telemetry.egress.invalid Aantal Totaal Het aantal keren dat IoT Hub routering berichten niet kon afleveren vanwege een incompatibiliteit met het eindpunt. Een bericht is niet compatibel met een eindpunt wanneer Iot Hub probeert het bericht af te leveren bij een eindpunt en het mislukt met een niet-tijdelijke fout. Ongeldige berichten worden niet opnieuw geprobeerd. Deze waarde bevat geen nieuwe pogingen. Geen
Routering: zwevende telemetrieberichten d2c.telemetry.egress.orphaned Aantal Totaal Het aantal keren dat berichten zwevend zijn door IoT Hub routering omdat ze niet overeenkomen met een routeringsquery, wanneer terugvalroute is uitgeschakeld. Geen

Voor metrische gegevens met een eenheidswaardevan Aantal is alleen de aggregatie totaal (som) geldig. Minimum-, maximum- en gemiddeldeaggregaties retourneren altijd 1. Zie Ondersteunde aggregaties voor meer informatie.

Metrische gegevens van dubbelquery's

Weergavenaam van metrische gegevens Metrisch Eenheid Aggregatietype Description Dimensies
Mislukte dubbelquery's twinQueries.failure Aantal Totaal Het aantal mislukte dubbelquery's. Geen
Geslaagde dubbelquery's twinQueries.success Aantal Totaal Het aantal geslaagde dubbelquery's. Geen
Grootte van resultaat van dubbelquery's twinQueries.resultSize Bytes Gemiddeld Het totaal van de resultaatgrootte van alle geslaagde dubbelquery's. Geen

Voor metrische gegevens met een eenheidswaardevan Aantal is alleen de aggregatie totaal (som) geldig. Minimale, maximale en gemiddelde aggregaties retourneren altijd 1. Zie Ondersteunde aggregaties voor meer informatie.

Metrische dimensies

Azure IoT Hub heeft de volgende dimensies die zijn gekoppeld aan enkele van de routerings- en Event Grid-metrische gegevens.

Dimensienaam Description
EndpointName De naam van het eindpunt
EndpointType eventHubs, serviceBusQueues, cosmosDB, serviceBusTopics. builtin of blobStorage
EventType Microsoft.Devices.DeviceCreated. Microsoft.Devices.DeviceDeleted, Microsoft.Devices.DeviceConnected, Microsoft.Devices.DeviceDisconnected of Microsoft.Devices.DeviceTelemetry
Zie Gebeurtenistypen voor meer informatie.
FailureReasonCategory Een van de volgende opties: ongeldig, verwijderd, zwevend of null.
Resultaat Geslaagd ofmislukt
Routeringsbron Apparaatberichten
Wijzigingsevenementen van dubbels
Levenscyclusevenementen van apparaten

Zie Multidimensionale metrische gegevens voor meer informatie over metrische dimensies.

Resourcelogboeken

In deze sectie vindt u alle categorietypen en schema's voor resourcelogboeken die zijn verzameld voor Azure IoT Hub. De resourceprovider en het type voor alle IoT Hub logboeken is Microsoft.Devices/IotHubs. Gebeurtenissen worden alleen verzonden voor fouten in bepaalde categorieën.

Onderwerpen in dit gedeelte

Verbindingen

Met de categorie verbindingen worden gebeurtenissen voor het verbinden en verbreken van apparaten met een IoT-hub en fouten bijgehouden. Deze categorie is handig voor het identificeren van niet-geautoriseerde verbindingspogingen en of waarschuwingen wanneer de verbinding met apparaten wordt verbroken.

Zie Verbindingsstatus van apparaten bewaken voor een betrouwbare verbindingsstatus van apparaten.

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

Zie Apparaatconnectiviteit met Azure IoT Hub bewaken, diagnosticeren en problemen oplossen voor gedetailleerde informatie over het gebruik van verbindingslogboeken voor het bewaken van apparaatconnectiviteit.

Apparaattelemetrie

De categorie apparaattelemetrie houdt fouten bij die optreden in de IoT-hub en gerelateerd zijn aan de telemetriepijplijn. Deze categorie bevat fouten die optreden bij het verzenden van telemetriegebeurtenissen (zoals beperking) en het ontvangen van telemetriegebeurtenissen (zoals onbevoegde lezer). Deze categorie kan geen fouten ondervangen die worden veroorzaakt door code die op het apparaat zelf wordt uitgevoerd.

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

Cloud-naar-apparaat-opdrachten

Met de categorie cloud-naar-apparaat-opdrachten worden fouten bijgehouden die optreden in de IoT-hub en gerelateerd zijn aan de berichtenpijplijn van cloud naar apparaat. Deze categorie bevat fouten die optreden als gevolg van:

  • Cloud-naar-apparaat-berichten verzenden (zoals fouten met onbevoegde afzenders),
  • Het ontvangen van cloud-naar-apparaat-berichten (zoals bezorgingsaantal overschreden fouten), en
  • Ontvangen van cloud-naar-apparaat-berichtfeedback (zoals fouten met verlopen feedback).

Deze categorie onderschept geen fouten wanneer het cloud-naar-apparaat-bericht wordt bezorgd, maar vervolgens onjuist wordt verwerkt door het apparaat.

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

Apparaatidentiteitsbewerkingen

De categorie apparaatidentiteitsbewerkingen houdt fouten bij die optreden wanneer u een vermelding in het identiteitsregister van uw IoT-hub probeert te maken, bij te werken of te verwijderen. Het bijhouden van deze categorie is handig voor inrichtingsscenario's.

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

Bestandsuploadbewerkingen

De categorie voor het uploaden van bestanden houdt fouten bij die optreden in de IoT-hub en gerelateerd zijn aan de functionaliteit voor het uploaden van bestanden. Deze categorie omvat:

  • Fouten die optreden met de SAS-URI, bijvoorbeeld wanneer deze verloopt voordat een apparaat de hub van een voltooide upload meldt.

  • Mislukte uploads gerapporteerd door het apparaat.

  • Fouten die optreden wanneer een bestand niet in de opslag wordt gevonden tijdens het maken van IoT Hub meldingsbericht.

Deze categorie kan geen fouten ondervangen die rechtstreeks optreden wanneer het apparaat een bestand uploadt naar de opslag.

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

Routes

De categorie berichtroutering houdt fouten bij die optreden tijdens de evaluatie van de berichtroute en de eindpuntstatus zoals waargenomen door IoT Hub. Deze categorie omvat gebeurtenissen zoals:

  • Een regel resulteert in 'niet-gedefinieerd',
  • IoT Hub een eindpunt als niet-actief markeert, of
  • Eventuele fouten die zijn ontvangen van een eindpunt.

Deze categorie bevat geen specifieke fouten over de berichten zelf (zoals apparaatbeperkingsfouten), die worden gerapporteerd onder de categorie 'apparaattelemetrie'.

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

Hier vindt u meer informatie over het routeren van resourcelogboeken:

Apparaat-naar-cloud-dubbelbewerkingen

De categorie apparaat-naar-cloud-dubbelbewerkingen houdt door apparaat geïnitieerde gebeurtenissen bij op apparaatdubbels. Deze bewerkingen kunnen bestaan uit het ophalen van dubbels, het bijwerken van gerapporteerde eigenschappen en het abonneren op gewenste eigenschappen.

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

Cloud-naar-apparaat-dubbelbewerkingen

De categorie cloud-naar-apparaatdubbelbewerkingen houdt door de service geïnitieerde gebeurtenissen op apparaatdubbels bij. Deze bewerkingen kunnen bestaan uit het ophalen van dubbels, het bijwerken of vervangen van tags en het bijwerken of vervangen van gewenste eigenschappen.

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

Dubbelquery's

De categorie dubbelquery's rapporteert over queryaanvragen voor apparaatdubbels die zijn geïnitieerd in de cloud.

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

Taakbewerkingen

De categorie takenbewerkingen rapporteert over taakaanvragen om apparaatdubbels bij te werken of directe methoden op meerdere apparaten aan te roepen. Deze aanvragen worden gestart in de cloud.

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

Directe methoden

De categorie directe methoden houdt aanvraag-antwoordinteracties bij die naar afzonderlijke apparaten worden verzonden. Deze aanvragen worden gestart in de cloud.

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

Gedistribueerde tracering (preview)

De categorie gedistribueerde tracering houdt de correlatie-id's bij voor berichten die de contextheader van de tracering bevatten. Als u deze logboeken volledig wilt inschakelen, moet code aan de clientzijde worden bijgewerkt door IoT-toepassingen end-to-end analyseren en diagnosticeren met IoT Hub gedistribueerde tracering (preview) te volgen.

De correlationId voldoet aan het W3C-voorstel voor traceringscontext , waarin het een trace-id en een span-idbevat.

IoT Hub D2C-logboeken (apparaat-naar-cloud)

IoT Hub registreert dit logboek wanneer een bericht met geldige traceringseigenschappen op IoT Hub aankomt.

{
    "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 Hier wordt niet berekend omdat IoT Hub klok mogelijk niet synchroon is met de klok van het apparaat, waardoor een duurberekening misleidend kan zijn. U wordt aangeraden logica te schrijven met behulp van de tijdstempels in de properties sectie om pieken in apparaat-naar-cloud-latentie vast te leggen.

Eigenschap Type Description
messageSize Geheel getal De grootte van apparaat-naar-cloud-bericht in bytes
deviceId Tekenreeks van ASCII 7-bits alfanumerieke tekens De identiteit van het apparaat
callerLocalTimeUtc UTC-tijdstempel De aanmaaktijd van het bericht zoals gerapporteerd door de lokale klok van het apparaat
calleeLocalTimeUtc UTC-tijdstempel Het tijdstip waarop het bericht bij de gateway van de IoT Hub aankomt, zoals aangegeven door IoT Hub klok aan de servicezijde

Logboeken voor inkomend verkeer IoT Hub

IoT Hub registreert dit logboek wanneer een bericht met geldige traceringseigenschappen naar interne of ingebouwde Event Hubs wordt geschreven.

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

In de properties sectie bevat dit logboek aanvullende informatie over inkomend bericht.

Eigenschap Type Description
isRoutingEnabled Tekenreeks Waar of onwaar, geeft aan of berichtroutering is ingeschakeld in de IoT Hub
parentSpanId Tekenreeks De span-id van het bovenliggende bericht, in dit geval de D2C-berichttracering

IoT Hub logboeken voor uitgaand verkeer

IoT Hub registreert dit logboek wanneer routering is ingeschakeld en het bericht naar een eindpunt wordt geschreven. Als routering niet is ingeschakeld, registreert IoT Hub dit logboek niet.

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

In de properties sectie bevat dit logboek aanvullende informatie over inkomend bericht.

Eigenschap Type Description
endpointName Tekenreeks De naam van het routeringseindpunt
endpointType Tekenreeks Het type routeringseindpunt
parentSpanId Tekenreeks De span-id van het bovenliggende bericht, in dit geval de tracering van het IoT Hub inkomend bericht

Configuraties

IoT Hub configuratielogboeken houden gebeurtenissen en fouten bij voor de functieset Automatische Apparaatbeheer.

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

Apparaatstreams (preview)

De categorie apparaatstreams houdt interacties tussen aanvragen en antwoorden bij die naar afzonderlijke apparaten worden verzonden.

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

Azure Monitor-logboektabellen

Deze sectie verwijst naar alle Kusto-tabellen van Azure Monitor-logboeken die relevant zijn voor Azure IoT Hub en die beschikbaar zijn voor query's door Log Analytics. Zie IoT Hub in de tabelreferentie voor Azure Monitor-logboeken voor een lijst met deze tabellen en koppelingen naar meer informatie over het resourcetype IoT Hub.

Zie Naslaginformatie over Azure Monitor-logboektabellen voor een overzicht van alle Azure Monitor-logboeken/Log Analytics-tabellen.

Zie ook