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

Чтобы приступить к мониторингу Azure, ознакомьтесь со статьей Мониторинг Центра Интернета вещей Azure, чтобы понять, как собирать и анализировать данные мониторинга для Центра Интернета вещей Azure.

Эта статья содержит справочные материалы по реализации мониторинга Azure.

Основные разделы в этой справочной статье:

Метрики

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

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

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

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

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

Выберите раздел, чтобы перейти к сведениям о ней на этой странице.

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

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

Снимок экрана, где показан параметр агрегирования для метрик

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

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

  • Для метрик количества Моментальный снимок Центр Интернета вещей регистрирует общее количество при выполнении операций измерения. В настоящее время Центр Интернета вещей создает три метрики моментальных снимков : Общее количество используемых сообщений, Общее число устройств и Подключенные устройства. Так как эти метрики представляют "общее" количество каждый раз, когда они создаются, суммировать их по заданной степени детализации не имеет смысла. В качестве типа агрегирования для этих метрик в 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 Итог Число устройств, подключенных к Центру Интернета вещей. Нет
Общее число устройств. totalDeviceCount Count Среднее Число устройств, зарегистрированных в Центре Интернета вещей. Нет
Подключенные устройства connectedDeviceCount Count Среднее Число устройств, подключенных к Центру Интернета вещей. Нет

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

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

Всего устройств и подключенных устройств нельзя экспортировать с помощью параметров диагностики.

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

Отображаемое имя метрики Метрика 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 Тип статистической обработки Описание Измерения
Доставки сетки событий 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 Тип статистической обработки Описание Измерения
Маршрутизация доставки (предварительная версия) RoutingDeliveries Count Итог Метрика доставки маршрутизации. Используйте измерения, чтобы определить состояние доставки для заданной конечной точки или для заданного источника маршрутизации. Результат:
RoutingSource,
EndpointType,
FailureReasonCategory,
EndpointName
Дополнительные сведения см. в разделе Измерения метрик .
Размер сообщения доставки маршрутизации в байтах (предварительная версия) RoutingDataSizeInBytesDelivered Байты Итог Общее число байтов, направляемых Центром Интернета вещей в пользовательскую и встроенную конечные точки. Используйте измерения, чтобы определить размер данных, отправленных в заданную конечную точку или для заданного источника маршрутизации. RoutingSource,
EndpointType
EndpointName
Дополнительные сведения см. в разделе Измерения метрик .
Задержка маршрутизации доставки (предварительная версия) 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 Байты Итог Объем данных (в байтах), доставленных подсистемой маршрутизации Центра Интернета вещей на конечные точки хранилища. Нет
Маршрутизация: задержка сообщений для Центров событий d2c.endpoints.latency.eventHubs Миллисекунды Среднее Средняя задержка (в миллисекундах) между входящий трафик сообщения до Центр Интернета вещей и входящий трафик сообщений в пользовательские конечные точки типа Центры событий. Маршруты сообщений во встроенную конечную точку (события) не включаются. Нет
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 Миллисекунды Среднее Средняя задержка (в миллисекундах) между поступлением сообщения в Центр Интернета вещей и поступлением сообщения на конечную точку хранилища. Нет
Маршрутизация: сообщения, доставляемые в Центры событий d2c.endpoints.egress.eventHubs Count Итог Количество успешной доставки сообщений в пользовательские конечные точки типа Центров событий Центр Интернета вещей маршрутизацией. Маршруты сообщений во встроенную конечную точку (события) не включаются. Нет
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.
Результат Успех илисбой
RoutingSource Сообщения устройств
События изменения двойников
События жизненного цикла устройства

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

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

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

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

Соединения

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

Сведения о состоянии надежного подключения устройств см. в разделе Мониторинг состояния подключения устройства.

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

Подробные сведения об использовании журналов подключений для мониторинга возможности подключения устройств см. в статье Мониторинг, диагностика и устранение неполадок возможности подключения устройств к Центру Интернета вещей Azure.

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

Категория телеметрии устройств отслеживает ошибки, которые возникают в центре 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 предложению контекста трассировки W3C , где содержит 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 по типам ресурсов.

См. также: