Monitorowanie Azure IoT Hub odwołania do danych

  • Artykuł

Aby rozpocząć monitorowanie platformy Azure, zobacz Monitorowanie Azure IoT Hub, aby zrozumieć, jak zbierać i analizować dane monitorowania na potrzeby Azure IoT Hub.

Ten artykuł jest dokumentacją dotyczącą implementowania monitorowania platformy Azure.

Główne sekcje w tym artykule referencyjnym:

Metryki

W tej sekcji wymieniono wszystkie automatycznie zebrane metryki platformy dla Azure IoT Hub. Przestrzeń nazw dostawcy zasobów dla metryk IoT Hub to Microsoft.Devices, a typem przestrzeń nazw to IoTHubs.

W poniższych podsekcjach przedstawiono metryki platformy IoT Hub według ogólnej kategorii i metryk listy według ich nazwy wyświetlanej przypisanej w Azure Portal.

Możesz również znaleźć jedną tabelę zawierającą listę wszystkich metryk platformy IoT Hub według nazwy metryki w obszarze Microsoft.Devices/IotHubs w dokumentacji usługi Azure Monitor. Ta tabela nie zawiera wszystkich informacji, takich jak obsługiwane agregacje dla niektórych metryk, dostępnych w tym artykule.

Aby dowiedzieć się więcej o metrykach obsługiwanych przez inne usługi platformy Azure, zobacz Obsługiwane metryki za pomocą usługi Azure Monitor.

Tematy w tej sekcji

Wybierz temat, aby przejść do informacji na tej stronie.

Obsługiwane agregacje

Kolumna Typ agregacji w każdej tabeli odpowiada domyślnej agregacji używanej podczas wybierania metryki dla wykresu lub alertu.

Zrzut ekranu przedstawiający agregację metryk

W przypadku większości metryk wszystkie typy agregacji są prawidłowe; jednak w przypadku metryk zliczanych z wartością kolumny Unit(Liczba) tylko niektóre agregacje są prawidłowe. Metryki liczby mogą być jednym z dwóch typów:

  • W przypadku metryk liczby pojedynczych punktów IoT Hub rejestruje pojedynczy punkt danych (zasadniczo 1) za każdym razem, gdy odbywa się mierzona operacja. Usługa Azure Monitor następnie sumuje te punkty danych na określonym poziomie szczegółowości. Przykłady metryk pojedynczego punktu to komunikaty telemetryczne wysyłane i dostarczanie komunikatów C2D. W przypadku tych metryk jedynym odpowiednim typem agregacji jest Suma (Suma). Portal umożliwia wybranie wartości minimalnej, maksymalnej i średniej; jednak te wartości będą zawsze równe 1.

  • W przypadku metryk liczby migawek IoT Hub rejestruje łączną liczbę podczas mierzonej operacji. Obecnie istnieją trzy metryki migawek emitowane przez IoT Hub: Łączna liczba używanych komunikatów, Łączna liczbaurządzeń i Połączone urządzenia. Ponieważ te metryki zawierają "całkowitą" ilość za każdym razem, gdy są emitowane, sumowanie ich na określonym poziomie szczegółowości nie ma sensu. Usługa Azure Monitor ogranicza wybór średniej, minimalnej i maksymalnej dla typu agregacji dla tych metryk.

Metryki poleceń chmury do urządzenia

Nazwa wyświetlana metryki Metric Jednostka Typ agregacji Opis Wymiary
Komunikaty C2D wygasły C2DMessagesExpired Liczba Łącznie Liczba wygasłych komunikatów z chmury do urządzenia Brak
Ukończono dostarczanie komunikatów C2D c2d.commands.egress.complete.success Liczba Łącznie Liczba dostaw komunikatów z chmury do urządzenia ukończonych pomyślnie przez urządzenie Brak
Porzucone komunikaty C2D c2d.commands.egress.abandon.success Liczba Łącznie Liczba komunikatów z chmury do urządzeń porzuconych przez urządzenie Brak
Odrzucone komunikaty C2D c2d.commands.egress.reject.success Liczba Łącznie Liczba komunikatów z chmury do urządzenia odrzuconych przez urządzenie Brak

W przypadku metryk z wartością Jednostkowa licznika prawidłowa jest tylko agregacja całkowita (suma). Agregacje minimalne, maksymalne i średnie zawsze zwracają 1. Aby uzyskać więcej informacji, zobacz Obsługiwane agregacje.

Metryki metod bezpośrednich w chmurze do urządzenia

