Azure IoT 中心设备预配服务监视数据参考

本文包含此服务的所有监视参考信息。

有关可为 IoT 中心设备预配服务收集的数据以及如何使用这些数据的详细信息,请参阅监视 Azure IoT 中心设备预配服务

指标

本部分列出了为此服务自动收集的所有平台指标。 这些指标也是 Azure Monitor 中支持的所有平台指标的全局列表的一部分。

有关指标保留的信息,请参阅 Azure Monitor 指标概述

Microsoft.Devices/provisioningServices 支持的指标

下表列出了可用于 Microsoft.Devices/provisioningServices 资源类型的指标。

表标题

  • 指标 - 在 Azure 门户中显示的指标显示名称。
  • Rest API 中的名称 - 在 REST API 中引用的指标名称。
  • 单位 - 度量单位。
  • 聚合 - 默认的聚合类型。 有效值:平均值、最小值、最大值、总计、计数。
  • 维度 - 适用于指标的维度。
  • 时间粒度 - 对指标采样的间隔。 例如,PT1M 表示该指标每分钟采样一次,PT30M 表示每 30 分钟一次,PT1H 表示每小时一次,以此类推。
  • DS 导出 - 是否可通过诊断设置将指标导出到 Azure Monitor 日志。 要了解如何导出指标的信息,请参阅在 Azure Monitor 中创建诊断设置
指标 REST API 中的名称 Unit 聚合 维度 时间粒度 DS 导出
证明尝试次数

已尝试的设备证明次数
AttestationAttempts 计数 总计 ProvisioningServiceNameStatusProtocol PT1M
已分配设备

已分配给 IoT 中心的设备数
DeviceAssignments 计数 总计 ProvisioningServiceNameIotHubName PT1M
注册尝试次数

已尝试的设备注册次数
RegistrationAttempts 计数 总计 ProvisioningServiceNameIotHubNameStatus PT1M

指标维度

有关指标维度定义的信息,请参阅多维指标

此服务具有以下与其指标关联的维度。

维度名称 说明
IotHubName 目标 IoT 中心的名称。
协议 所使用的设备或服务协议。
ProvisioningServiceName DPS 实例的名称。
状态 操作的状态。

有关指标维度定义的详细信息,请参阅多维指标

资源日志

本部分列出了可为此服务收集的资源日志类型。 本部分拉取自 Azure Monitor 支持的所有资源日志类别类型列表。

Microsoft.Devices/provisioningServices 支持的资源日志

以下列表提供了有关上述日志的其他信息:

有关参考,请参阅 Azure Monitor 支持的所有资源日志类别类型列表。

DPS 使用 AzureDiagnostics 表存储资源日志信息。 以下列与此相关。

属性 数据类型 说明
ApplicationId GUID 持有者授权中使用的应用程序 ID。
CallerIpAddress 字符串 事件的掩码源 IP 地址。
Category String 操作类型 ServiceOperations 或 DeviceOperations。
CorrelationId GUID 事件的唯一标识符。
DurationMs 字符串 执行事件所用时间(以毫秒为单位)。
Level int 事件的日志记录严重性。 例如,信息或错误。
OperationName String 发生该事件期间执行的操作类型。 例如:Query、Get、Upsert 等。
OperationVersion 字符串 发生该事件期间使用的 API 版本。
资源 String 发生事件的资源的名称。 例如,MYEXAMPLEDPS
ResourceGroup String 资源所在的资源组的名称。
ResourceId String 发生事件的资源的 Azure 资源管理器资源 ID。
ResourceProvider 字符串 事件的资源提供程序。 例如,MICROSOFT.DEVICES
ResourceType String 事件的资源类型。 例如,PROVISIONINGSERVICES
ResultDescription 字符串 事件失败时的错误详细信息。
ResultSignature 字符串 事件失败时的 HTTP 状态代码。
ResultType 字符串 事件的结果:Success、Failure、ClientError 等。
SubscriptionId GUID 资源所在的 Azure 订阅的订阅 ID。
TenantId GUID 资源所在的 Azure 租户的租户 ID。
TimeGenerated DateTime 此事件发生的日期和时间,以 UTC 表示。
location_s String 发生该事件的 Azure 区域。
properties_s JSON 事件的其他详细信息。

DeviceOperations

以下 JSON 是设备的成功证明尝试示例。 设备的注册 ID 在 properties_s 属性中标识。

  {
    "CallerIPAddress": "24.18.226.XXX",
    "Category": "DeviceOperations",
    "CorrelationId": "68952383-80c0-436f-a2e3-f8ae9a41c69d",
    "DurationMs": "226",
    "Level": "Information",
    "OperationName": "AttestationAttempt",
    "OperationVersion": "March2019",
    "Resource": "MYEXAMPLEDPS",
    "ResourceGroup": "MYRESOURCEGROUP",
    "ResourceId": "/SUBSCRIPTIONS/747F1067-xxx-xxx-xxxx-9DEAA894152F/RESOURCEGROUPS/MYRESOURCEGROUP/PROVIDERS/MICROSOFT.DEVICES/PROVISIONINGSERVICES/MYEXAMPLEDPS",
    "ResourceProvider": "MICROSOFT.DEVICES",
    "ResourceType": "PROVISIONINGSERVICES",
    "ResultDescription": "",
    "ResultSignature": "",
    "ResultType": "Success",
    "SourceSystem": "Azure",
    "SubscriptionId": "747F1067-xxx-xxx-xxxx-9DEAA894152F",
    "TenantId": "37dcb621-xxxx-xxxx-xxxx-e8c8addbc4e5",
    "TimeGenerated": "2022-04-02T00:05:51Z",
    "Type": "AzureDiagnostics",
    "_ResourceId": "/subscriptions/747F1067-xxx-xxx-xxxx-9DEAA894152F/resourcegroups/myresourcegroup/providers/microsoft.devices/provisioningservices/myexampledps",
    "location_s": "chinaeast2",
    "properties_s": "{\"id\":\"my-device-1\",\"type\":\"Registration\",\"protocol\":\"Mqtt\"}",
  }

ServiceOperations

以下 JSON 是成功添加 (Upsert) 单个注册操作的示例。 注册的注册 ID 和注册类型在 properties_s 属性中标识。

  {
    "CallerIPAddress": "13.91.244.XXX",
    "Category": "ServiceOperations",
    "CorrelationId": "23bd419d-d294-452b-9b1b-520afef5ef52",
    "DurationMs": "98",
    "Level": "Information",
    "OperationName": "Upsert",
    "OperationVersion": "October2021",
    "Resource": "MYEXAMPLEDPS",
    "ResourceGroup": "MYRESOURCEGROUP",
    "ResourceId": "/SUBSCRIPTIONS/747F1067-xxxx-xxxx-xxxx-9DEAA894152F/RESOURCEGROUPS/MYRESOURCEGROUP/PROVIDERS/MICROSOFT.DEVICES/PROVISIONINGSERVICES/MYEXAMPLEDPS",
    "ResourceProvider": "MICROSOFT.DEVICES",
    "ResourceType": "PROVISIONINGSERVICES",
    "ResultDescription": "",
    "ResultSignature": "",
    "ResultType": "Success",
    "SourceSystem": "Azure",
    "SubscriptionId": "747f1067-xxxx-xxxx-xxxx-9deaa894152f",
    "TenantId": "37dcb621-xxxx-xxxx-xxxx-e8c8addbc4e5",
    "TimeGenerated": "2022-04-01T00:52:00Z",
    "Type": "AzureDiagnostics",
    "_ResourceId": "/subscriptions/747F1067-xxxx-xxxx-xxxx-9DEAA894152F/resourcegroups/myresourcegroup/providers/microsoft.devices/provisioningservices/myexampledps",
    "location_s": "chinaeast2",
    "properties_s": "{\"id\":\"my-device-1\",\"type\":\"IndividualEnrollment\",\"protocol\":\"Http\"}",
  }

Azure Monitor 日志表

本部分列出了与此服务相关的 Azure Monitor 日志表,日志分析可使用 Kusto 查询来查询这些表。 这些表包含资源日志数据,此外还可能包含其他数据,具体取决于所收集并路由到这些表的内容。

IoT 中心设备预配服务 Microsoft.Devices/ProvisioningServices

活动日志

链接表列出了可在此服务的活动日志中记录的操作。 这是活动日志中所有可能的资源提供程序操作的子集。

有关活动日志条目架构的详细信息,请参阅活动日志架构