Справочник по мониторингу данных в Центре Интернета вещей Azure

Сведения о сборе и анализе данных мониторинга для Центра Интернета вещей Azure см. в статье Мониторинг Центра Интернета вещей Azure.

Метрики

В этом разделе перечислены все метрики платформы, автоматически собираемые для Центра Интернета вещей Azure. Пространство имен поставщика ресурсов для метрик Центра Интернета вещей — Microsoft.Devices. Пространство имен типов — IoTHubs.

В следующих подразделах подробно рассматриваются метрики платформы "Центр Интернета вещей", классифицированные по общим категориям, и перечисляются имена метрик, отображаемые на портале Azure. Также для метрик в каждом подразделе указана соответствующая информация.

Единая таблица со списком всех метрик платформы "Центр Интернета вещей", упорядоченных по имени, представлена в разделе Microsoft.Devices/IotHubs документа, посвященного Azure Monitor. Имейте в виду, что в отличие от этой статьи в указанной таблице содержатся не все сведения, например в ней не представлены поддерживаемые агрегирования для некоторых метрик.

Дополнительные сведения о метриках, поддерживаемых другими службами Azure, см. в статье Метрики, поддерживаемые Azure Monitor.

Темы в этом разделе

Поддерживаемые агрегирования

Столбец Тип агрегирования в каждой таблице соответствует агрегированию по умолчанию, которое используется при выборе метрики для диаграммы или оповещения.

Screenshot showing aggregation for metrics

Для большинства метрик допустимы все типы агрегирования. Однако для метрик количества, у которых для параметра Единица указано значение Количество, допустимы только некоторые агрегирования. Есть два типа метрик количества:

  • Для метрик количества Single-point (Одна точка) Центр Интернета вещей регистрирует одну точку (фактически указывая единицу) каждый раз при выполнении операции измерения. Затем Azure Monitor суммирует эти точки данных в зависимости от указанной степени детализации. Примеры метрик Single-point (Одна точка): Telemetry messages sent (Число отправленных сообщений телеметрии) и C2D message deliveries completed (Доставленные сообщения из облака на устройство (C2D)). Для таких метрик подходит только один тип агрегирования — сумма. На портале можно выбрать минимальное, максимальное и среднее значения. Однако эти значения всегда будут равны единице.

  • Для метрик количества Моментальный снимок Центр Интернета вещей регистрирует общее количество при выполнении операций измерения. В настоящее время в Центр Интернета вещей генерируется три метрики Моментальный снимок: Total number of messages used (Общее количество используемых сообщений), Total devices (preview) (Всего устройств (предварительная версия)) и Connected devices (preview) (Подключенных устройств (предварительная версия)). Так как каждая такая метрика представляет собой "суммарное" количество, их суммирование с указанной степенью детализации не имеет смысла. В качестве типа агрегирования для этих метрик в Azure Monitor можно выбрать только среднее, минимальное или максимальное значение.

Метрики команд (из облака на устройство)

Отображаемое имя метрики Метрика Unit Тип статистической обработки Описание Измерения
Сообщения из облака на устройство (C2D) с истекшим сроком действия (предварительная версия) C2DMessagesExpired Count Итог Число сообщений, отправленных из облака на устройство, с истекшим сроком действия Нет
Доставленные сообщения из облака на устройство (C2D) c2d.commands.egress.complete.success Count Итог Число успешно доставленных устройством сообщений, отправленных из облака Нет
Отброшенные сообщения из облака на устройство (C2D) c2d.commands.egress.abandon.success Count Итог Число отброшенных устройством сообщений, отправленных из облака Нет
Отклоненные сообщения из облака на устройство (C2D) c2d.commands.egress.reject.success Count Итог Число отклоненных устройством сообщений, отправленных из облака Нет

Для метрик, у которых для параметра Единица указано значение Количество, доступно только агрегирование суммирования. Агрегирования минимального, максимального и среднего значения всегда возвращает значение 1. Дополнительные сведения см. в разделе Поддерживаемые агрегирования.

Метрики прямых методов (из облака на устройство)