Nazwa wyświetlana metryki Metric Jednostka Typ agregacji Opis Wymiary
Wywołania metody bezpośredniej zakończyły się niepowodzeniem c2d.methods.failure Liczba Łącznie Liczba wszystkich nieudanych wywołań metody bezpośredniej. Brak
Rozmiar żądania wywołań metody bezpośredniej c2d.methods.requestSize Bajty Średnia Liczba wszystkich pomyślnych żądań metody bezpośredniej. Brak
Rozmiar odpowiedzi wywołań metody bezpośredniej c2d.methods.responseSize Bajty Średnia Liczba wszystkich pomyślnych odpowiedzi metody bezpośredniej. Brak
Pomyślne wywołania metody bezpośredniej c2d.methods.success Liczba Łącznie Liczba wszystkich pomyślnych wywołań metody bezpośredniej. Brak

W przypadku metryk z wartością jednostkową agregacji tylko całkowita (suma) jest prawidłowa. Agregacje minimalne, maksymalne i średnie zawsze zwracają 1. Aby uzyskać więcej informacji, zobacz Obsługiwane agregacje.

Metryki operacji bliźniaczej reprezentacji urządzenia w chmurze do urządzenia

Nazwa wyświetlana metryki Metric Jednostka Typ agregacji Opis Wymiary
Odczyty bliźniaczej reprezentacji zakończonej niepowodzeniem z zaplecza c2d.twin.read.failure Liczba Łącznie Liczba odczytów bliźniaczej reprezentacji zainicjowanej przez zaplecze zakończone niepowodzeniem. Brak
Nieudane aktualizacje bliźniaczej reprezentacji z zaplecza c2d.twin.update.failure Liczba Łącznie Liczba wszystkich aktualizacji bliźniaczych inicjowanych przez zaplecze zakończone niepowodzeniem. Brak
Rozmiar odpowiedzi odczytu bliźniaczej reprezentacji z zaplecza c2d.twin.read.size Bajty Średnia Liczba wszystkich pomyślnych operacji odczytu bliźniaczej reprezentacji zainicjowanej przez zaplecze. Brak
Rozmiar aktualizacji bliźniaczej reprezentacji z zaplecza c2d.twin.update.size Bajty Średnia Łączny rozmiar wszystkich pomyślnych aktualizacji bliźniaczych reprezentacji zainicjowanych przez zaplecze. Brak
Pomyślne odczyty bliźniaczej reprezentacji z zaplecza c2d.twin.read.success Liczba Łącznie Liczba wszystkich pomyślnych operacji odczytu bliźniaczej reprezentacji zainicjowanej przez zaplecze. Brak
Pomyślne aktualizacje bliźniaczej reprezentacji z zaplecza c2d.twin.update.success Liczba Łącznie Liczba wszystkich pomyślnych aktualizacji bliźniaczych inicjowanych przez zaplecze. Brak

W przypadku metryk z wartością Jednostkowa licznika prawidłowa jest tylko agregacja całkowita (suma). Agregacje minimalne, maksymalne i średnie zawsze zwracają 1. Aby uzyskać więcej informacji, zobacz Obsługiwane agregacje.

Metryki konfiguracji

Nazwa wyświetlana metryki Metric Jednostka Typ agregacji Opis Wymiary
Metryki konfiguracji Konfiguracji Liczba Łącznie Liczba całkowitych operacji CRUD wykonywanych na potrzeby konfiguracji urządzenia i IoT Edge wdrożenia na zestaw urządzeń docelowych. Uwzględniona jest liczba operacji modyfikujących bliźniaczą reprezentację urządzenia lub bliźniaczą reprezentację modułu z powodu tych konfiguracji. Brak

W przypadku metryk z wartością Jednostkowa licznika prawidłowa jest tylko agregacja całkowita (suma). Agregacje minimalne, maksymalne i średnie zawsze zwracają 1. Aby uzyskać więcej informacji, zobacz Obsługiwane agregacje.

Metryki dziennego limitu przydziału

Nazwa wyświetlana metryki Metric Jednostka Typ agregacji Opis Wymiary
Łączne użycie danych urządzenia deviceDataUsage Bajty Łącznie Bajty przesyłane do i z wszystkich urządzeń połączonych z usługą IotHub Brak
Łączne użycie danych urządzenia (wersja zapoznawcza) deviceDataUsageV2 Bajty Łącznie Bajty przesyłane do i z wszystkich urządzeń połączonych z usługą IotHub Brak
Łączna liczba używanych komunikatów dailyMessageQuotaUsed Liczba Średnia Liczba komunikatów używanych dzisiaj. Wartość skumulowana, która jest resetowany do zera o 00:00 UTC każdego dnia. Brak

W przypadku łącznej liczby używanych komunikatów obsługiwane są tylko agregacje minimalne, maksymalne i średnie. Aby uzyskać więcej informacji, zobacz Obsługiwane agregacje.

