Справочник по мониторингу данных в Центре Интернета вещей Azure
Чтобы приступить к работе с мониторингом Azure, см. статью Мониторинг Центр Интернета вещей Azure, чтобы понять, как собирать и анализировать данные мониторинга для Центр Интернета вещей Azure.
Эта статья содержит справочные материалы по реализации мониторинга Azure.
Основные разделы этой справочной статьи:
Метрики: списки Центр Интернета вещей метрик платформы по темам
Измерения метрик: измерения для маршрутизации и метрик Сетки событий
Журналы ресурсов: журналы по типам категорий и схемам, собранные для Центр Интернета вещей Azure
Таблицы журналов Azure Monitor: обсуждаются таблицы Kusto журналов Azure Monitor
Или перейдите непосредственно к справочнику по таблице журнала Azure Monitor.
Метрики
В этом разделе перечислены все метрики платформы, автоматически собираемые для Центра Интернета вещей Azure. Пространство имен поставщика ресурсов для метрик Центра Интернета вещей — Microsoft.Devices. Пространство имен типов — IoTHubs.
В следующих подразделах показаны метрики платформы Центр Интернета вещей по общей категории и метрики списка по отображаемому имени, назначенному в портал Azure.
Вы также можете найти одну таблицу со списком всех метрик платформы Центр Интернета вещей по имени метрик в разделе Microsoft.Devices/IotHubs документации по Azure Monitor. В этой таблице представлены не все сведения, например поддерживаемые агрегаты для некоторых метрик, доступные в этой статье.
Дополнительные сведения о метриках, поддерживаемых другими службами Azure, см. в статье Метрики, поддерживаемые Azure Monitor.
Темы в этом разделе
Выберите раздел, чтобы перейти к сведениям о ней на этой странице.
- Поддерживаемые агрегирования
- Метрики команд (из облака на устройство)
- Метрики прямых методов (из облака на устройство)
- Метрики операций (из облака на двойник устройства)
- Метрики конфигурации
- Метрики суточной квоты
- Метрики устройств
- Метрики телеметрии устройств
- Метрики операций (с устройства на двойник устройства)
- Метрики Сетки событий
- Метрики заданий
- Метрики маршрутизации
- Метрики запросов к двойникам
Поддерживаемые агрегирования
Столбец Тип агрегирования в каждой таблице соответствует агрегированию по умолчанию, которое используется при выборе метрики для диаграммы или оповещения.
Для большинства метрик допустимы все типы агрегирования; Однако для метрик счетчика со значением столбца Unit(Число) допустимы только некоторые агрегаты. Есть два типа метрик количества:
Для метрик с одним числом точек Центр Интернета вещей регистрирует одну точку данных (по сути, 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 по типам ресурсов.
См. также:
- Описание мониторинга Центра Интернета вещей Azure см. в статье Мониторинг Центра Интернета вещей Azure.
- Подробные сведения о мониторинге ресурсов Azure см. в статье Мониторинг ресурсов Azure с помощью Azure Monitor.