Supervisión de la referencia a datos de Azure IoT Hub

Artículo
06/01/2023

Para empezar a trabajar con la supervisión de Azure, vea Supervisión de Azure IoT Hub a fin de comprender cómo recopilar y analizar datos de supervisión para Azure IoT Hub.

Este artículo es una referencia para implementar la supervisión de Azure.

Las secciones principales de este artículo de referencia son las siguientes:

Métricas: listas de métricas de la plataforma de IoT Hub por tema.
Dimensiones de métricas: dimensiones para el enrutamiento y las métricas de Event Grid.
Registros de recursos: registros por tipos de categoría y esquemas recopilados para Azure IoT Hub.
Tablas de registros de Azure Monitor: describe las tablas de Kusto de registros de Azure Monitor.

O bien vaya directamente a la Referencia de tabla de registros de Azure Monitor.

Métricas

En esta sección se enumeran todas las métricas de la plataforma recopiladas automáticamente para Azure IoT Hub. El espacio de nombres del proveedor de recursos de las métricas de IoT Hub es Microsoft.Devices y el espacio de nombres del tipo es IoTHubs.

En las subsecciones siguientes se muestran las métricas de la plataforma IoT Hub por categoría general y las enumera por su nombre para mostrar, tal como se asignan en Azure Portal.

Además, en la documentación de Azure Monitor, puede encontrar una sola tabla donde se muestran todas las métricas de la plataforma IoT Hub por el nombre de la métrica en Microsoft.Devices/IotHubs. En esta tabla no se proporciona toda la información, como las agregaciones admitidas en algunas métricas, disponible en este artículo.

Para información sobre las métricas admitidas por otros servicios de Azure, consulte Métricas compatibles con Azure Monitor.

Temas de esta sección

Seleccione un tema para ir a su información en esta página.

Agregaciones compatibles
Métricas de comandos de nube a dispositivo
Métricas de métodos directos de nube a dispositivo
Métricas de operaciones de nube a dispositivo gemelo
Métricas de configuraciones
Métricas de cuotas diarias
Métricas de dispositivos
Métricas de telemetría de dispositivos
Métricas de operaciones de dispositivo gemelo a nube
Métricas de Event Grid
Métricas de trabajos
Métricas de enrutamiento
Métricas de consultas de gemelos

Agregaciones compatibles

La columna Tipo de agregación de cada tabla corresponde a la agregación predeterminada que se usa cuando se selecciona la métrica de un gráfico o de una alerta.

Captura de pantalla que muestra la agregación de métricas

Con la mayoría de las métricas, todos los tipos de agregación son válidos; pero con las métricas de recuento con un valor en la columna Unidad de Recuento, solo algunas agregaciones son válidas. Las métricas de recuento pueden ser de dos tipos:

En las métricas de recuento de un solo punto, IoT Hub registra un solo punto de datos (básicamente, un 1) cada vez que se produce la operación medida. Luego, Azure Monitor suma estos puntos de datos a lo largo de la granularidad especificada. Ejemplos de métricas de un solo punto son Telemetry messages sent (Mensajes de telemetría enviados) y C2D message deliveries completed (Entregas de mensajes C2D completadas). En estas métricas, el único tipo de agregación de interés es Total (Suma). El portal le permite elegir los valores mínimo, máximo y promedio; sin embargo, estos valores siempre serán 1.
Métricas de recuento de instantáneas: IoT Hub registra un recuento total cuando se produce la operación medida. Actualmente, hay tres métricas de instantánea que emite IoT Hub: Número total de mensajes utilizados, Dispositivos totales y Dispositivos conectados. Dado que estas métricas presentan una cantidad "total" cada vez que se emiten, no tiene sentido sumarlas a lo largo de la granularidad especificada. Azure Monitor le limita a seleccionar los valores promedio, mínimo y máximo del tipo de agregación de estas métricas.

Métricas de comandos de nube a dispositivo

Nombre de métrica para mostrar	Métrica	Unidad	Tipo de agregación	Descripción	Dimensions
Mensajes de C2D expirados	C2DMessagesExpired	Count	Total	Número de mensajes de la nube al dispositivo expirados	None
C2D message deliveries completed (Entregas de mensajes de C2D completadas)	c2d.commands.egress.complete.success	Count	Total	Número de entregas de mensajes de la nube al dispositivo que el dispositivo ha completado correctamente.	None
C2D messages abandoned (Mensajes de C2D abandonados)	c2d.commands.egress.abandon.success	Count	Total	Número de mensajes de la nube al dispositivo que el dispositivo ha abandonado.	None
C2D messages rejected (Mensajes de C2D rechazados)	c2d.commands.egress.reject.success	Count	Total	Número de mensajes de la nube al dispositivo que el dispositivo ha rechazado.	None

En el caso de las métricas con un valor de Unidad de Recuento, solo la agregación total (suma) es válida. Las agregaciones mínimas, máximas y promedio siempre devuelven 1. Para más información, consulte las agregaciones admitidas.

Métricas de métodos directos de nube a dispositivo