Metryki urządzeń

Nazwa wyświetlana metryki Metric Jednostka Typ agregacji Opis Wymiary
Łączna liczba urządzeń (przestarzałe) devices.totalDevices Liczba Łącznie Liczba urządzeń zarejestrowanych w centrum IoT Brak
Połączone urządzenia (przestarzałe) devices.connectedDevices.allProtocol Liczba Łącznie Liczba urządzeń połączonych z centrum IoT Brak
Łączna liczba urządzeń totalDeviceCount Liczba Średnia Liczba urządzeń zarejestrowanych w centrum IoT Brak
Połączone urządzenia connectedDeviceCount Liczba Średnia Liczba urządzeń połączonych z centrum IoT Brak

W przypadku pozycji Łączna liczba urządzeń (przestarzałe) i Połączone urządzenia (przestarzałe) tylko łączna agregacja (suma) jest prawidłowa. Agregacje minimalne, maksymalne i średnie zawsze zwracają wartość 1. Aby uzyskać więcej informacji, zobacz Obsługiwane agregacje.

W przypadku łącznych urządzeń i połączonych urządzeń prawidłowe są tylko agregacje minimalne, maksymalne i średnie. Aby uzyskać więcej informacji, zobacz Obsługiwane agregacje.

Łączna liczba urządzeń i połączonych urządzeń nie można eksportować za pośrednictwem ustawień diagnostycznych.

Metryki telemetrii urządzenia

Nazwa wyświetlana metryki Metric Jednostka Typ agregacji Opis Wymiary
Liczba błędów ograniczania przepustowości d2c.telemetry.ingress.sendThrottle Liczba Łącznie Liczba błędów ograniczania przepustowości z powodu ograniczania przepływności urządzenia Brak
Próby telemetrii "wysyłanie komunikatów" d2c.telemetry.ingress.allProtocol Liczba Łącznie Liczba komunikatów telemetrycznych przesyłanych z urządzenia do chmury, które próbowano wysłać do centrum IoT Brak
Wysłane komunikaty telemetryczne d2c.telemetry.ingress.success Liczba Łącznie Liczba komunikatów telemetrycznych przesyłanych z urządzenia do chmury wysłanych pomyślnie do centrum IoT Brak

W przypadku metryk z wartością Unit (Liczba) tylko agregacja całkowita (suma) jest prawidłowa. Agregacje minimalne, maksymalne i średnie zawsze zwracają wartość 1. Aby uzyskać więcej informacji, zobacz Obsługiwane agregacje.

Metryki operacji bliźniaczej reprezentacji urządzenia do chmury

Nazwa wyświetlana metryki Metric Jednostka Typ agregacji Opis Wymiary
Nieudane odczyty bliźniaczej reprezentacji bliźniaczej z urządzeń d2c.twin.read.failure Liczba Łącznie Liczba odczytów bliźniaczej reprezentacji bliźniaczej zainicjowanej przez urządzenie, która zakończyła się niepowodzeniem. Brak
Nieudane aktualizacje bliźniaczej reprezentacji z urządzeń d2c.twin.update.failure Liczba Łącznie Liczba wszystkich aktualizacji bliźniaczej reprezentacji zainicjowanej przez urządzenie, które zakończyły się niepowodzeniem. Brak
Rozmiar odpowiedzi odczytów bliźniaczych reprezentacji z urządzeń d2c.twin.read.size Bajty Średnia Liczba wszystkich operacji odczytu bliźniaczej reprezentacji zainicjowanej przez urządzenie. Brak
Rozmiar aktualizacji bliźniaczych reprezentacji z urządzeń d2c.twin.update.size Bajty Średnia Całkowity rozmiar wszystkich pomyślnych aktualizacji bliźniaczej reprezentacji zainicjowanej przez urządzenie. Brak
Pomyślne odczyty bliźniaczej reprezentacji z urządzeń d2c.twin.read.success Liczba Łącznie Liczba wszystkich operacji odczytu bliźniaczej reprezentacji zainicjowanej przez urządzenie. Brak
Pomyślne aktualizacje bliźniaczej reprezentacji z urządzeń d2c.twin.update.success Liczba Łącznie Liczba wszystkich pomyślnych aktualizacji bliźniaczych reprezentacji zainicjowanych przez urządzenie. Brak

W przypadku metryk z wartością Jednostkowa licznika prawidłowa jest tylko agregacja całkowita (suma). Agregacje minimalne, maksymalne i średnie zawsze zwracają 1. Aby uzyskać więcej informacji, zobacz Obsługiwane agregacje.

Metryki usługi Event Grid

