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

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

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

Метрики

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

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

Поддерживаемые метрики для Microsoft. Устройства и IoTHubs

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Поддерживаемые журналы ресурсов для Microsoft. Устройства и 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"
        }
    ]
}

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

Центр Интернета вещей журналы 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"
        }
    ]
}

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

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

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

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

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

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

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

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

• Правило оценивается как "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. Устройства и IotHubs

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

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

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

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

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

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

• Описание Центр Интернета вещей мониторинга см. в разделе monitor Центр Интернета вещей Azure.
• Дополнительные сведения о мониторинге Azure ресурсов см. в Azure ресурсов Azure с помощью Azure Monitor.