Nombre de métrica para mostrar	Métrica	Unidad	Tipo de agregación	Descripción	Dimensions
Invocaciones al método directo con error	c2d.methods.failure	Count	Total	El número de todas las llamadas al método directo con error.	None
Tamaño de la solicitud de las invocaciones a métodos directos	c2d.methods.requestSize	Bytes	Average	El número de todas las solicitudes correctas del método directo.	None
Tamaño de la respuesta de las invocaciones a métodos directos	c2d.methods.responseSize	Bytes	Average	El número de todas las respuestas correctas del método directo.	None
Invocaciones correctas al método directo	c2d.methods.success	Count	Total	El número de todas las llamadas correctas al método directo.	None

Métricas de operaciones de nube a dispositivo gemelo

Nombre de métrica para mostrar	Métrica	Unidad	Tipo de agregación	Descripción	Dimensions
Lecturas gemelas con error del back-end	c2d.twin.read.failure	Count	Total	El recuento de todas las lecturas gemelas con error iniciadas por el back-end.	None
Actualizaciones gemelas con error del back-end	c2d.twin.update.failure	Count	Total	El recuento de todas las actualizaciones gemelas con error iniciadas por el back-end.	None
Tamaño de la respuesta de las lecturas gemelas del back-end	c2d.twin.read.size	Bytes	Average	El recuento de todas las lecturas gemelas correctas iniciadas por el back-end.	None
Tamaño de las actualizaciones gemelas del back-end	c2d.twin.update.size	Bytes	Average	El tamaño total de todas las actualizaciones gemelas correctas iniciadas por el back-end.	None
Lecturas gemelas correctas del back-end	c2d.twin.read.success	Count	Total	El recuento de todas las lecturas gemelas correctas iniciadas por el back-end.	None
Actualizaciones gemelas correctas del back-end	c2d.twin.update.success	Count	Total	El recuento de todas las actualizaciones gemelas correctas iniciadas por el back-end.	None

Métricas de configuraciones

Nombre de métrica para mostrar	Métrica	Unidad	Tipo de agregación	Descripción	Dimensions
Métricas de configuración	configuraciones	Count	Total	Número total de operaciones CRUD realizadas para la configuración de dispositivos y la implementación de IoT Edge en un conjunto de dispositivos de destino. Se incluye el número de operaciones que modifican el dispositivo gemelo o el módulo gemelo debido a estas configuraciones.	Ninguno

Métricas de cuotas diarias

Nombre de métrica para mostrar	Métrica	Unidad	Tipo de agregación	Descripción	Dimensions
Uso total de datos del dispositivo	deviceDataUsage	Bytes	Total	Bytes transferidos hacia y desde cualquier dispositivo conectado al Centro de IOT	None
Uso total de datos del dispositivo (versión preliminar)	deviceDataUsageV2	Bytes	Total	Bytes transferidos hacia y desde cualquier dispositivo conectado al Centro de IOT	None
Número total de mensajes usados	dailyMessageQuotaUsed	Count	Average	Número de mensajes totales usados hoy. Valor acumulado que se restablece en cero a las 00:00 UTC cada día.	None

En Total number of messages used (Número total de mensajes utilizados), solo se admiten agregaciones mínimas, máximas y promedio. Para más información, consulte las agregaciones admitidas.

Métricas de dispositivos

Nombre de métrica para mostrar	Métrica	Unidad	Tipo de agregación	Descripción	Dimensions
Total de dispositivos (en desuso)	devices.totalDevices	Count	Total	Número de dispositivos registrados en IoT Hub	None
Dispositivos conectados (en desuso)	devices.connectedDevices.allProtocol	Count	Total	Número de dispositivos conectados a IoT Hub	None
Número total de dispositivos	totalDeviceCount	Count	Average	Número de dispositivos registrados en IoT Hub	None
Dispositivos conectados	connectedDeviceCount	Count	Average	Número de dispositivos conectados a IoT Hub	None

En Total devices (deprecated) (Dispositivos totales [en desuso]) y Connected devices (deprecated) (Dispositivos conectados [en desuso]), solo la agregación total (suma) es válida. Las agregaciones mínimas, máximas y promedio siempre devuelven 1. Para más información, consulte las agregaciones admitidas.

En Dispositivos totales y Dispositivos conectados, solo las agregaciones mínimas, máximas y promedio son válidas. Para más información, consulte las agregaciones admitidas.

Dispositivos totales y Dispositivos conectados no se pueden exportar mediante la configuración de diagnóstico.

Métricas de telemetría de dispositivos

Nombre de métrica para mostrar	Métrica	Unidad	Tipo de agregación	Descripción	Dimensions
Número de errores de limitación	d2c.telemetry.ingress.sendThrottle	Count	Total	Número de errores de limitación debido a las limitaciones de rendimiento del dispositivo	None
Intentos de "envío de mensajes" de telemetría	d2c.telemetry.ingress.allProtocol	Count	Total	Número de mensajes de telemetría de dispositivo a la nube para enviar a IoT Hub	None
Mensajes de telemetría enviados	d2c.telemetry.ingress.success	Count	Total	Número de mensajes de telemetría de dispositivo a la nube enviados correctamente a IoT Hub	None

Métricas de operaciones de dispositivo gemelo a nube

