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

В этой статье содержатся все справочные сведения о мониторинге для этой службы.

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

Метрики

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

Сведения о хранении метрик вы можете найти в разделе Обзор метрик Azure Monitor.

Поддерживаемые метрики для Microsoft.Devices/IoTHubs

В следующей таблице перечислены метрики, доступные для типа ресурса Microsoft.Devices/IoTHubs.

• Все столбцы могут не присутствовать в каждой таблице.
• Некоторые столбцы могут находиться за пределами области просмотра страницы. Выберите "Развернуть таблицу ", чтобы просмотреть все доступные столбцы.

Заголовки таблиц

• Категория — группа метрик или классификация.
• Metric - Название метрики, как оно отображается в портале Azure.
• Имя в REST API — имя метрики, указанное в REST API.
• Единица измерения.
• Аггрегация - Тип агрегации по умолчанию. Допустимые значения: среднее (среднее), минимальное (минимальное), максимальное (максимальное), общее (сумма), число.
• Измерения - Размеры, доступные для данной метрики.
• Интервалы интервалов - времени, по которым выборка метрики выполняется. Например, PT1M указывает, что метрика измеряется каждую минуту, PT30M — каждые 30 минут, PT1H — каждый час и так далее.
• Экспорт DS— можно ли экспортировать метрики в журналы Azure Monitor с помощью параметров диагностики. Сведения об экспорте метрик см. в статье "Создание параметров диагностики" в Azure Monitor.

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

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

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

• Для метрик подсчета по одной точке Центр Интернета вещей регистрирует одну точку данных (по сути, 1) каждый раз, когда выполняется измеряемая операция. Затем Azure Monitor суммирует эти точки данных с указанной степенью детализации. Примерами одноточечных метрик являются отправленные телеметрические сообщения и завершенные доставки сообщений C2D. Для этих метрик единственным релевантным типом агрегирования является Total (Sum). Портал позволяет выбрать минимальное, максимальное и среднее. Эти значения всегда равны 1.

• Для метрик счетчика моментальных снимков Центр Интернета вещей регистрирует общее количество при выполнении измеряемой операции. В настоящее время существует три метрики моментальных снимков , создаваемых Центром Интернета вещей: общее количество использованных сообщений, общее количество устройств и подключенные устройства. Поскольку эти метрики каждый раз представляют собой «общую» величину, суммировать их по указанной степени детализации не имеет смысла. Azure Monitor ограничивает выбор среднего, минимального и максимального значений для типа агрегирования для этих метрик.

Метрические размеры

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

Эта служба имеет следующие измерения, связанные с ее метриками.

Метрики, отображаемое имя и агрегирование

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

Метрики команд «облако на устройство»:

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

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

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

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

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

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

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

Метрики ежедневной квоты:

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

Метрики устройства:

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

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

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

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

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

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

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

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

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

Метрики вакансий:

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

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

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

Двойные метрики запроса:

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

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

В этом разделе перечислены типы журналов ресурсов, которые можно собирать для этой службы. Раздел извлекает из списка всех типов категорий журналов ресурсов, поддерживаемых в Azure Monitor.

Поддерживаемые журналы ресурсов для Microsoft.Devices/IotHubs

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

Категория команд «Облако на устройство»

Категория команд "облако — устройство" отслеживает ошибки, возникающие в Центре Интернета вещей, и связаны с конвейером сообщений из облака на устройство. Эта категория содержит ошибки, возникающие из:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

{
    "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": "send",
            "category": "DirectMethods",
            "level": "Information",
            "durationMs": "1",
            "properties": "{\"deviceId\":<messageSize>, \"RequestSize\": 1, \"ResponseSize\": 1, \"sdkVersion\": \"2017-07-11\"}",
            "location": "Resource location"
        }
    ]
}

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

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

Он correlationId соответствует предложению W3C Trace Context, где он содержит a trace-id и .span-id

Журналы IoT Hub 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 , чтобы зафиксировать пики задержки между устройством и облаком.

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

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

{
    "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 разделе этот журнал содержит дополнительную информацию о входящем сообщении.

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

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

{
    "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 разделе этот журнал содержит дополнительную информацию о входящем сообщении.

Категория операций загрузки файлов

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

• Ошибки, возникающие с 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": "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"
        }
    ]
}

Категория маршрутов

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

• Правило оценивается как "undefined"
• Центр Интернета вещей помечает конечную точку как мертвую
• Любые ошибки, полученные от конечной точки

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

{
    "records":
    [
        {
            "time":"2019-12-12T03:25:14Z",
            "resourceId":"/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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"
        }
    ]
}

Ниже приведены более подробные сведения о журналах ресурсов маршрутизации.

• Список кодов ошибок журнала ресурсов маршрутизации
• Список операций с логами ресурсов маршрутизацииNames

Категория двойных запросов

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

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

Таблицы журналов Azure Monitor

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

Центр Интернета вещей Microsoft.Devices/IotHubs

• AzureActivity
• AzureMetrics
• AzureDiagnostics
• IoTHubDistributedTracing
• ИнсайтсМетрикс

Журнал действий

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

Дополнительные сведения о схеме записей журнала действий см . в схеме журнала действий.

• Операции поставщика ресурсов Microsoft.Devices

Связанный контент

• Описание мониторинга IoT Hub см. в статье Мониторинг Azure IoT Hub .
• Дополнительные сведения о мониторинге ресурсов Azure см. в статье "Мониторинг ресурсов Azure" с помощью Azure Monitor .