Отображаемое имя метрики Метрика Unit Тип статистической обработки Описание Измерения
Неудачные вызовы прямых методов. c2d.methods.failure Count Итог Число всех неудачных вызовов прямых методов. Нет
Размер запроса вызовов прямых методов. c2d.methods.requestSize Байты Среднее Число всех успешных запросов прямых методов. Нет
Размер ответа вызовов прямых методов. c2d.methods.responseSize Байты Среднее Число всех успешных ответов прямых методов. Нет
Успешные вызовы прямых методов. c2d.methods.success Count Итог Число всех успешных вызовов прямых методов. Нет

Для метрик, у которых для параметра Единица указано значение Количество, доступно только агрегирование суммирования. Агрегирования минимального, максимального и среднего значения всегда возвращает значение 1. Дополнительные сведения см. в разделе Поддерживаемые агрегирования.

Метрики операций (из облака на двойник устройства)

Отображаемое имя метрики Метрика Unit Тип статистической обработки Описание Измерения
Неудачные операции чтения с двойников, инициированные из серверной части. c2d.twin.read.failure Count Итог Число всех неудачных операций чтения с двойников, инициированных из серверной части. Нет
Неудачные обновления двойников, инициированные из серверной части. c2d.twin.update.failure Count Итог Число всех неудачных обновлений двойников, инициированных из серверной части. Нет
Размер ответа операций чтения с двойников, инициированных из серверной части. c2d.twin.read.size Байты Среднее Число всех успешных операций чтения с двойников, инициированных из серверной части. Нет
Размер обновлений двойников, инициированных из серверной части. c2d.twin.update.size Байты Среднее Общий размер всех успешных обновлений двойников, инициированных из серверной части. Нет
Успешные операции чтения с двойников, инициированные из серверной части. c2d.twin.read.success Count Итог Число всех успешных операций чтения с двойников, инициированных из серверной части. Нет
Успешные обновления двойников, инициированные из серверной части. c2d.twin.update.success Count Итог Число всех успешных обновлений двойников, инициированных из серверной части. Нет

Для метрик, у которых для параметра Единица указано значение Количество, доступно только агрегирование суммирования. Агрегирования минимального, максимального и среднего значения всегда возвращает значение 1. Дополнительные сведения см. в разделе Поддерживаемые агрегирования.

Метрики конфигурации

Отображаемое имя метрики Метрика Unit Тип статистической обработки Описание Измерения
Configuration Metrics (Метрики конфигурации) конфигурации Count Итог Общее число операций CRUD, выполненных для конфигурации устройства и развертывания IoT Edge, на наборе целевых устройств. Сюда также входит количество операций, изменяющих двойников устройств или двойников модуля из-за этих конфигураций. Нет

Для метрик, у которых для параметра Единица указано значение Количество, доступно только агрегирование суммирования. Агрегирования минимального, максимального и среднего значения всегда возвращает значение 1. Дополнительные сведения см. в разделе Поддерживаемые агрегирования.

Метрики суточной квоты

Отображаемое имя метрики Метрика Unit Тип статистической обработки Описание Измерения
Общий объем использования данных устройствами deviceDataUsage Байты Итог Байты, переданные на любые устройства, подключенные к Центру Интернета вещей, и с них Нет
Total device data usage (preview) (Общий объем использования данных устройствами (предварительная версия)) deviceDataUsageV2 Байты Итог Байты, переданные на любые устройства, подключенные к Центру Интернета вещей, и с них Нет
Общее количество используемых сообщений dailyMessageQuotaUsed Count Среднее Количество сообщений, использованных сегодня. Это совокупное значение, которое сбрасывается до нуля в 00:00 UTC каждый день. Нет

Для метрики Total number of messages used (Общее количество используемых сообщений) поддерживаются только агрегирования минимального, максимального и среднего значения. Дополнительные сведения см. в разделе Поддерживаемые агрегирования.

Параметры устройства:

