监视 Azure IoT 中心数据参考

• 08/05/2021
• • r
  • D

请参阅监视 Azure IoT 中心，详细了解如何收集和分析 Azure IoT 中心的监视数据。

指标

本节列出了 Azure IoT 中心自动收集的所有平台指标。 IoT 中心指标的资源提供程序命名空间为 Microsoft.Devices，类型命名空间为 IoTHubs 。

以下小节按常规类别细分了 IoT 中心平台指标，并按它们在 Azure 门户中显示的名称列出它们。 还提供了与每个小节中显示的指标相关的信息。

你还可以在 Azure Monitor 文档中的 Microsoft.Devices/IotHubs 下找到一个按指标名称列出所有 IoT 中心平台指标的表。 请注意，此表并不提供本文中涵盖的一些信息，如一些指标支持的聚合。

若要了解其他 Azure 服务支持的指标，请参阅 Azure Monitor 支持的指标。

本节主题

• 监视 Azure IoT 中心数据参考
  • 度量值
    • 支持的聚合
    • 云到设备命令指标
    • 云到设备直接方法指标
    • 云到设备孪生操作指标
    • 配置指标
    • 每日配额指标
    • 设备指标
    • 设备遥测指标
    • 设备到云孪生操作指标
    • 事件网格指标
    • 作业指标
    • 路由指标
    • 孪生查询指标
  • 指标维度
  • 资源日志
    • 连接
    • 设备遥测
    • 云到设备的命令
    • 设备标识操作
    • 文件上传操作
    • Routes
    • 设备到云孪生操作
    • 云到设备孪生操作
    • 孪生查询
    • 作业操作
    • 直接方法
    • 分布式跟踪（预览版）
      • IoT 中心 D2C（设备到云）日志
      • IoT 中心流入日志
      • IoT 中心流出日志
    • 配置
    • 设备流（预览版）
  • Azure Monitor 日志表
  • 另请参阅

支持的聚合

每个表中的“聚合类型”列对应于为图表或警报选择指标时使用的默认聚合。

对于大多数指标，所有聚合类型都是有效的；但是，对于计数指标，即“计价单位”列值为“计数”的指标，只有一些聚合是有效的 。 计数指标可以是以下两种类型之一：

• 对于单点计数指标，IoT 中心每次执行测量操作时都会注册一个数据点（实质上为 1）。 然后 Azure Monitor 在指定的粒度上对这些数据点进行求和。 单点指标的示例有发送的遥测消息数和已完成的 C2D 消息传递次数 。 对于这些指标，唯一相关的聚合类型为总计（总和）。 通过门户可选择最小值、最大值和平均值；然而，这些值始终为 1。

• 对于快照计数指标，当进行测量操作时，IoT 中心将登记总计数。 当前，IoT 中心发布了三种快照指标：已使用的消息总数、设备总数（预览）和已连接设备数（预览） 。 因为这些指标在每次发出时都显示一个“总数”，所以在指定的粒度上对它们进行求和没有任何意义。 Azure Monitor 仅限为这些指标的聚合类型选择平均值、最小值和最大值。

云到设备命令指标

对于“计价单位”值为“计数”的指标，只有总计（总和）聚合有效 。 最小值、最大值和平均值聚合始终返回 1。 有关详细信息，请参阅支持的聚合。

云到设备直接方法指标

对于“计价单位”值为“计数”的指标，只有总计（总和）聚合有效 。 最小值、最大值和平均值聚合始终返回 1。 有关详细信息，请参阅支持的聚合。

云到设备孪生操作指标

对于“计价单位”值为“计数”的指标，只有总计（总和）聚合有效 。 最小值、最大值和平均值聚合始终返回 1。 有关详细信息，请参阅支持的聚合。

配置指标

对于“计价单位”值为“计数”的指标，只有总计（总和）聚合有效 。 最小值、最大值和平均值聚合始终返回 1。 有关详细信息，请参阅支持的聚合。

每日配额指标

对于“已使用的消息总数”，只支持最小值、最大值和平均值聚合。 有关详细信息，请参阅支持的聚合。

设备指标

对于设备总数（已弃用）和连接的设备数（已弃用），只有总计（总和）聚合有效 。 最小值、最大值和平均值聚合始终返回 1。 有关详细信息，请参阅支持的聚合。

对于设备总数（预览）和已连接设备数（预览），只有最小值、最大值和平均值聚合有效 。 有关详细信息，请参阅支持的聚合。

已连接设备数（预览）和设备总数（预览）不能通过诊断设置导出 。

设备遥测指标

对于“计价单位”值为“计数”的指标，只有总计（总和）聚合有效 。 最小值、最大值和平均值聚合始终返回 1。 有关详细信息，请参阅支持的聚合。

设备到云孪生操作指标

对于“计价单位”值为“计数”的指标，只有总计（总和）聚合有效 。 最小值、最大值和平均值聚合始终返回 1。 有关详细信息，请参阅支持的聚合。

事件网格指标

对于“计价单位”值为“计数”的指标，只有总计（总和）聚合有效 。 最小值、最大值和平均值聚合始终返回 1。 有关详细信息，请参阅支持的聚合。

作业指标

对于“计价单位”值为“计数”的指标，只有总计（总和）聚合有效 。 最小值、最大值和平均值聚合始终返回 1。 有关详细信息，请参阅支持的聚合。

路由指标

对于“计价单位”值为“计数”的指标，只有总计（总和）聚合有效 。 最小值、最大值和平均值聚合始终返回 1。 有关详细信息，请参阅支持的聚合。