Nazwa wyświetlana metryki Metric Jednostka Typ agregacji Opis Wymiary
Dostarczanie usługi Event Grid EventGridDeliveries Liczba Łącznie Liczba zdarzeń IoT Hub opublikowanych w usłudze Event Grid. Użyj wymiaru Wynik dla liczby żądań zakończonych powodzeniem i niepowodzeniem. Wymiar EventType przedstawia typ zdarzenia (https://aka.ms/ioteventgrid). Wynik:
Typ zdarzenia
Aby uzyskać więcej informacji, zobacz Wymiary metryk.
Opóźnienie usługi Event Grid EventGridLatency Milisekund Średnia Średnie opóźnienie (milisekundy) od momentu wygenerowania zdarzenia usługi Iot Hub do momentu opublikowania zdarzenia w usłudze Event Grid. Ta liczba jest średnią między wszystkimi typami zdarzeń. Użyj wymiaru EventType, aby zobaczyć opóźnienie określonego typu zdarzenia. Typ zdarzenia
Aby uzyskać więcej informacji, zobacz Wymiary metryk.

W przypadku metryk z wartością Jednostkowa licznika prawidłowa jest tylko agregacja całkowita (suma). Agregacje minimalne, maksymalne i średnie zawsze zwracają 1. Aby uzyskać więcej informacji, zobacz Obsługiwane agregacje.

Metryki zadań

Nazwa wyświetlana metryki Metric Jednostka Typ agregacji Opis Wymiary
Ukończone zadania jobs.completed Liczba Łącznie Liczba wszystkich ukończonych zadań. Brak
Nieudane wywołania listy zadań jobs.listJobs.failure Liczba Łącznie Liczba wszystkich nieudanych wywołań do wyświetlania listy zadań. Brak
Nieudane tworzenie zadań wywołania metody jobs.createDirectMethodJob.failure Liczba Łącznie Liczba wszystkich nieudanych operacji tworzenia zadań wywołania metody bezpośredniej. Brak
Nieudane tworzenie zadań aktualizacji bliźniaczej reprezentacji jobs.createTwinUpdateJob.failure Liczba Łącznie Liczba wszystkich nieudanych zadań aktualizacji bliźniaczej reprezentacji. Brak
Anulowanie zadania, które zakończyło się niepowodzeniem jobs.cancelJob.failure Liczba Łącznie Liczba wszystkich nieudanych wywołań w celu anulowania zadania. Brak
Zapytania dotyczące zadań, które zakończyły się niepowodzeniem jobs.queryJobs.failure Liczba Łącznie Liczba wszystkich nieudanych wywołań zadań wykonywania zapytań. Brak
Zadania, które zakończyły się niepowodzeniem jobs.failed Liczba Łącznie Liczba wszystkich zadań, które zakończyły się niepowodzeniem. Brak
Pomyślne wywołania listy zadań jobs.listJobs.success Liczba Łącznie Liczba wszystkich pomyślnych wywołań do wyświetlania listy zadań. Brak
Pomyślne tworzenie zadań wywołania metody jobs.createDirectMethodJob.success Liczba Łącznie Liczba wszystkich pomyślnych zadań wywołania metody bezpośredniej. Brak
Pomyślne tworzenie zadań aktualizacji reprezentacji bliźniaczej jobs.createTwinUpdateJob.
powodzenie		 Liczba Łącznie Liczba wszystkich pomyślnych zadań aktualizacji reprezentacji bliźniaczej. Brak
Pomyślne anulowanie zadania jobs.cancelJob.success Liczba Łącznie Liczba wszystkich pomyślnych wywołań w celu anulowania zadania. Brak
Zapytania dotyczące zakończonych powodzeniem zadań jobs.queryJobs.success Liczba Łącznie Liczba wszystkich pomyślnych wywołań do wykonywania zapytań o zadania. Brak

W przypadku metryk z wartością Unit (Liczba) tylko agregacja całkowita (suma) jest prawidłowa. Agregacje minimalne, maksymalne i średnie zawsze zwracają wartość 1. Aby uzyskać więcej informacji, zobacz Obsługiwane agregacje.

Metryki routingu

Nazwa wyświetlana metryki Metric Jednostka Typ agregacji Opis Wymiary
Routing dostarczania (wersja zapoznawcza) RoutingDeliveries Liczba Łącznie Metryka dostarczania routingu. Użyj wymiarów, aby zidentyfikować stan dostarczania dla określonego punktu końcowego lub określonego źródła routingu. Wynik:
RoutingSource,
Endpointtype
FailureReasonCategory,
Nazwa punktu końcowego
Aby uzyskać więcej informacji, zobacz Wymiary metryk.
Rozmiar komunikatu dostarczania w bajtach (wersja zapoznawcza) RoutingDataSizeInBytesDelivered Bajty Łącznie Całkowita liczba bajtów kierowanych przez IoT Hub do niestandardowego punktu końcowego i wbudowanego punktu końcowego. Użyj wymiarów, aby zidentyfikować rozmiar danych kierowany do określonego punktu końcowego lub dla określonego źródła routingu. RoutingSource,
Endpointtype
Nazwa punktu końcowego
Aby uzyskać więcej informacji, zobacz Wymiary metryk.
Opóźnienie dostarczania routingu (wersja zapoznawcza) RoutingDeliveryLatency Milisekund Średnia Metryka opóźnienia dostarczania routingu. Użyj wymiarów, aby zidentyfikować opóźnienie dla określonego punktu końcowego lub określonego źródła routingu. RoutingSource,
Endpointtype
Nazwa punktu końcowego
Aby uzyskać więcej informacji, zobacz Wymiary metryk.
Routing: obiekty blob dostarczane do magazynu d2c.endpoints.egress.storage.blobs Liczba Łącznie Liczba IoT Hub routingu dostarczonych obiektów blob do punktów końcowych magazynu. Brak
Routing: dane dostarczane do magazynu d2c.endpoints.egress.storage.bytes Bajty Łącznie Ilość danych (bajtów) IoT Hub routing dostarczany do punktów końcowych magazynu. Brak
Routing: opóźnienie komunikatów dla usługi Event Hubs d2c.endpoints.latency.eventHubs Milisekund Średnia Średnie opóźnienie (w milisekundach) między przychodzącymi komunikatami do IoT Hub i ruchu przychodzącego komunikatów do niestandardowych punktów końcowych typu Event Hubs. Trasy komunikatów do wbudowanego punktu końcowego (zdarzeń) nie są uwzględniane. Brak
Routing: opóźnienie komunikatów dla kolejki usługi Service Bus d2c.endpoints.latency.serviceBusQueues Milisekund Średnia Średnie opóźnienie (w milisekundach) między przychodzącymi komunikatami do IoT Hub i ruchu przychodzącego komunikatów do punktu końcowego kolejki usługi Service Bus. Brak
Routing: opóźnienie komunikatów dla tematu usługi Service Bus d2c.endpoints.latency.serviceBusTopics Milisekund Średnia Średnie opóźnienie (w milisekundach) między wejściem komunikatu do IoT Hub a wejściem komunikatów do punktu końcowego tematu usługi Service Bus. Brak
Routing: opóźnienie komunikatów dla komunikatów/zdarzeń d2c.endpoints.latency.builtIn.events Milisekund Średnia Średnie opóźnienie (w milisekundach) między przychodzącymi komunikatami do IoT Hub i ruchu przychodzącego komunikatów do wbudowanego punktu końcowego (komunikatów/zdarzeń) i trasy rezerwowej. Brak
Routing: opóźnienie komunikatów dla magazynu d2c.endpoints.latency.storage Milisekund Średnia Średnie opóźnienie (w milisekundach) między przychodzącym komunikatem do IoT Hub i ruchu przychodzącego komunikatów do punktu końcowego magazynu. Brak
Routing: komunikaty dostarczane do usługi Event Hubs d2c.endpoints.egress.eventHubs Liczba Łącznie Liczba IoT Hub pomyślnego dostarczenia komunikatów do niestandardowych punktów końcowych typu Event Hubs. Trasy komunikatów do wbudowanego punktu końcowego (zdarzeń) nie są uwzględniane. Brak
Routing: komunikaty dostarczane do kolejki usługi Service Bus d2c.endpoints.egress.serviceBusQueues Liczba Łącznie Liczba IoT Hub pomyślnego routingu komunikatów do punktów końcowych kolejki usługi Service Bus. Brak
Routing: komunikaty dostarczane do tematu usługi Service Bus d2c.endpoints.egress.serviceBusTopics Liczba Łącznie Liczba IoT Hub pomyślnego routingu komunikatów do punktów końcowych tematu usługi Service Bus. Brak
Routing: komunikaty dostarczane do rezerwowego d2c.telemetry.egress.fallback Liczba Łącznie Liczba IoT Hub routingu dostarczonych komunikatów do punktu końcowego skojarzonego z trasą rezerwową. Brak
Routing: komunikaty dostarczane do komunikatów/zdarzeń d2c.endpoints.egress.builtIn.events Liczba Łącznie Liczba IoT Hub pomyślnego dostarczenia komunikatów do wbudowanego punktu końcowego (komunikatów/zdarzeń) i trasy rezerwowej. Brak
Routing: komunikaty dostarczane do magazynu d2c.endpoints.egress.storage Liczba Łącznie Liczba IoT Hub pomyślnego dostarczenia komunikatów do punktów końcowych magazynu. Brak
Routing: komunikaty telemetryczne dostarczane d2c.telemetry.egress.success Liczba Łącznie Liczba komunikatów, które zostały pomyślnie dostarczone do wszystkich punktów końcowych przy użyciu routingu IoT Hub. Jeśli komunikat jest kierowany do wielu punktów końcowych, ta wartość zwiększa się o jedną dla każdego pomyślnego dostarczenia. Jeśli komunikat jest dostarczany do tego samego punktu końcowego wiele razy, ta wartość zwiększa się o jedną dla każdego pomyślnego dostarczenia. Brak
Routing: porzucone komunikaty telemetryczne d2c.telemetry.egress.dropped Liczba Łącznie Liczba porzuconych komunikatów przez routing IoT Hub z powodu utraconych punktów końcowych. Ta wartość nie zlicza komunikatów dostarczonych do trasy rezerwowej, ponieważ porzucone komunikaty nie są tam dostarczane. Brak
Routing: niezgodne komunikaty telemetrii d2c.telemetry.egress.invalid Liczba Łącznie Liczba przypadków, IoT Hub routing nie może dostarczyć komunikatów z powodu niezgodności z punktem końcowym. Komunikat jest niezgodny z punktem końcowym, gdy usługa Iot Hub próbuje dostarczyć komunikat do punktu końcowego i kończy się niepowodzeniem z błędem nie przejściowym. Nieprawidłowe komunikaty nie są ponawiane. Ta wartość nie obejmuje ponownych prób. Brak
Routing: oddzielone komunikaty telemetryczne d2c.telemetry.egress.orphaned Liczba Łącznie Liczba komunikatów oddzielonych przez routing IoT Hub, ponieważ nie są one zgodne z żadnym zapytaniem routingu, gdy trasa rezerwowa jest wyłączona. Brak

W przypadku metryk z wartością Unit (Liczba) tylko agregacja całkowita (suma) jest prawidłowa. Agregacje minimalne, maksymalne i średnie zawsze zwracają wartość 1. Aby uzyskać więcej informacji, zobacz Obsługiwane agregacje.

Metryki zapytań bliźniaczych reprezentacji

Nazwa wyświetlana metryki Metric Jednostka Typ agregacji Opis Wymiary
Nieudane zapytania bliźniaczej reprezentacji twinQueries.failure Liczba Łącznie Liczba wszystkich nieudanych zapytań bliźniaczych. Brak
Pomyślne zapytania bliźniaczej reprezentacji twinQueries.success Liczba Łącznie Liczba wszystkich pomyślnych zapytań bliźniaczych. Brak
Rozmiar wyników zapytań bliźniaczych reprezentacji twinQueries.resultSize Bajty Średnia Łączna liczba wyników wszystkich pomyślnych zapytań bliźniaczych. Brak

W przypadku metryk z wartością Jednostkowa licznika prawidłowa jest tylko agregacja całkowita (suma). Agregacje minimalne, maksymalne i średnie zawsze zwracają 1. Aby uzyskać więcej informacji, zobacz Obsługiwane agregacje.

Wymiary metryk

Azure IoT Hub ma następujące wymiary skojarzone z niektórymi metrykami routingu i usługi Event Grid.

Nazwa wymiaru Opis
Nazwa punktu końcowego Nazwa punktu końcowego
Endpointtype eventHubs, serviceBusQueues, cosmosDB, serviceBusTopics. builtin lub blobStorage
Eventtype Microsoft.Devices.DeviceCreated. Microsoft.Devices.DeviceDeleted, Microsoft.Devices.DeviceConnected, Microsoft.Devices.DeviceDisconnected lub Microsoft.Devices.DeviceTelemetry
Aby uzyskać więcej informacji, zobacz Typy zdarzeń.
FailureReasonCategory Jedną z następujących czynności: nieprawidłowa, porzucona, oddzielona lub null.
Wynik Powodzenie lub niepowodzenie
RoutingSource Komunikaty dotyczące urządzeń
Zdarzenia zmiany bliźniaczej reprezentacji
Zdarzenia cyklu życia urządzenia

Aby dowiedzieć się więcej na temat wymiarów metryk, zobacz Metryki wielowymiarowe.

Dzienniki zasobów

W tej sekcji wymieniono wszystkie typy kategorii dzienników zasobów i schematy zebrane dla Azure IoT Hub. Dostawca zasobów i typ dla wszystkich dzienników IoT Hub to Microsoft.Devices/IotHubs. Zdarzenia są emitowane tylko w przypadku błędów w niektórych kategoriach.

Tematy w tej sekcji

Połączenia

Kategoria połączeń śledzi zdarzenia połączenia urządzenia i odłącza je od centrum IoT i błędów. Ta kategoria jest przydatna do identyfikowania nieautoryzowanych prób połączenia i alertów podczas utraty połączenia z urządzeniami.

Aby uzyskać niezawodny stan połączenia urządzeń, zobacz Monitorowanie stanu połączenia urządzenia.

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

Aby uzyskać szczegółowe informacje na temat używania dzienników połączeń do monitorowania łączności urządzeń, zobacz Monitorowanie, diagnozowanie i rozwiązywanie problemów z łącznością urządzeń z Azure IoT Hub.

Telemetria urządzenia

Kategoria telemetrii urządzenia śledzi błędy występujące w centrum IoT i są powiązane z potokiem telemetrii. Ta kategoria obejmuje błędy występujące podczas wysyłania zdarzeń telemetrycznych (takich jak ograniczanie przepustowości) i odbierania zdarzeń telemetrii (takich jak nieautoryzowany czytnik). Ta kategoria nie może przechwytywać błędów spowodowanych przez kod uruchomiony na samym urządzeniu.

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

Polecenia chmura-urządzenie

Kategoria poleceń chmura-urządzenie śledzi błędy występujące w centrum IoT i są powiązane z potokiem komunikatów chmury do urządzenia. Ta kategoria obejmuje błędy występujące z następujących przyczyn:

  • Wysyłanie komunikatów z chmury do urządzeń (takich jak błędy nieautoryzowanego nadawcy),
  • Odbieranie komunikatów z chmury do urządzenia (na przykład liczba dostaw przekroczyła błędy) i
  • Otrzymywanie opinii o wiadomościach z chmury do urządzenia (takich jak błędy wygasłe).

Ta kategoria nie przechwytuje błędów, gdy komunikat z chmury do urządzenia zostanie pomyślnie dostarczony, ale następnie nieprawidłowo obsłużony przez urządzenie.

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

Operacje na tożsamości urządzenia

Kategoria operacji tożsamości urządzenia śledzi błędy występujące podczas próby utworzenia, zaktualizowania lub usunięcia wpisu w rejestrze tożsamości centrum IoT. Śledzenie tej kategorii jest przydatne w scenariuszach aprowizacji.

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

Operacje przekazywania plików

Kategoria przekazywania plików śledzi błędy występujące w centrum IoT i są związane z funkcjami przekazywania plików. Ta kategoria obejmuje:

  • Błędy występujące z identyfikatorem URI sygnatury dostępu współdzielonego, takie jak po wygaśnięciu przed powiadomieniem urządzenia o zakończeniu przekazywania.

  • Przekazywanie nie powiodło się zgłoszone przez urządzenie.

  • Błędy występujące, gdy plik nie zostanie znaleziony w magazynie podczas tworzenia komunikatu powiadomienia IoT Hub.

Ta kategoria nie może przechwytywać błędów, które występują bezpośrednio podczas przekazywania pliku do magazynu.

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

Kategoria routingu komunikatów śledzi błędy występujące podczas oceny trasy komunikatów i kondycji punktu końcowego postrzegane przez IoT Hub. Ta kategoria obejmuje zdarzenia, takie jak:

  • Reguła ocenia wartość "niezdefiniowaną",
  • IoT Hub oznacza punkt końcowy jako martwy lub
  • Wszelkie błędy odebrane z punktu końcowego.

Ta kategoria nie zawiera konkretnych błędów dotyczących samych komunikatów (takich jak błędy ograniczania przepustowości urządzenia), które są zgłaszane w kategorii "telemetria urządzenia".

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

Poniżej przedstawiono więcej szczegółów dotyczących routingu dzienników zasobów:

Operacje bliźniaczej reprezentacji urządzenia do chmury

Kategoria operacji bliźniaczej reprezentacji urządzenia do chmury śledzi zdarzenia inicjowane przez urządzenie na bliźniaczych reprezentacjach urządzeń. Te operacje mogą obejmować pobieranie bliźniaczych reprezentacji, aktualizowanie zgłoszonych właściwości i subskrybowanie żądanych właściwości.

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

Operacje bliźniaczej reprezentacji chmury do urządzenia

Kategoria operacji bliźniaczej reprezentacji chmury do urządzenia śledzi zdarzenia inicjowane przez usługę na bliźniaczych reprezentacjach urządzeń. Te operacje mogą obejmować pobieranie bliźniaczych reprezentacji, aktualizowanie lub zastępowanie tagów oraz aktualizowanie lub zastępowanie żądanych właściwości.

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

Zapytania bliźniacze

Kategoria zapytań bliźniaczych zgłasza żądania zapytań dotyczące bliźniaczych reprezentacji urządzeń zainicjowanych w chmurze.

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

Operacje zadań

Kategoria operacji zadań zgłasza żądania zadań w celu zaktualizowania bliźniaczych reprezentacji urządzenia lub wywołania metod bezpośrednich na wielu urządzeniach. Te żądania są inicjowane w chmurze.

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

Metody bezpośrednie

Kategoria metody bezpośrednie śledzi interakcje żądań odpowiedzi wysyłane do poszczególnych urządzeń. Te żądania są inicjowane w chmurze.

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

Śledzenie rozproszone (wersja zapoznawcza)

Kategoria śledzenia rozproszonego śledzi identyfikatory korelacji dla komunikatów zawierających nagłówek kontekstu śledzenia. Aby w pełni włączyć te dzienniki, należy zaktualizować kod po stronie klienta, postępując zgodnie z instrukcjami Analizowanie i diagnozowanie aplikacji IoT za pomocą IoT Hub śledzenia rozproszonego (wersja zapoznawcza).

Element correlationId jest zgodny z propozycją kontekstu śledzenia W3C, gdzie zawiera element trace-id i .span-id

dzienniki usługi IoT Hub D2C (urządzenie do chmury)

IoT Hub rejestruje ten dziennik, gdy zostanie wyświetlony komunikat zawierający prawidłowe właściwości śledzenia 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 W tym miejscu nie jest obliczana, ponieważ zegar IoT Hub może nie być zsynchronizowany z zegarem urządzenia, a zatem obliczenie czasu może być mylące. Zalecamy pisanie logiki przy użyciu sygnatur czasowych w properties sekcji w celu przechwycenia skoków opóźnienia urządzenia do chmury.

Właściwość Typ Opis
messageSize Liczba całkowita Rozmiar komunikatu z urządzenia do chmury w bajtach
Deviceid Ciąg znaków alfanumerycznych ASCII 7-bitowych Tożsamość urządzenia
callerLocalTimeUtc Sygnatura czasowa UTC Czas tworzenia komunikatu zgłoszony przez zegar lokalny urządzenia
calleeLocalTimeUtc Sygnatura czasowa UTC Godzina przybycia komunikatu do bramy IoT Hub zgłoszona przez zegar po stronie usługi IoT Hub

dzienniki ruchu przychodzącego IoT Hub

IoT Hub rejestruje ten dziennik, gdy komunikat zawierający prawidłowe właściwości śledzenia zapisuje do wewnętrznych lub wbudowanych usług 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"
        }
    ]
}