Nombre de métrica para mostrar	Métrica	Unidad	Tipo de agregación	Descripción	Dimensions
Lecturas gemelas con error de los dispositivos	d2c.twin.read.failure	Count	Total	El recuento de todas las lecturas gemelas con error iniciadas por el dispositivo.	None
Actualizaciones gemelas con error de los dispositivos	d2c.twin.update.failure	Count	Total	El recuento de todas las actualizaciones gemelas con error iniciadas por el dispositivo.	None
Tamaño de la respuesta de las lecturas gemelas de dispositivos	d2c.twin.read.size	Bytes	Average	El número de todas las lecturas gemelas correctas iniciadas por el dispositivo.	None
Tamaño de las actualizaciones gemelas de los dispositivos	d2c.twin.update.size	Bytes	Average	El tamaño total de todas las actualizaciones gemelas correctas iniciadas por el dispositivo.	None
Lecturas gemelas correctas de los dispositivos	d2c.twin.read.success	Count	Total	El recuento de todas las lecturas gemelas correctas iniciadas por el dispositivo.	None
Actualizaciones gemelas correctas de los dispositivos	d2c.twin.update.success	Count	Total	El recuento de todas las actualizaciones gemelas correctas iniciadas por el dispositivo.	None

Métricas de Event Grid

Nombre de métrica para mostrar	Métrica	Unidad	Tipo de agregación	Descripción	Dimensions
Entregas de Event Grid	EventGridDeliveries	Count	Total	El número de eventos de IoT Hub publicados en Event Grid. Use la dimensión de resultado para ver el número de solicitudes correctas e incorrectas. La dimensión EventType muestra el tipo de evento (https://aka.ms/ioteventgrid).	Result, EventType Para más información, consulte Dimensiones de métricas .
Latencia de Event Grid	EventGridLatency	Milisegundos	Average	La latencia media (milisegundos) desde el momento en que se generó el evento de IoT Hub hasta el momento en que se publicó el evento en Event Grid. Este número es un promedio entre todos los tipos de evento. Use la dimensión EventType para ver la latencia de un tipo específico de evento.	EventType Para más información, consulte Dimensiones de métricas .

Métricas de trabajos

Nombre de métrica para mostrar	Métrica	Unidad	Tipo de agregación	Descripción	Dimensions
Trabajos completados	jobs.completed	Count	Total	El recuento de todos los trabajos completados.	None
Llamadas con error para enumerar trabajos	jobs.listJobs.failure	Count	Total	El recuento de todas las llamadas con error para enumerar trabajos.	None
Creaciones con error de trabajos de invocación de método	jobs.createDirectMethodJob.failure	Count	Total	El recuento de todas las creaciones con error de los trabajos de invocación de método directos.	None
Creaciones con error de trabajos de actualización gemelos	jobs.createTwinUpdateJob.failure	Count	Total	El recuento de todas las creaciones con error de trabajos de actualización gemelos.	None
Cancelaciones de trabajos con error	jobs.cancelJob.failure	Count	Total	El recuento de todas las llamadas con error para cancelar un trabajo.	None
Consultas de trabajo con error	jobs.queryJobs.failure	Count	Total	El recuento de todas las llamadas con error para consultar trabajos.	None
Trabajos con error	jobs.failed	Count	Total	El recuento de todos los trabajos con error.	None
Llamadas correctas para enumerar trabajos	jobs.listJobs.success	Count	Total	El recuento de todas las llamadas correctas para enumerar trabajos.	None
Creaciones correctas de trabajos de invocación de método	jobs.createDirectMethodJob.success	Count	Total	El recuento de todas las creaciones correctas de los trabajos de invocación de método directos.	None
Creaciones correctas de trabajos de actualización gemelos	jobs.createTwinUpdateJob. success	Count	Total	El recuento de todas las creaciones correctas de trabajos de actualización gemelos.	None
Cancelaciones de trabajos correctas	jobs.cancelJob.success	Count	Total	El recuento de todas las llamadas correctas para cancelar un trabajo.	None
Consultas de trabajo correctas	jobs.queryJobs.success	Count	Total	El recuento de todas las llamadas correctas para consultar trabajos.	None

Métricas de enrutamiento

Nombre de métrica para mostrar	Métrica	Unidad	Tipo de agregación	Descripción	Dimensions
Entregas de enrutamiento (versión preliminar)	RoutingDeliveries	Count	Total	Métrica de entrega de enrutamiento. Use las dimensiones para identificar el estado de entrega para un punto de conexión específico o para un origen de enrutamiento específico.	Result, RoutingSource, EndpointType, FailureReasonCategory, EndpointName Para más información, consulte Dimensiones de métricas .
Tamaño del enrutamiento de los mensajes entregados en bytes (versión preliminar)	RoutingDataSizeInBytesDelivered	Bytes	Total	Número total de bytes que IoT Hub enruta al punto de conexión personalizado y al punto de conexión integrado. Use las dimensiones para identificar el tamaño de los datos enrutados a un punto de conexión específico o para un origen de enrutamiento específico.	RoutingSource, EndpointType EndpointName Para más información, consulte Dimensiones de métricas .
Latencia de entrega de enrutamiento (versión preliminar)	RoutingDeliveryLatency	Milisegundos	Average	Métrica de latencia de entrega de enrutamiento. Use las dimensiones para identificar la latencia para un punto de conexión específico o para un origen de enrutamiento específico.	RoutingSource, EndpointType, EndpointName Para más información, consulte Dimensiones de métricas .
Enrutamiento: blobs entregados al almacenamiento	d2c.endpoints.egress.storage.blobs	Count	Total	Número de veces que el enrutamiento de IoT Hub ha entregado blobs a los puntos de conexión de almacenamiento.	None
Enrutamiento: datos entregados al almacenamiento	d2c.endpoints.egress.storage.bytes	Bytes	Total	Cantidad de datos (bytes) que el enrutamiento de IoT Hub ha entregado a los punto de conexión de almacenamiento.	None
Enrutamiento: latencia de mensajes para Event Hubs	d2c.endpoints.latency.eventHubs	Milisegundos	Average	Latencia media (milisegundos) entre la entrada de mensajes a IoT Hub y la entrada de mensajes a puntos de conexión personalizados de tipo Event Hubs. No se incluyen las rutas de mensajes a un punto de conexión integrado (eventos).	None
Enrutamiento: latencia de mensajes de la cola de Service Bus	d2c.endpoints.latency.serviceBusQueues	Milisegundos	Average	Latencia media (milisegundos) entre la entrada de mensajes a IoT Hub y la entrada de mensajes a un punto de conexión de la cola de Service Bus.	None
Enrutamiento: latencia de mensajes del tema de Service Bus	d2c.endpoints.latency.serviceBusTopics	Milisegundos	Average	Latencia media (milisegundos) entre la entrada de mensajes a IoT Hub y la entrada de mensajes a un punto de conexión del tema de Service Bus.	None
Enrutamiento: latencia de mensajes para mensajes/eventos	d2c.endpoints.latency.builtIn.events	Milisegundos	Average	Latencia media (milisegundos) entre la entrada de mensajes a IoT Hub y la entrada de mensajes al punto de conexión integrado (mensajes/eventos) y a la ruta de reserva.	None
Enrutamiento: latencia de mensajes para almacenamiento	d2c.endpoints.latency.storage	Milisegundos	Average	Latencia media (milisegundos) entre la entrada de mensajes a IoT Hub y la entrada de mensajes a un punto de conexión de almacenamiento.	None
Enrutamiento: mensajes entregados a Event Hubs	d2c.endpoints.egress.eventHubs	Count	Total	Número de veces que el enrutamiento de IoT Hub ha entregado mensajes correctamente a puntos de conexión personalizados de tipo Event Hubs. No se incluyen las rutas de mensajes a un punto de conexión integrado (eventos).	None
Enrutamiento: mensajes entregados a la cola de Service Bus	d2c.endpoints.egress.serviceBusQueues	Count	Total	Número de veces que el enrutamiento de IoT Hub ha entregado mensajes correctamente a los puntos de conexión de la cola de Service Bus.	None
Enrutamiento: mensajes entregados al tema de Service Bus	d2c.endpoints.egress.serviceBusTopics	Count	Total	Número de veces que el enrutamiento de IoT Hub ha entregado mensajes correctamente a los puntos de conexión del tema de Service Bus.	None
Enrutamiento: mensajes entregados a la reserva	d2c.telemetry.egress.fallback	Count	Total	Número de veces que el enrutamiento de IoT Hub ha entregado mensajes al punto de conexión asociado con la ruta de reserva.	None
Enrutamiento: mensajes entregados a mensajes/eventos	d2c.endpoints.egress.builtIn.events	Count	Total	Número de veces que el enrutamiento de IoT Hub ha entregado mensajes correctamente al punto de conexión integrado (mensajes/eventos) y a la ruta de reserva.	None
Enrutamiento: mensajes entregados al almacenamiento	d2c.endpoints.egress.storage	Count	Total	Número de veces que el enrutamiento de IoT Hub ha entregado mensajes correctamente a los puntos de conexión de almacenamiento.	None
Enrutamiento: mensajes de telemetría entregados	d2c.telemetry.egress.success	Count	Total	Número de veces que los mensajes se han entregado correctamente a todos los puntos de conexión mediante el enrutamiento de IoT Hub. Si un mensaje se enruta a varios puntos de conexión, este valor aumenta en uno por cada entrega correcta. Si un mensaje se enruta al mismo punto de conexión varias veces, este valor aumenta en uno por cada entrega correcta.	None
Enrutamiento: mensajes de telemetría quitados	d2c.telemetry.egress.dropped	Count	Total	Número de veces que se han quitado los mensajes con el enrutamiento de IoT Hub a causa de puntos de conexión inactivos. Este valor no cuenta los mensajes entregados a la ruta de reserva porque los mensajes quitados no se entregan allí.	None
Enrutamiento: mensajes de telemetría incompatibles	d2c.telemetry.egress.invalid	Count	Total	Número de veces que el enrutamiento de IoT Hub no ha podido entregar mensajes debido a una incompatibilidad con el punto de conexión. Un mensaje es incompatible con un punto de conexión cuando IoT Hub intenta entregar el mensaje a un punto de conexión y se produce un error no transitorio. No se reintentan los mensajes no válidos. Este valor no incluye los reintentos.	None
Enrutamiento: mensajes de telemetría huérfanos	d2c.telemetry.egress.orphaned	Count	Total	Número de veces que los mensajes eran huérfanos a causa del enrutamiento de IoT Hub porque no coincidían con ninguna consulta de enrutamiento, cuando la ruta de reserva está deshabilitada.	None

Métricas de consultas de gemelos

Nombre de métrica para mostrar	Métrica	Unidad	Tipo de agregación	Descripción	Dimensions
Consultas gemelas con error	twinQueries.failure	Count	Total	El recuento de todas las consultas gemelas con error.	None
Consultas gemelas correctas	twinQueries.success	Count	Total	El recuento de todas las consultas gemelas correctas.	None
Tamaño de resultado de consultas gemelas	twinQueries.resultSize	Bytes	Average	El total del tamaño del resultado de todas las consultas gemelas correctas.	None

Dimensiones de métricas

Azure IoT Hub tiene las siguientes dimensiones asociadas a algunas de sus métricas de enrutamiento y métricas de Event Grid.

Nombre de dimensión	Descripción

EndpointName	Nombre del punto de conexión.
EndpointType	eventHubs, serviceBusQueues, cosmosDB, serviceBusTopics. builtin o blobStorage.
EventType	Microsoft.Devices.DeviceCreated. Microsoft.Devices.DeviceDeleted, Microsoft.Devices.DeviceConnected, Microsoft.Devices.DeviceDisconnected o Microsoft.Devices.DeviceTelemetry. Para más información, consulte Tipos de eventos.
FailureReasonCategory	Una de los siguientes: invalid, dropped, orphaned o null.
Resultado	success o failure.
RoutingSource	Mensajes del dispositivo Eventos de cambio de gemelo Eventos de ciclo de vida del dispositivo

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

Registros del recurso

En esta sección se enumeran todos los tipos y esquemas de categorías de registros de recursos recopilados para Azure IoT Hub. El proveedor de recursos y el tipo de todos los registros de IoT Hub es Microsoft.Devices/IotHubs. Los eventos solo se emiten para los errores de algunas de las categorías.

Temas de esta sección

Conexiones
Telemetría del dispositivo
Comandos de nube a dispositivo
Operaciones de identidad de dispositivos
Operaciones de carga de archivos
Rutas
Operaciones gemelas del dispositivo a la nube
Operaciones gemelas de la nube al dispositivo
Consultas gemelas
Operaciones de trabajos
Métodos directos
Seguimiento distribuido (versión preliminar)
Configuraciones
Flujos de dispositivos (versión preliminar)

Conexiones

La categoría de conexiones realiza un seguimiento de los eventos de conexión y desconexión del dispositivo de un centro de IoT y de los errores. Esta categoría es útil para identificar intentos de conexión no autorizados o alertas cuando se pierde la conexión a dispositivos.

Para conocer el estado de conexión confiable de los dispositivos, consulte Supervisión del estado de conexión del dispositivo.

{
   "records":
   [
        {
            "time": " UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "deviceConnect",
            "category": "Connections",
            "level": "Information",
            "properties": "{\"deviceId\":\"<deviceId>\",\"sdkVersion\":\"<sdkVersion>\",\"protocol\":\"<protocol>\",\"authType\":\"{\\\"scope\\\":\\\"device\\\",\\\"type\\\":\\\"sas\\\",\\\"issuer\\\":\\\"iothub\\\",\\\"acceptingIpFilterRule\\\":null}\",\"maskedIpAddress\":\"<maskedIpAddress>\"}",
            "location": "Resource location"
        }
    ]
}

Para más información sobre el uso de registros de conexiones para supervisar la conectividad de dispositivos, consulte Supervisión, diagnóstico y solución de problemas de conectividad de dispositivos a Azure IoT Hub.

Telemetría de dispositivo

La categoría de telemetría del dispositivo realiza el seguimiento de los errores que se producen en el centro de IoT y se relacionan con la canalización de telemetría. Esta categoría incluye los errores que se producen al enviar eventos de telemetría (por ejemplo, la limitación) y recibir eventos de telemetría (por ejemplo, un lector no autorizado). Esta categoría no puede detectar los errores que provoca el código que se ejecuta en el propio dispositivo.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "ingress",
            "category": "DeviceTelemetry",
            "level": "Error",
            "resultType": "Event status",
            "resultDescription": "MessageDescription",
            "properties": "{\"deviceId\":\"<deviceId>\",\"batching\":\"0\",\"messageSizeInBytes\":\"<messageSizeInBytes>\",\"EventProcessedUtcTime\":\"<UTC timestamp>\",\"EventEnqueuedUtcTime\":\"<UTC timestamp>\",\"partitionId\":\"1\"}", 
            "location": "Resource location"
        }
    ]
}

Comandos de nube a dispositivo

La categoría de comandos de nube a dispositivo realiza el seguimiento de los errores que se producen en el centro de IoT y se relacionan con la canalización de mensajes de nube a dispositivo. Esta categoría incluye errores que se producen a partir de:

Envío de mensajes de la nube al dispositivo (como errores de remitente no autorizados),
Recepción de mensajes de la nube al dispositivo (por ejemplo, errores al superarse el recuento de entregas) y
Recepción de comentarios de mensajes de la nube al dispositivo (como errores por comentarios expirados).

Esta categoría no detecta errores cuando el mensaje de la nube al dispositivo se entrega correctamente, pero el dispositivo lo controla incorrectamente.

{
    "records":
    [
        {
            "time": " UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "messageExpired",
            "category": "C2DCommands",
            "level": "Error",
            "resultType": "Event status",
            "resultDescription": "MessageDescription",
            "properties": "{\"deviceId\":\"<deviceId>\",\"messageId\":\"<messageId>\",\"messageSizeInBytes\":\"<messageSize>\",\"protocol\":\"Amqp\",\"deliveryAcknowledgement\":\"<None, NegativeOnly, PositiveOnly, Full>\",\"deliveryCount\":\"0\",\"expiryTime\":\"<timestamp>\",\"timeInSystem\":\"<timeInSystem>\",\"ttl\":<ttl>, \"EventProcessedUtcTime\":\"<UTC timestamp>\",\"EventEnqueuedUtcTime\":\"<UTC timestamp>\", \"maskedIpAddress\": \"<maskedIpAddress>\", \"statusCode\": \"4XX\"}",
            "location": "Resource location"
        }
    ]
}

Operaciones de identidad de dispositivos

La categoría de operaciones de identidad de dispositivo supervisa los errores que se producen cuando se intenta crear, actualizar o eliminar una entrada en el registro de identidades de IoT Hub. El seguimiento de esta categoría resulta útil para los escenarios de aprovisionamiento.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "get",
            "category": "DeviceIdentityOperations",
            "level": "Error",
            "resultType": "Event status",
            "resultDescription": "MessageDescription",
            "properties": "{\"maskedIpAddress\":\"<maskedIpAddress>\",\"deviceId\":\"<deviceId>\", \"statusCode\":\"4XX\"}",
            "location": "Resource location"
        }
    ]
}

Operaciones de carga de archivos

La categoría de carga de archivos supervisa los errores que se producen en el centro de IoT y está relacionada con la funcionalidad de carga de archivos. Esta categoría incluye lo siguiente:

Errores que se producen con el URI de SAS, como cuando caduca antes de que un dispositivo notifique al centro una carga completada.
Cargas con errores notificadas por el dispositivo.
Errores que se producen cuando no se encuentra un archivo en el almacenamiento durante la creación del mensaje de notificación de IoT Hub.

Esta categoría no puede detectar los errores que se producen directamente mientras el dispositivo está cargando un archivo a Storage.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "ingress",
            "category": "FileUploadOperations",
            "level": "Error",
            "resultType": "Event status",
            "resultDescription": "MessageDescription",
            "durationMs": "1",
            "properties": "{\"deviceId\":\"<deviceId>\",\"protocol\":\"<protocol>\",\"authType\":\"{\\\"scope\\\":\\\"device\\\",\\\"type\\\":\\\"sas\\\",\\\"issuer\\\":\\\"iothub\\\",\\\"acceptingIpFilterRule\\\":null}\",\"blobUri\":\"http//bloburi.com\"}",
            "location": "Resource location"
        }
    ]
}

Rutas

La categoría de enrutamiento de mensajes realiza un seguimiento de los errores que se producen durante la evaluación de este proceso y el estado del punto de conexión según lo que observa IoT Hub. Esta categoría incluye eventos tales como:

Una regla se evalúa como "sin definir",
IoT Hub marca un punto de conexión como fallido, o
Cualquier error recibido desde un punto de conexión.

Esta categoría no incluye errores específicos de los mensajes (como los errores de limitación del dispositivo), que se notifican en la categoría "telemetría de dispositivo".

{
    "records":
    [
        {
            "time":"2019-12-12T03:25:14Z",
            "resourceId":"/SUBSCRIPTIONS/91R34780-3DEC-123A-BE2A-213B5500DFF0/RESOURCEGROUPS/ANON-TEST/PROVIDERS/MICROSOFT.DEVICES/IOTHUBS/ANONHUB1",
            "operationName":"endpointUnhealthy",
            "category":"Routes",
            "level":"Error",
            "resultType":"403004",
            "resultDescription":"DeviceMaximumQueueDepthExceeded",
            "properties":"{\"deviceId\":null,\"endpointName\":\"anon-sb-1\",\"messageId\":null,\"details\":\"DeviceMaximumQueueDepthExceeded\",\"routeName\":null,\"statusCode\":\"403\"}",
            "location":"westus"
        }
    ]
}

Aquí encontrará más detalles sobre el enrutamiento de registros de recursos:

Operaciones gemelas del dispositivo a la nube

La categoría de operaciones gemelas del dispositivo a la nube supervisa los eventos iniciados por el dispositivo en dispositivos gemelos. Estas operaciones pueden incluir la opción de obtener gemelo, actualizar las propiedades notificadas y suscribirse a las propiedades deseadas.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "update",
            "category": "D2CTwinOperations",
            "level": "Information",
            "durationMs": "1",
            "properties": "{\"deviceId\":\"<deviceId>\",\"protocol\":\"<protocol>\",\"authenticationType\":\"{\\\"scope\\\":\\\"device\\\",\\\"type\\\":\\\"sas\\\",\\\"issuer\\\":\\\"iothub\\\",\\\"acceptingIpFilterRule\\\":null}\"}",
            "location": "Resource location"
        }
    ]
}

Operaciones gemelas de la nube al dispositivo

La categoría de operaciones gemelas de la nube al dispositivo supervisa los eventos iniciados por el servicio en dispositivos gemelos. Estas operaciones pueden incluir la opción de obtener operaciones gemelas y actualizar o reemplazar etiquetas y propiedades.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "read",
            "category": "C2DTwinOperations",
            "level": "Information",
            "durationMs": "1",
            "properties": "{\"deviceId\":\"<deviceId>\",\"sdkVersion\":\"<sdkVersion>\",\"messageSize\":\"<messageSize>\"}",
            "location": "Resource location"
        }
    ]
}

Consultas gemelas

La categoría de consultas gemelas informa sobre las solicitudes de consulta de los dispositivos gemelos que se inician en la nube.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "query",
            "category": "TwinQueries",
            "level": "Information",
            "durationMs": "1",
            "properties": "{\"query\":\"<twin query>\",\"sdkVersion\":\"<sdkVersion>\",\"messageSize\":\"<messageSize>\",\"pageSize\":\"<pageSize>\", \"continuation\":\"<true, false>\", \"resultSize\":\"<resultSize>\"}",
            "location": "Resource location"
        }
    ]
}

Operaciones de trabajos

La categoría de operaciones de trabajos informa sobre las solicitudes de trabajo para actualizar los dispositivos gemelos o invocar métodos directos en varios dispositivos. Estas solicitudes se inician en la nube.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "jobCompleted",
            "category": "JobsOperations",
            "level": "Information",
            "durationMs": "1",
            "properties": "{\"jobId\":\"<jobId>\", \"sdkVersion\": \"<sdkVersion>\",\"messageSize\": <messageSize>,\"filter\":\"DeviceId IN ['1414ded9-b445-414d-89b9-e48e8c6285d5']\",\"startTimeUtc\":\"Wednesday, September 13, 2017\",\"duration\":\"0\"}",
            "location": "Resource location"
        }
    ]
}

Métodos directos

La categoría de métodos directos realiza un seguimiento de las interacciones de solicitud y respuesta enviadas a dispositivos individuales. Estas solicitudes se inician en la nube.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "send",
            "category": "DirectMethods",
            "level": "Information",
            "durationMs": "1",
            "properties": "{\"deviceId\":<messageSize>, \"RequestSize\": 1, \"ResponseSize\": 1, \"sdkVersion\": \"2017-07-11\"}",
            "location": "Resource location"
        }
    ]
}

Seguimiento distribuido (versión preliminar)

La categoría de seguimiento distribuido realiza un seguimiento de los identificadores de correlación correspondientes a los mensajes que contienen el encabezado de contexto de seguimiento. Para habilitar completamente estos registros, se debe actualizar el código del lado cliente mediante los pasos que se indican en Análisis y diagnóstico de aplicaciones de IoT de un extremo a otro con el seguimiento distribuido de IoT Hub [versión preliminar].

El elemento correlationId se ajusta a la propuesta de contexto de seguimiento de W3C, donde contiene un elemento trace-id y otro span-id.

Registros D2C (dispositivo a nube) de IoT Hub

IoT Hub anota este registro cuando le llega un mensaje que contiene propiedades de seguimiento válidas.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "DiagnosticIoTHubD2C",
            "category": "DistributedTracing",
            "correlationId": "00-8cd869a412459a25f5b4f31311223344-0144d2590aacd909-01",
            "level": "Information",
            "resultType": "Success",
            "resultDescription":"Receive message success",
            "durationMs": "",
            "properties": "{\"messageSize\": 1, \"deviceId\":\"<deviceId>\", \"callerLocalTimeUtc\": : \"2017-02-22T03:27:28.633Z\", \"calleeLocalTimeUtc\": \"2017-02-22T03:27:28.687Z\"}",
            "location": "Resource location"
        }
    ]
}

En este caso, no se calcula durationMs dado que es posible que el reloj de IoT Hub no esté sincronizado con el reloj del dispositivo y, por tanto, el cálculo de la duración puede ser engañoso. Se recomienda escribir la lógica mediante las marcas de tiempo de la sección properties para capturar los picos en la latencia de dispositivo a nube.

Propiedad	Tipo	Descripción
messageSize	Entero	Tamaño del mensaje de dispositivo a nube en bytes.
deviceId	Cadena de caracteres alfanuméricos ASCII de 7 bits.	Identidad del dispositivo
callerLocalTimeUtc	Marca de tiempo UTC	Hora de creación del mensaje según el reloj local del dispositivo.
calleeLocalTimeUtc	Marca de tiempo UTC	Hora de llegada del mensaje a la puerta de enlace de IoT Hub según el reloj del lado de servicio de IoT Hub.

Registros de entrada de IoT Hub

