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

Este artículo contiene toda la información de referencia de supervisión de este servicio.

Consulte Supervisión del servicio Azure IoT Hub Device Provisioning para más información sobre los datos que puede recopilar para IoT Hub Device Provisioning Service y cómo usarlo.

Métricas

En esta sección se indican todas las métricas de la plataforma recopiladas automáticamente para este servicio. Estas métricas también forman parte de la lista global de todas las métricas de plataforma admitidas en Azure Monitor.

Para obtener información sobre la retención de métricas, consulte Información general sobre las métricas de Azure Monitor.

Métricas admitidas para Microsoft.Devices/provisioningServices

En la tabla siguiente se enumeran las métricas disponibles para el tipo de recurso Microsoft.Devices/provisioningServices.

• Es posible que todas las columnas no estén presentes en todas las tablas.
• Es posible que algunas columnas estén fuera del área de visualización de la página. Seleccione Expandir tabla para ver todas las columnas disponibles.

Encabezados de tabla

• Categoría: el grupo de métricas o la clasificación.
• Métrica: el nombre para mostrar de la métrica tal como aparece en Azure Portal.
• Nombre en la API REST: el nombre de la métrica por el que se conoce en la API REST.
• Unidad: unidad de medida.
• Agregación: el tipo de agregación predeterminado. Valores válidos: promedio (Avg), mínimo (Min), máximo (Max), total (Sum), recuento.
• Dimensiones - : dimensiones disponibles para la métrica.
• Intervalos de agregación - : intervalos en los que se obtiene una muestra de la métrica. Por ejemplo, PT1M indica que la métrica se muestrea cada minuto, PT30M cada 30 minutos, PT1H cada hora, etc.
• Exportación de DS: indica si la métrica se puede exportar a los registros de Azure Monitor a través de la configuración de diagnóstico. Para obtener más información, consulte Creación de configuración de diagnóstico en Azure Monitor.

Métrica	Nombre en la API de REST	Unidad	Agregación	Dimensiones	Intervalos de agregación	Exportación de DS
Intentos de atestación Número de intentos de atestación de dispositivos	AttestationAttempts	Count	Total (Suma)	ProvisioningServiceName, , Status, Protocol	PT1M	Sí
Dispositivos asignados Número de dispositivos asignados a un IoT Hub	DeviceAssignments	Count	Total (Suma)	ProvisioningServiceName, IotHubName	PT1M	Sí
Intentos de registro Número de intentos de registro de dispositivos	RegistrationAttempts	Count	Total (Suma)	ProvisioningServiceName, , IotHubName, Status	PT1M	Sí

Dimensiones de métricas

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

Este servicio 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 este servicio. La sección extrae de la lista de todos los tipos de categorías de registros admitidos en Azure Monitor.

Registros de recursos admitidos para Microsoft.Devices/provisioningServices

Category	Nombre para mostrar de categoría	Tabla de registro	Admite el plan de registro básico	Admite la transformación en tiempo de ingesta	Consultas de ejemplo	Costos para exportar
DeviceOperations	Operaciones de dispositivo	AzureDiagnostics Registros de varios recursos de Azure.	No	No	Consultas	No
ServiceOperations	Operaciones del servicio	AzureDiagnostics Registros de varios recursos de Azure.	No	No	Consultas	No

En la lista siguiente se proporciona información adicional sobre los registros anteriores:

• DeviceOperations: registros relacionados con eventos de atestación de dispositivos. Consulte las API de dispositivo que aparecen en Operaciones y precios de servicios facturables.
• ServiceOperations: registros relacionados con los 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.
Categoría	Cadena	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	Cadena	Tipo de acción que se realiza durante el evento. Por ejemplo: Query, Get, Upsert, etc.
OperationVersion	Cadena	Versión de API usada durante el evento.
Resource	Cadena	Nombre del recurso donde tuvo lugar el evento. Por ejemplo, MYEXAMPLEDPS.
ResourceGroup	Cadena	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	Cadena	Proveedor de recursos para el evento. Por ejemplo, MICROSOFT.DEVICES.
ResourceType	Cadena	Tipo de recurso para el evento. Por ejemplo, PROVISIONINGSERVICES.
ResultDescription	Cadena	Detalles del error del evento si no se completa correctamente.
ResultSignature	Cadena	Código de estado HTTP del evento si no se completa correctamente.
ResultType	Cadena	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	Cadena	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": "aaaa0000-bb11-2222-33cc-444444dddddd",
    "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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "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": "aaaa0000-bb11-2222-33cc-444444dddddd",
    "DurationMs": "98",
    "Level": "Information",
    "OperationName": "Upsert",
    "OperationVersion": "October2021",
    "Resource": "MYEXAMPLEDPS",
    "ResourceGroup": "MYRESOURCEGROUP",
    "ResourceId": "/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/MYRESOURCEGROUP/PROVIDERS/MICROSOFT.DEVICES/PROVISIONINGSERVICES/MYEXAMPLEDPS",
    "ResourceProvider": "MICROSOFT.DEVICES",
    "ResourceType": "PROVISIONINGSERVICES",
    "ResultDescription": "",
    "ResultSignature": "",
    "ResultType": "Success",
    "SourceSystem": "Azure",
    "SubscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
    "TenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "TimeGenerated": "2022-04-01T00:52:00Z",
    "Type": "AzureDiagnostics",
    "_ResourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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 enumeran todas las tablas de registros de Azure Monitor relacionadas con este servicio y que están disponibles para consulta mediante Log Analytics con consultas de Kusto. Las tablas contienen datos de registro de recursos y, posiblemente, más dependiendo de lo que se recopila y se enrutan a ellos.

IoT Hub Device Provisioning Service Microsoft.Devices/ProvisioningServices

• AzureActivity
• AzureMetrics
• AzureDiagnostics

Registro de actividad

En la tabla vinculada se enumeran las operaciones que se pueden registrar en el registro de actividad de este servicio. Estas operaciones son un subconjunto de todas las posibles operaciones del proveedor de recursos en el registro de actividad.

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

• Operaciones del proveedor de recursos Microsoft.Devices

Contenido relacionado

• Consulte Supervisión del servicio Azure IoT Hub Device Provisioning para obtener una descripción de la supervisión del servicio IoT Hub Device Provisioning.
• Consulte Supervisión de los recursos de Azure con Azure Monitor para obtener información sobre la supervisión de los recursos de Azure.