Referencia de datos de supervisión de Azure IoT Hub Device Provisioning Service

  • Artículo

Consulte Supervisión de IoT Hub Device Provisioning Service para obtener más información sobre la recopilación y el análisis de datos de supervisión para Azure IoT Hub Device Provisioning Service (DPS).

Métricas

En esta sección se indican todas las métricas de la plataforma recopiladas automáticamente para DPS.

Proveedor de recursos y tipo: Microsoft.Devices/provisioningServices.

Métrica ¿Se puede exportar con la configuración de diagnóstico? Nombre de métrica para mostrar Unidad Tipo de agregación Descripción Dimensions
AttestationAttempts Sí Intentos de atestación Count Total Número de intentos de atestación de dispositivos ProvisioningServiceName, Status, Protocol
DeviceAssignments Sí Dispositivos asignados Count Total Número de dispositivos asignados a un IoT Hub ProvisioningServiceName, IotHubName
RegistrationAttempts Sí Intentos de registro Count Total Número de intentos de registro de dispositivos ProvisioningServiceName, IotHubName, Status

Para obtener más información, vea una lista de todas las métricas de la plataforma que se admiten en Azure Monitor.

Dimensiones de métricas

DPS tiene las siguientes dimensiones asociadas a sus métricas.

Nombre de la dimensión Descripción
IotHubName Nombre del centro de IoT de destino.
Protocolo Protocolo del dispositivo o servicio usado.
ProvisioningServiceName Nombre de la instancia de DPS.
Estado Estado de la operación.

Para obtener más información sobre las dimensiones de métricas, consulte Métricas multidimensionales.

Registros del recurso

En esta sección se enumeran los tipos de registros de recursos que se pueden recopilar para DPS.

Proveedor de recursos y tipo: Microsoft.Devices/provisioningServices.

Category Descripción
DeviceOperations Registros relacionados con eventos de certificación de dispositivos. Consulte las API de dispositivo que aparecen en Operaciones y precios de servicios facturables.
ServiceOperations Registros relacionados con eventos del servicio DPS. Consulte las API del servicio DPS que aparecen en Operaciones y precios de servicios facturables.

Como referencia, vea una lista de todos los tipos de categorías de registros de recursos admitidos en Azure Monitor.

DPS usa la tabla AzureDiagnostics para almacenar información de los registros de recursos. Las columnas siguientes son importantes.

Propiedad Tipo de datos Descripción
ApplicationId GUID Identificador de aplicación usado en la autorización del portador.
CallerIpAddress String Dirección IP de origen enmascarada para el evento.
Category String Tipo de operación, ServiceOperations o DeviceOperations.
CorrelationId GUID Identificador único para el evento
DurationMs String Cuánto tiempo se tardó en realizar el evento en milisegundos.
Nivel Int Gravedad del registro del evento. Por ejemplo, Información o Error.
OperationName String Tipo de acción que se realiza durante el evento. Por ejemplo: Query, Get, Upsert, etc.
OperationVersion String Versión de API usada durante el evento.
Recurso String Nombre del recurso donde tuvo lugar el evento. Por ejemplo, "MYEXAMPLEDPS".
ResourceGroup String Nombre del grupo de recursos donde se encuentra el recurso.
ResourceId String Identificador del recurso de Azure Resource Manager para el recurso donde se produjo el evento.
ResourceProvider String Proveedor de recursos para el evento. Por ejemplo, "MICROSOFT.DEVICES".
ResourceType String Tipo de recurso para el evento. Por ejemplo, "PROVISIONINGSERVICES".
ResultDescription String Detalles del error del evento si no se completa correctamente.
ResultSignature String Código de estado HTTP del evento si no se completa correctamente.
ResultType String Resultado del evento: Success, Failure, ClientError, etc.
SubscriptionId GUID Identificador de suscripción de la suscripción de Azure donde se encuentra el recurso.
TenantId GUID Identificador de inquilino del inquilino de Azure donde se encuentra el recurso.
TimeGenerated DateTime Fecha y hora en que se produjo este evento, en formato UTC.
location_s String Región de Azure en la que tuvo lugar el evento.
properties_s JSON Información adicional sobre el evento.

DeviceOperations

El siguiente código JSON es un ejemplo de un intento de atestación correcto desde un dispositivo. El identificador de registro del dispositivo se identifica en la propiedad 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": "centralus",
    "properties_s": "{\"id\":\"my-device-1\",\"type\":\"Registration\",\"protocol\":\"Mqtt\"}",
  }

ServiceOperations

El siguiente código JSON es un ejemplo de una operación de inscripción individual de adición (Upsert) correcta. El identificador de registro de la inscripción y el tipo de inscripción se identifican en la propiedad 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": "centralus",
    "properties_s": "{\"id\":\"my-device-1\",\"type\":\"IndividualEnrollment\",\"protocol\":\"Http\"}",
  }

Tablas de registros de Azure Monitor

En esta sección se hace referencia a todas las tablas de Kusto de registros de Azure Monitor relacionadas con DPS y que están disponibles para consultar mediante Log Analytics. Puede encontrar una lista de estas tablas y vínculos a más información sobre el tipo de recurso de DPS en Device Provisioning Service en la referencia de tablas de registros de Azure Monitor.

Puede encontrar una referencia de todas las tablas de registros de Azure Monitor o de Log Analytics en Referencia de la tabla de registros de Azure Monitor.

Registro de actividades

Para más información sobre el esquema de las entradas del registro de actividad, consulte Esquema del registro de actividad.

Consulte también