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

项目
10/15/2024

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

有关可为 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`	计数	总计	`ProvisioningServiceName`，`Status`，`Protocol`	PT1M	是
已分配设备已分配给 IoT 中心的设备数	`DeviceAssignments`	计数	总计	`ProvisioningServiceName`，`IotHubName`	PT1M	是
注册尝试次数已尝试的设备注册次数	`RegistrationAttempts`	计数	总计	`ProvisioningServiceName`，`IotHubName`，`Status`	PT1M	是

指标维度

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

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

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

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

资源日志

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

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

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

DeviceOperations：与设备证明事件相关的日志。请参阅计费服务操作和定价中列出的设备 API。
ServiceOperations：与 DPS 服务事件相关的日志。请参阅计费服务操作和定价中列出的 DPS 服务 API。

有关参考，请参阅 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

AzureActivity
AzureMetrics
AzureDiagnostics

活动日志

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

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

Microsoft.Devices 资源提供程序操作

有关监视 IoT 中心设备预配服务的说明，请参阅监视 Azure IoT 中心设备预配服务。
请参阅使用 Azure Monitor 监视 Azure 资源，详细了解如何监视 Azure 资源。

通过