孪生查询指标

对于“计价单位”值为“计数”的指标，只有总计（总和）聚合有效 。 最小值、最大值和平均值聚合始终返回 1。 有关详细信息，请参阅支持的聚合。

指标维度

Azure IoT 中心具有以下与它的一些路由和事件网格指标关联的维度。

若要了解有关指标维度的详细信息，请参阅多维指标。

资源日志

本节列出为 Azure IoT 中心收集的所有资源日志类别类型和架构。 所有 IoT 中心日志的资源提供程序和类型均为 Microsoft.Devices/IotHubs。

本节主题

• 监视 Azure IoT 中心数据参考
  • 度量值
    • 支持的聚合
    • 云到设备命令指标
    • 云到设备直接方法指标
    • 云到设备孪生操作指标
    • 配置指标
    • 每日配额指标
    • 设备指标
    • 设备遥测指标
    • 设备到云孪生操作指标
    • 事件网格指标
    • 作业指标
    • 路由指标
    • 孪生查询指标
  • 指标维度
  • 资源日志
    • 连接
    • 设备遥测
    • 云到设备的命令
    • 设备标识操作
    • 文件上传操作
    • Routes
    • 设备到云孪生操作
    • 云到设备孪生操作
    • 孪生查询
    • 作业操作
    • 直接方法
    • 分布式跟踪（预览版）
      • IoT 中心 D2C（设备到云）日志
      • IoT 中心流入日志
      • IoT 中心流出日志
    • 配置
    • 设备流（预览版）
  • Azure Monitor 日志表
  • 另请参阅

连接

连接类别跟踪设备连接，并断开事件与 IoT 中心和错误的连接。 此类别用于识别未经授权的连接尝试或者在失去与设备的连接时发出警报。

{
   "records":
   [
        {
            "time": " UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "deviceConnect",
            "category": "Connections",
            "level": "Information",
            "properties": "{\"deviceId\":\"<deviceId>\",\"sdkVersion\":\"<sdkVersion>\",\"protocol\":\"<protocol>\",\"authType\":\"{\\\"scope\\\":\\\"device\\\",\\\"type\\\":\\\"sas\\\",\\\"issuer\\\":\\\"iothub\\\",\\\"acceptingIpFilterRule\\\":null}\",\"maskedIpAddress\":\"<maskedIpAddress>\"}",
            "location": "Resource location"
        }
    ]
}

设备遥测

设备遥测类别跟踪在 IoT 中心发生的、与遥测管道相关的错误。 此类别包括发送遥测事件（例如限制）和接收遥测事件（例如未经授权的读取者）时发生的错误。 此类别无法捕捉设备本身运行的代码所造成的错误。

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "ingress",
            "category": "DeviceTelemetry",
            "level": "Error",
            "resultType": "Event status",
            "resultDescription": "MessageDescription",
            "properties": "{\"deviceId\":\"<deviceId>\",\"batching\":\"0\",\"messageSizeInBytes\":\"<messageSizeInBytes>\",\"EventProcessedUtcTime\":\"<UTC timestamp>\",\"EventEnqueuedUtcTime\":\"<UTC timestamp>\",\"partitionId\":\"1\"}", 
            "location": "Resource location"
        }
    ]
}

云到设备的命令

云到设备的命令类别跟踪在 IoT 中心发生且与云到设备的消息管道相关的错误。 此类别包括在以下情况下发生的错误：

• 发送云到设备消息时（例如“未经授权的发件人”错误），
• 接收云到设备消息时（例如“超出传递计数”错误），以及
• 接收云到设备消息反馈时（例如“反馈已过期”错误）。

此类别不捕捉当云到设备消息已成功传递但设备未正确进行处理时出现的错误。

{
    "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 中心发生且与文件上传功能相关的错误。 此类别包括：

• SAS URI 发生的错误，例如，它在设备向中心通知某个完成的上传前失效。

• 由设备报告的失败上传。

• 创建 IoT 中心通知消息期间在存储中找不到文件时发生的错误。

此类别不能捕获在设备将文件上传到存储时直接发生的错误。

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

路由

消息路由类别跟踪消息路由评估期间发生的错误以及 IoT 中心感知到的终结点运行状况。 此类别包括诸如下列项的事件：

• 规则评估结果为“未定义”，
• IoT 中心将某个终结点标记为死终结点，或者
• 从终结点收到的任何错误。

此类别不包含有关消息本身的特定错误（例如设备限制错误），这些错误在“设备遥测”类别下报告。

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

以下是有关路由资源日志的更多详细信息：

• 路由资源日志错误代码列表
• 路由资源日志操作名称列表

设备到云孪生操作

设备到云孪生操作类别跟踪设备孪生上设备发起的事件。 这些操作可能包括获取孪生、更新报告属性和订阅所需属性。

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

配置

IoT 中心配置日志跟踪有关自动设备管理功能集的事件和错误。

{
    "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 日志表

本节介绍与 Azure IoT 中心相关并可通过 Log Analytics 进行查询的所有 Azure Monitor 日志 Kusto 表。 有关这些表的列表以及指向 IoT 中心资源类型的详细信息的链接，请参阅 Azure Monitor 日志表参考中的 IoT 中心。

有关所有 Azure Monitor 日志/Log Analytics 表的参考，请参阅 Azure Monitor 日志表参考。

另请参阅

• 有关监视 Azure IoT 中心的说明，请参阅监视 Azure IoT 中心。
• 有关监视 Azure 资源的详细信息，请参阅使用 Azure Monitor 监视 Azure 资源。