IoT Hub anota este registro cuando un mensaje que contiene propiedades de seguimiento válidas se escribe en una instancia de Event Hubs interna o integrada.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "DiagnosticIoTHubIngress",
            "category": "DistributedTracing",
            "correlationId": "00-8cd869a412459a25f5b4f31311223344-349810a9bbd28730-01",
            "level": "Information",
            "resultType": "Success",
            "resultDescription":"Ingress message success",
            "durationMs": "10",
            "properties": "{\"isRoutingEnabled\": \"true\", \"parentSpanId\":\"0144d2590aacd909\"}",
            "location": "Resource location"
        }
    ]
}

En la sección properties, este registro contiene información adicional sobre la entrada de mensajes.

Propiedad	Tipo	Descripción
isRoutingEnabled	String	Verdadero o falso, indica si está habilitado el enrutamiento de mensajes en IoT Hub.
parentSpanId	String	El valor de span-id del mensaje principal, que, en este caso, sería el seguimiento de mensajes D2C.

Registros de salida de IoT Hub

IoT Hub anota este registro cuando está habilitado el enrutamiento y el mensaje se escribe en un punto de conexión. Si no está habilitado el enrutamiento, IoT Hub no anota este registro.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "DiagnosticIoTHubEgress",
            "category": "DistributedTracing",
            "correlationId": "00-8cd869a412459a25f5b4f31311223344-98ac3578922acd26-01",
            "level": "Information",
            "resultType": "Success",
            "resultDescription":"Egress message success",
            "durationMs": "10",
            "properties": "{\"endpointType\": \"EventHub\", \"endpointName\": \"myEventHub\", \"parentSpanId\":\"349810a9bbd28730\"}",
            "location": "Resource location"
        }
    ]
}

En la sección properties, este registro contiene información adicional sobre la entrada de mensajes.

Propiedad	Tipo	Descripción
endpointName	String	Nombre del punto de conexión de enrutamiento.
endpointType	String	Tipo del punto de conexión de enrutamiento.
parentSpanId	String	El valor de span-id del mensaje principal, que, en este caso, sería el seguimiento de mensajes de entrada de IoT Hub.

Configurations

Los registros de configuración de IoT Hub realizan el seguimiento de los eventos y errores del conjunto de características de administración automática de dispositivos.

{
    "records":
    [
         {
             "time": "2019-09-24T17:21:52Z",
             "resourceId": "Resource Id",
             "operationName": "ReadManyConfigurations",
             "category": "Configurations",
             "resultType": "",
             "resultDescription": "",
             "level": "Information",
             "durationMs": "17",
             "properties": "{\"configurationId\":\"\",\"sdkVersion\":\"2018-06-30\",\"messageSize\":\"0\",\"statusCode\":null}",
             "location": "southcentralus"
         }
    ]
}

Flujos de dispositivos (versión preliminar)

La categoría de flujos de dispositivos realiza el seguimiento de las interacciones de solicitud y respuesta enviadas a dispositivos individuales.

{
    "records":
    [
         {
             "time": "2019-09-19T11:12:04Z",
             "resourceId": "Resource Id",
             "operationName": "invoke",
             "category": "DeviceStreams",
             "resultType": "",
             "resultDescription": "",    
             "level": "Information",
             "durationMs": "74",
             "properties": "{\"deviceId\":\"myDevice\",\"moduleId\":\"myModule\",\"sdkVersion\":\"2019-05-01-preview\",\"requestSize\":\"3\",\"responseSize\":\"5\",\"statusCode\":null,\"requestName\":\"myRequest\",\"direction\":\"c2d\"}",
             "location": "Central US"
         }
    ]
}

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 Azure IoT Hub y que están disponibles para consulta por Log Analytics. Para obtener una lista de estas tablas y vínculos a más información sobre el tipo de recurso de IoT Hub, consulte IoT Hub en la referencia de la tabla 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.

Consulte también

Consulte Supervisión de Azure IoT Hub para ver una descripción de la supervisión de Azure IoT Hub.
Para más información sobre la supervisión de recursos de Azure, consulte Supervisión de recursos de Azure con Azure Monitor.

Supervisión de la referencia a datos de Azure IoT Hub

Métricas

Agregaciones compatibles

Métricas de comandos de nube a dispositivo

Métricas de métodos directos de nube a dispositivo

Métricas de operaciones de nube a dispositivo gemelo

Métricas de configuraciones

Métricas de cuotas diarias

Métricas de dispositivos

Métricas de telemetría de dispositivos

Métricas de operaciones de dispositivo gemelo a nube

Métricas de Event Grid

Métricas de trabajos

Métricas de enrutamiento

Métricas de consultas de gemelos

Dimensiones de métricas

Registros del recurso

Conexiones

Telemetría de dispositivo

Comandos de nube a dispositivo

Operaciones de identidad de dispositivos

Operaciones de carga de archivos

Rutas

Operaciones gemelas del dispositivo a la nube

Operaciones gemelas de la nube al dispositivo

Consultas gemelas

Operaciones de trabajos

Métodos directos

Seguimiento distribuido (versión preliminar)

Registros D2C (dispositivo a nube) de IoT Hub

Registros de entrada de IoT Hub

Registros de salida de IoT Hub

Configurations

Flujos de dispositivos (versión preliminar)

Tablas de registros de Azure Monitor

Consulte también

Recursos adicionales