Отображаемое имя метрики Метрика Unit Тип статистической обработки Описание Измерения
Total devices (deprecated) (Всего устройств (не рекомендуется)) devices.totalDevices Count Итог Число устройств, зарегистрированных в Центре Интернета вещей. Нет
Connected devices (deprecated) (Подключенные устройства (не рекомендуется)) devices.connectedDevices.allProtocol Count Итог Число устройств, подключенных к Центру Интернета вещей. Нет
Total devices (preview) (Всего устройств (предварительная версия)) totalDeviceCount Count Среднее Число устройств, зарегистрированных в Центре Интернета вещей. Нет
Connected devices (preview) (Подключенных устройств (предварительная версия)) connectedDeviceCount Count Среднее Число устройств, подключенных к Центру Интернета вещей. Нет

Для метрик Total devices (deprecated) (Всего устройств (не рекомендуется)) и Connected devices (deprecated) (Подключенные устройства (не рекомендуется)) доступно только агрегирование суммирования. Агрегирования минимального, максимального и среднего значения всегда возвращает значение 1. Дополнительные сведения см. в разделе Поддерживаемые агрегирования.

Для метрик Total devices (preview) (Всего устройств (предварительная версия)) и Connected devices (preview) (Подключенных устройств (предварительная версия)) доступны только агрегирования минимального, максимального и среднего значения. Дополнительные сведения см. в разделе Поддерживаемые агрегирования.

Метрики Connected devices (preview) (Подключенных устройств (предварительная версия)) и Total devices (preview) (Всего устройств (предварительная версия)) нельзя экспортировать с помощью параметров диагностики.

Метрики телеметрии устройств

Отображаемое имя метрики Метрика Unit Тип статистической обработки Описание Измерения
Количество ошибок регулирования d2c.telemetry.ingress.sendThrottle Count Итог Количество ошибок регулирования из-за регулирования пропускной способности устройства Нет
Число предпринятых попыток отправки сообщений телеметрии. d2c.telemetry.ingress.allProtocol Count Итог Число предпринятых попыток отправки в Центр Интернета вещей сообщений телеметрии из устройства в облако. Нет
Число отправленных сообщений телеметрии. d2c.telemetry.ingress.success Count Итог Число успешно отправленных в Центр Интернета вещей сообщений телеметрии из устройства в облако. Нет

Для метрик, у которых для параметра Единица указано значение Количество, доступно только агрегирование суммирования. Агрегирования минимального, максимального и среднего значения всегда возвращает значение 1. Дополнительные сведения см. в разделе Поддерживаемые агрегирования.

Метрики операций (с устройства на двойник устройства)

Отображаемое имя метрики Метрика Unit Тип статистической обработки Описание Измерения
Неудачные операции чтения с двойников, инициированные устройством. d2c.twin.read.failure Count Итог Число всех неудачных операций чтения с двойников, инициированных устройством. Нет
Неудачные обновления двойников, инициированные устройством. d2c.twin.update.failure Count Итог Число всех неудачных обновлений двойников, инициированных устройством. Нет
Размер ответа операций чтения с двойников, инициированных устройством. d2c.twin.read.size Байты Среднее Число всех успешных операций чтения с двойников, инициированных устройством. Нет
Размер обновлений двойников, инициированных устройством. d2c.twin.update.size Байты Среднее Общий размер успешных обновлений двойников, инициированных устройством. Нет
Успешные операции чтения с двойников, инициированные устройством. d2c.twin.read.success Count Итог Число всех успешных операций чтения с двойников, инициированных устройством. Нет
Успешные обновления двойников, инициированные устройством. d2c.twin.update.success Count Итог Число всех успешных обновлений двойников, инициированных устройством. Нет

Для метрик, у которых для параметра Единица указано значение Количество, доступно только агрегирование суммирования. Агрегирования минимального, максимального и среднего значения всегда возвращает значение 1. Дополнительные сведения см. в разделе Поддерживаемые агрегирования.

Метрики сетки событий