properties W sekcji ten dziennik zawiera dodatkowe informacje o ruchu przychodzącym komunikatów.

Właściwość Typ Opis
isRoutingEnabled Ciąg Prawda czy fałsz, wskazuje, czy routing komunikatów jest włączony w IoT Hub
parentSpanId Ciąg Identyfikator zakresu komunikatu nadrzędnego, który byłby śladem komunikatu D2C w tym przypadku

dzienniki ruchu wychodzącego IoT Hub

IoT Hub rejestruje ten dziennik po włączeniu routingu, a komunikat jest zapisywany w punkcie końcowym. Jeśli routing nie jest włączony, IoT Hub nie rejestruje tego dziennika.

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

properties W sekcji ten dziennik zawiera dodatkowe informacje o ruchu przychodzącym komunikatów.

Właściwość Typ Opis
endpointName Ciąg Nazwa punktu końcowego routingu
Endpointtype Ciąg Typ punktu końcowego routingu
parentSpanId Ciąg Identyfikator zakresu komunikatu nadrzędnego, który byłby IoT Hub śledzenia komunikatów przychodzących w tym przypadku

Konfiguracje

IoT Hub dzienniki konfiguracji śledzą zdarzenia i błędy zestawu funkcji Automatyczne Zarządzanie urządzeniami.

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

Strumienie urządzeń (wersja zapoznawcza)

Kategoria strumieni urządzeń śledzi interakcje wysyłane do poszczególnych urządzeń.

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

Tabele dzienników usługi Azure Monitor

Ta sekcja odnosi się do wszystkich tabel kusto dzienników usługi Azure Monitor istotnych dla Azure IoT Hub i dostępnych do wykonywania zapytań przez usługę Log Analytics. Aby uzyskać listę tych tabel i linki do dodatkowych informacji dotyczących typu zasobu IoT Hub, zobacz IoT Hub w dokumentacji tabeli dzienników usługi Azure Monitor.

Aby zapoznać się ze wszystkimi tabelami dzienników usługi Azure Monitor/log Analytics, zobacz Dokumentacja tabeli dzienników usługi Azure Monitor.

Zobacz też