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 |
计数 | 总计 | 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
活动日志
链接表列出了可在此服务的活动日志中记录的操作。 这是活动日志中所有可能的资源提供程序操作的子集。
有关活动日志条目架构的详细信息,请参阅活动日志架构。
相关内容
- 有关监视 IoT 中心设备预配服务的说明,请参阅监视 Azure IoT 中心设备预配服务。
- 请参阅使用 Azure Monitor 监视 Azure 资源,详细了解如何监视 Azure 资源。