Отображаемое имя метрики Метрика Unit Тип статистической обработки Описание Измерения
Event Grid deliveries (preview) (Доставки Сетки событий (предварительная версия)) EventGridDeliveries Count Итог Число событий Центра Интернета вещей, опубликованных в сетке событий. Используйте измерение Result в качестве количества успешных и неудачных запросов. Измерение EventType показывает тип события ( https://aka.ms/ioteventgrid ). Результат:
EventType
Дополнительные сведения см. в разделе Измерения метрик .
Задержка сетки событий (предварительная версия) EventGridLatency Миллисекунды Среднее Средняя задержка (в миллисекундах) с момента создания события в Центре Интернета вещей до момента публикации события в Сетке событий. Это число является средним значением для всех типов событий. Используйте измерение EventType для просмотра задержки определенного типа события. EventType
Дополнительные сведения см. в разделе Измерения метрик .

Для метрик, у которых для параметра Единица указано значение Количество, доступно только агрегирование суммирования. Агрегирования минимального, максимального и среднего значения всегда возвращает значение 1. Дополнительные сведения см. в разделе Поддерживаемые агрегирования.

Метрики заданий

Отображаемое имя метрики Метрика Unit Тип статистической обработки Описание Измерения
Завершенные задания jobs.completed Count Итог Количество всех выполненных заданий. Нет
Неудачные вызовы получения списка заданий. jobs.listJobs.failure Count Итог Количество всех неудачных вызовов для получения списка заданий. Нет
Неудачные операции создания заданий вызова методов. jobs.createDirectMethodJob.failure Count Итог Количество всех неудачных операций создания заданий вызова прямых методов. Нет
Неудачные операции создания заданий обновления двойников. jobs.createTwinUpdateJob.failure Count Итог Количество всех неудачных операций создания заданий обновления двойников. Нет
Неудачные отмены заданий. jobs.cancelJob.failure Count Итог Количество всех неудачных вызовов для отмены заданий. Нет
Неудачные запросы заданий. jobs.queryJobs.failure Count Итог Количество всех неудачных вызовов для запроса заданий. Нет
Неудачные задания. jobs.failed Count Итог Количество всех неудачных заданий. Нет
Успешные вызовы получения списка заданий. jobs.listJobs.success Count Итог Количество всех успешных вызовов для получения списка заданий. Нет
Успешные операции создания заданий вызова методов. jobs.createDirectMethodJob.success Count Итог Количество всех успешных операций создания заданий вызова прямых методов. Нет
Успешные операции создания заданий обновления двойников. jobs.createTwinUpdateJob.
Успешное завершение
Count Итог Количество всех успешных созданий заданий обновления двойников. Нет
Успешные отмены заданий. jobs.cancelJob.success Count Итог Количество всех успешных вызовов для отмены заданий. Нет
Успешные запросы заданий. jobs.queryJobs.success Count Итог Количество всех успешных вызовов для запроса заданий. Нет

Для метрик, у которых для параметра Единица указано значение Количество, доступно только агрегирование суммирования. Агрегирования минимального, максимального и среднего значения всегда возвращает значение 1. Дополнительные сведения см. в разделе Поддерживаемые агрегирования.

Метрики маршрутизации

Отображаемое имя метрики Метрика Unit Тип статистической обработки Описание Измерения
Routing Delivery Attempts (preview) (Попытки маршрутизации доставки (предварительная версия)) RoutingDeliveries Count Итог Это метрика маршрутизации доставки. Используйте измерения, чтобы определить состояние доставки для заданной конечной точки или для заданного источника маршрутизации. Результат:
RoutingSource,
EndpointType,
FailureReasonCategory,
EndpointName
Дополнительные сведения см. в разделе Измерения метрик .
Routing Delivery Data Size In Bytes (preview) (Размер данных о маршрутизации доставки в байтах (предварительная версия)) RoutingDataSizeInBytesDelivered Байты Итог Общее число байтов, направляемых Центром Интернета вещей в пользовательскую и встроенную конечные точки. Используйте измерения, чтобы определить размер данных, отправленных в заданную конечную точку или для заданного источника маршрутизации. RoutingSource,
EndpointType
EndpointName
Дополнительные сведения см. в разделе Измерения метрик .
Routing Latency (preview) (Задержка маршрутизации (предварительная версия)) RoutingDeliveryLatency Миллисекунды Среднее Это метрика задержки маршрутизации доставки. Используйте измерения, чтобы определить задержку для заданной конечной точки или для заданного источника маршрутизации. RoutingSource,
EndpointType,
EndpointName
Дополнительные сведения см. в разделе Измерения метрик .
Routing: blobs delivered to storage (Маршрутизация: доставлено BLOB-объектов в хранилище) d2c.Endpoints.egress.Storage.BLOBs Count Итог Количество раз, когда подсистема маршрутизации Центра Интернета вещей доставила BLOB-объекты на конечные точки хранилища. Нет
Routing: data delivered to storage (Маршрутизация: доставлено данных в хранилище) d2c.endpoints.egress.storage.bytes Байты Итог Объем данных (в байтах), доставленных подсистемой маршрутизации Центра Интернета вещей на конечные точки хранилища. Нет
Routing: message latency for Event Hub (Маршрутизация: задержка сообщений для концентратора событий) d2c.endpoints.latency.eventHubs Миллисекунды Среднее Средняя задержка (в миллисекундах) между поступлением сообщения в Центр Интернета вещей и его поступлением на пользовательские конечные точки концентратора событий. Здесь не учитываются маршруты сообщений, направляемых на встроенную конечную точку (events). Нет
Routing: message latency for Service Bus Queue (Маршрутизация: задержка сообщений для очереди служебной шины) d2c.endpoints.latency.serviceBusQueues Миллисекунды Среднее Средняя задержка (в миллисекундах) между поступлением сообщения в Центр Интернета вещей и поступлением сообщения на конечную точку очереди служебной шины. Нет
Routing: message latency for Service Bus Topic (Маршрутизация: задержка сообщений для раздела служебной шины) d2c.endpoints.latency.serviceBusTopics Миллисекунды Среднее Средняя задержка (в миллисекундах) между поступлением сообщения в Центр Интернета вещей и поступлением сообщения на конечную точку раздела служебной шины. Нет
Routing: message latency for messages/events (Маршрутизация: задержка сообщений для messages/events) d2c.endpoints.latency.builtIn.events Миллисекунды Среднее Средняя задержка (в миллисекундах) между поступлением сообщения в Центр Интернета вещей и поступлением сообщения на встроенную конечную точку (messages/events) и резервный маршрут. Нет
Routing: message latency for storage (Маршрутизация: задержка сообщений для хранилища) d2c.Endpoints.latency.Storage Миллисекунды Среднее Средняя задержка (в миллисекундах) между поступлением сообщения в Центр Интернета вещей и поступлением сообщения на конечную точку хранилища. Нет
Routing: messages delivered to Event Hub (Маршрутизация: доставлено сообщений в концентратор событий) d2c.endpoints.egress.eventHubs Count Итог Количество раз, когда подсистема маршрутизации Центра Интернета вещей успешно доставила сообщения на пользовательские конечные точки концентратора событий. Здесь не учитываются маршруты сообщений, направляемых на встроенную конечную точку (events). Нет
Routing: messages delivered to Service Bus Queue (Маршрутизация: доставлено сообщений в очередь служебной шины) d2c.endpoints.egress.serviceBusQueues Count Итог Количество раз, когда подсистема маршрутизации Центра Интернета вещей успешно доставила сообщения на конечные точки очереди служебной шины. Нет
Routing: messages delivered to Service Bus Topic (Маршрутизация: доставлено сообщений в раздел служебной шины) d2c.endpoints.egress.serviceBusTopics Count Итог Количество раз, когда подсистема маршрутизации Центра Интернета вещей успешно доставила сообщения на конечные точки раздела служебной шины. Нет
Routing: messages delivered to fallback (Маршрутизация: доставлено сообщений на резервный маршрут) d2c.telemetry.egress.fallback Count Итог Количество раз, когда подсистема маршрутизации Центра Интернета вещей доставляла сообщения на конечную точку, связанную с резервным маршрутом. Нет
Routing: messages delivered to messages/events (Маршрутизация: доставлено сообщений на конечную точку messages/events) d2c.endpoints.egress.builtIn.events Count Итог Количество раз, когда подсистема маршрутизации Центра Интернета вещей успешно доставила сообщения на встроенную конечную точку (messages/events) и резервный маршрут. Нет
Routing: messages delivered to storage (Маршрутизация: доставлено сообщений в хранилище) d2c.Endpoints.egress.Storage Count Итог Количество раз, когда подсистема маршрутизации Центра Интернета вещей успешно доставила сообщения на конечные точки хранилища. Нет
Routing: telemetry messages delivered (Маршрутизация: доставлено сообщений телеметрии) d2c.telemetry.egress.success Count Итог Количество раз, когда сообщения были успешно доставлены на все конечные точки с помощью маршрутизации Центра Интернета вещей. Если сообщение направляется на несколько конечных точек, это значение увеличивается на единицу для каждой успешной доставки. Если сообщение доставлено несколько раз на одну конечную точку, это значение увеличивается на единицу для каждой успешной доставки. Нет
Routing: telemetry messages dropped (Маршрутизация: отброшено сообщений телеметрии) d2c.telemetry.egress.dropped Count Итог Количество раз, когда сообщения удалялись подсистемой маршрутизации Центра Интернета вещей из-за неработоспособности конечных точек. В этом значении не учитываются сообщения, доставленные через резервный маршрут, так как отброшенные сообщения туда не доставляются. Нет
Routing: telemetry messages incompatible (Маршрутизация: несовместимых сообщений телеметрии) d2c.telemetry.egress.invalid Count Итог Количество раз, когда подсистеме маршрутизации Центра Интернета вещей не удалось доставить сообщения из-за несовместимости с конечной точкой. Сообщение несовместимо с конечной точкой, если при попытке Центра Интернета вещей доставить сообщение в конечную точку возникает ошибка, отличная от временной. Для недопустимых сообщений повторная отправка не выполняется. В это значение не входят повторные попытки. Нет
Routing: telemetry messages orphaned (Маршрутизация: потеряно сообщений телеметрии) d2c.telemetry.egress.orphaned Count Итог Количество раз, когда сообщения были потеряны подсистемой маршрутизации Центра Интернета вещей из-за того, что они не соответствуют ни одному запросу маршрутизации, если резервный маршрут отключен. Нет

Для метрик, у которых для параметра Единица указано значение Количество, доступно только агрегирование суммирования. Агрегирования минимального, максимального и среднего значения всегда возвращает значение 1. Дополнительные сведения см. в разделе Поддерживаемые агрегирования.

Метрики запросов к двойникам

Отображаемое имя метрики Метрика Unit Тип статистической обработки Описание Измерения
Неудачные запросы двойников. twinQueries.failure Count Итог Количество всех неудачных запросов двойников. Нет
Успешные запросы двойников. twinQueries.success Count Итог Число всех успешных запросов двойников. Нет
Размер результатов запросов двойников. twinQueries.resultSize Байты Среднее Общий размер результатов всех успешных запросов двойников. Нет

Для метрик, у которых для параметра Единица указано значение Количество, доступно только агрегирование суммирования. Агрегирования минимального, максимального и среднего значения всегда возвращает значение 1. Дополнительные сведения см. в разделе Поддерживаемые агрегирования.

Измерения метрик

У Центра Интернета вещей Azure с некоторыми метриками маршрутизации и сетки событий связаны следующие измерения.

Название измерения Описание
EndpointName Имя конечной точки.
EndpointType Одно из следующих значений: eventHubs, serviceBusQueues, cosmosDB, serviceBusTopics. builtin или blobStorage.
EventType Один из следующих типов событий Сетки событий: Microsoft.Devices.DeviceCreated. Microsoft.Devices.DeviceDeleted, Microsoft.Devices.DeviceConnected, Microsoft.Devices.DeviceDisconnected или Microsoft.Devices.DeviceTelemetry. Дополнительные сведения см. в разделе Типы событий.
FailureReasonCategory Одно из следующих значений: invalid, dropped, orphaned или null.
Результат Значение success или failure.
RoutingSource Сообщения устройств
События изменения двойников
События жизненного цикла устройства

Дополнительные сведения об измерениях метрик см. в разделе Многомерные метрики.

Журналы ресурсов

В этом разделе перечислены все типы категорий и схемы журнала ресурсов, собранные для Центра Интернета вещей Azure. Поставщиком ресурсов и типом для всех журналов Центра Интернета вещей является Microsoft.Devices/IotHubs.

Темы в этом разделе

Соединения

Категория соединений отслеживает устройство, которое соединяет и отключает события из центра IoT, а также ошибки. Эта категория полезна для отслеживания несанкционированных попыток подключения и получения оповещений при потере подключения к устройствам.

Примечание

Чтобы убедиться в состоянии надежного подключения устройств, проверьте пульс устройства.

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

Телеметрия устройства

Категория телеметрии устройств отслеживает ошибки, которые возникают в центре IoT и связаны с конвейером телеметрии. В эту категорию входят ошибки, возникающие при отправке событий телеметрии (например: регулирование) и при получении событий телеметрии (например: неавторизованный модуль чтения). Эта категория не может перехватывать ошибки, которые вызваны кодом, выполняемым на самом устройстве.

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

Отправка команд из облака на устройство

Категория отправки команд из облака на устройство отслеживает ошибки, которые возникают в Центре Интернета вещей и связаны с конвейером сообщений из облака на устройство. В эту категорию входят ошибки, возникающие в следующих ситуациях:

  • отправка сообщений из облака на устройство (например, ошибка неавторизированного отправителя);
  • получение сообщений из облака на устройство (например, ошибки превышения количества доставляемых сообщений);
  • получение ответов на сообщение из облака на устройство (например, ошибки истечения срока действия для отзыва).

Эта категория не перехватывает ошибки, если сообщение из облака на устройстве было успешно доставлено, но неправильно обработано на устройстве.

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

Операции с удостоверениями устройства

Категория операций с удостоверениями устройств отслеживает ошибки, возникающие, когда вы пытаетесь создать, обновить или удалить запись реестра удостоверений центра IoT. Отслеживание этой категории целесообразно для сценариев подготовки.

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

Операции отправки файлов

Категория передачи файлов позволяет отслеживать ошибки, которые возникают в центре IoT и связаны с функцией передачи файлов. В эту категорию входят:

  • ошибки, связанные с универсальным кодом ресурса (URI) SAS (например, если срок его действия истекает до того, как устройство уведомит центр о завершении передачи);

  • сбои передач, о которых сообщает устройство;

  • ошибки, связанные с отсутствием файла в хранилище при создании уведомления для Центра Интернета вещей.

Обратите внимание, что эта категория не может перехватывать ошибки, которые возникают, когда устройство непосредственно передает файл в хранилище.

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

Маршруты

Категория маршрутизации сообщений отслеживает ошибки, возникающие во время оценки маршрута сообщений и при определении состояния работоспособности конечной точки Центром Интернета вещей. В эту категорию входят такие события, как:

  • правило возвращает значение "не определено";
  • Центр Интернета вещей помечает конечную точку как неработоспособную;
  • любые ошибки, полученные от конечной точки.

Эта категория не содержит конкретных ошибок, связанных с самими сообщениями (например, ошибки регулирования устройств), которые попадают в категорию "телеметрия устройств".

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

По следующим ссылкам можно подробнее узнать о журналах ресурсов маршрутизации.

Операции переноса с двойника устройства в облако

Категория операций переноса с двойника устройства в облако отслеживает события, инициируемые устройством на двойниках устройства. Эти операции могут включать получение двойника, обновление сообщаемых свойств и подписку на необходимые свойства.

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

Операции переноса из облака на двойник устройства

Категория операций переноса из облака на двойник устройства отслеживает события, инициируемые службой, на двойнике устройства. Эти операции могут включать получение двойника, обновление или замещение тегов и необходимых свойств.

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

запросы к двойникам;

Категория запросов к двойникам сообщает о запросах к двойникам устройств, инициируемых в облаке.

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

Операции заданий

Категория операций заданий сообщает о запросах задания по обновлению двойников устройства или вызову прямого метода на нескольких устройствах. Эти запросы инициируются в облаке.

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

Прямые методы

Категория прямых методов отслеживает взаимодействия типа "запрос — ответ", отправленные на отдельные устройства. Эти запросы инициируются в облаке.

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

Распределенная трассировка (предварительная версия)

Категория распределенной трассировки позволяет отследить идентификаторы корреляции для сообщений, содержащих заголовок контекста трассировки. Чтобы полностью включить эти журналы, необходимо обновить код на стороне клиента, выполнив действия, описанные в статье о комплексном анализе и диагностике приложений Интернета вещей с помощью распределенной трассировки в Центре Интернета вещей (предварительная версия).

Обратите внимание, что correlationId соответствует предложению correlationId , где оно содержит, trace-id а также span-id .

Журналы D2C (с устройства в облако) в Центре Интернета вещей

В Центре Интернета вещей в этот журнал записывается информация при получении сообщения, содержащего допустимые свойства трассировки.

{
    "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 не подсчитывается, так как часы Центра Интернета вещей могут быть не синхронизированы с часами устройства, из-за чего расчет длительности может давать ошибочные результаты. Рекомендуется создавать логику с использованием метки времени в разделе properties, чтобы записывать пики задержки соединения устройства с облаком.

Свойство Тип Описание
messageSize Целочисленный тип Размер сообщения, поступающего с устройства в облако, в байтах
deviceId Строка 7-битовых букв и цифр ASCII Удостоверение устройства
callerLocalTimeUtc Метка времени в формате UTC Время создания сообщения, измеренное локальными часами устройства
calleeLocalTimeUtc Метка времени в формате UTC Время поступления сообщения в шлюз Центра Интернета вещей, измеренное часами на стороне службы Центра Интернета вещей

Журналы входящего трафика Центра Интернета вещей

В Центре Интернета вещей в этом журнале фиксируется информация, когда сообщение, содержащее допустимые свойства трассировки записывается во внутренний или встроенный концентратор событий.

{
    "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 этот журнал содержит дополнительные сведения о поступлении сообщений.

Свойство Тип Описание
isRoutingEnabled Строка Значение true или false показывает, включена ли маршрутизация сообщений в Центре Интернета вещей
parentSpanId Строка Span-id родительского сообщения, которое в этом случае является трассировкой сообщения, передаваемого из устройства в облако (D2C)

Журналы исходящего трафика Центра Интернета вещей

В Центре Интернета вещей в этом журнале фиксируется информация, когда включена маршрутизация и сообщение записывается для конечной точки. Если маршрутизация не включена, в Центре Интернета вещей не фиксируется информация в этом журнале.

{
    "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 этот журнал содержит дополнительные сведения о поступлении сообщений.

Свойство Тип Описание
endpointName Строка Имя конечной точки маршрутизации
endpointType Строка Тип конечной точки маршрутизации
parentSpanId Строка Span-id родительского сообщения, которое в этом случае является трассировкой сообщения входящего трафика Центра Интернета вещей

Конфигурации

В журналах конфигурации Центра Интернета вещей регистрируются события и ошибки набора функций автоматического управления устройствами.

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

Потоки устройства (предварительная версия)

Категория потоков устройства отслеживает взаимодействия типа "запрос — ответ", отправленные на отдельные устройства.

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

Этот раздел относится ко всем таблицам Kusto журналов Azure Monitor, относящимся к Центру Интернета вещей Azure и доступным для запросов Log Analytics. Список этих таблиц и ссылки на дополнительные сведения о типе ресурсов центра Интернета вещей см. в разделе Справочник по журналам Azure Monitor в центре Интернета вещей .

Справочные сведения обо всех журналах Azure Monitor и таблицах Log Analytics см. в статье Справочник по таблицам журналов Azure Monitor по типам ресурсов.

См. также: