Compartir a través de


Referencia de datos de supervisión de Azure IoT Hub

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

Consulte Supervisión de Azure IoT para obtener más información sobre los datos que puede recopilar para IoT Hub y cómo usarlos.

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/IoTHubs

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

  • 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 de presentación de la métrica tal como aparece en el portal de Azure.
  • 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 sobre la exportación de métricas, consulte Crear configuración de diagnóstico en Azure Monitor.
Métrica Nombre en la API de REST Unidad Agregación Dimensiones Granulos de tiempo Exportación de DS
Mensajes C2D abandonados

Número de mensajes de nube a dispositivo abandonados por el dispositivo.
c2d.commands.egress.abandon.success Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Entregas de mensajes C2D completadas

Número de entregas de mensajes de la nube al dispositivo que el dispositivo ha completado correctamente.
c2d.commands.egress.complete.success Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Mensajes C2D rechazados

Número de mensajes de la nube al dispositivo que el dispositivo ha rechazado.
c2d.commands.egress.reject.success Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Invocaciones de método directo con errores

El recuento de todas las llamadas fallidas a métodos directos.
c2d.methods.failure Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Tamaño de solicitud de invocaciones de método directo

El promedio, mínimo y máximo de todas las solicitudes exitosas de método directo.
c2d.methods.requestSize Bytes (unidades de información digital) Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Tamaño de respuesta de las invocaciones de método directo

El promedio, mínimo y máximo de todas las respuestas exitosas de método directo.
c2d.methods.responseSize Bytes (unidades de información digital) Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Invocaciones de método directo correctas

El recuento de todas las llamadas a métodos directos realizadas con éxito.
c2d.methods.success Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Error en la lectura de gemelos desde el back-end

El recuento de todas las lecturas gemelas con error iniciadas por el back-end.
c2d.twin.read.failure Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Tamaño de respuesta de las lecturas gemelas del back end

El valor medio, mínimo y máximo de todas las lecturas gemelas correctas iniciadas por el back-end.
c2d.twin.read.size Bytes (unidades de información digital) Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Lecturas gemelas correcta desde el back end

El recuento de todas las lecturas gemelas correctas iniciadas por el back-end.
c2d.twin.read.success Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Actualizaciones gemelas con error del back-end

El recuento de todas las actualizaciones gemelas con error iniciadas por el back-end.
c2d.twin.update.failure Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Tamaño de las actualizaciones de gemelos desde el back end

El tamaño medio, mínimo y máximo de todas las actualizaciones gemelas correctas iniciadas por el back-end.
c2d.twin.update.size Bytes (unidades de información digital) Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Actualizaciones correctas de gemelos desde el back-end

El recuento de todas las actualizaciones gemelas correctas iniciadas por el back-end.
c2d.twin.update.success Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Mensajes C2D expirados

Número de mensajes de la nube al dispositivo expirados
C2DMessagesExpired Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Métricas de configuración

Métricas de las operaciones de configuración
configurations Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Conexiones exitosas

Conexiones exitosas a tu IoTHub
connect.success Contar Suma (Total) ApiType, Protocol, , TLSVersion, TLSCipher PT1M
Dispositivos conectados

Número de dispositivos conectados a IoT Hub
connectedDeviceCount Contar Promedio, Máximo, Mínimo <ninguno> PT1M No
Enrutamiento: mensajes entregados a mensajes/eventos

Número de veces que el enrutamiento de IoT Hub ha entregado mensajes correctamente al punto de conexión integrado (mensajes/eventos).
d2c.endpoints.egress.builtIn.events Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Enrutamiento: mensajes entregados al centro de eventos

Número de veces que el enrutamiento de IoT Hub entregó mensajes correctamente a los puntos de conexión de Event Hub.
d2c.endpoints.egress.eventHubs Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Enrutamiento: mensajes entregados a la cola de Service Bus

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.
d2c.endpoints.egress.serviceBusQueues Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Enrutamiento: mensajes entregados al tema de Service Bus

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.
d2c.endpoints.egress.serviceBusTopics Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Enrutamiento: mensajes entregados al almacenamiento

Número de veces que el enrutamiento de IoT Hub ha entregado mensajes correctamente a los puntos de conexión de almacenamiento.
d2c.endpoints.egress.storage Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Enrutamiento: blobs entregados al almacenamiento

Número de veces que el enrutamiento de IoT Hub ha entregado blobs a los puntos de conexión de almacenamiento.
d2c.endpoints.egress.storage.blobs Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Enrutamiento: datos entregados al almacenamiento

Cantidad de datos (bytes) que el enrutamiento de IoT Hub ha entregado a los punto de conexión de almacenamiento.
d2c.endpoints.egress.storage.bytes Bytes (unidades de información digital) Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Enrutamiento: latencia de mensajes para mensajes o eventos

Latencia media (milisegundos) entre la entrada de mensajes a IoT Hub y la entrada de mensajes de telemetría al punto de conexión integrado (mensajes/eventos).
d2c.endpoints.latency.builtIn.events Milisegundos Promedio, Mínimo, Máximo <ninguno> PT1M
Enrutamiento: latencia de mensajes para el centro de eventos

Latencia media (milisegundos) entre la entrada de mensajes a IoT Hub y la entrada de mensajes a un punto de conexión del centro de eventos.
d2c.endpoints.latency.eventHubs Milisegundos Promedio, Mínimo, Máximo <ninguno> PT1M
Enrutamiento: latencia de mensajes de la cola de Service Bus

Latencia media (milisegundos) entre la entrada de mensajes en IoT Hub y la recepción de mensajes de telemetría en un extremo de la cola de Service Bus.
d2c.endpoints.latency.serviceBusQueues Milisegundos Promedio, Mínimo, Máximo <ninguno> PT1M
Enrutamiento: latencia de mensaje para Service Bus Topic

Latencia media (milisegundos) entre la entrada de mensajes a IoT Hub y la entrada de mensajes de telemetría a un punto de conexión del tema de Service Bus.
d2c.endpoints.latency.serviceBusTopics Milisegundos Promedio, Mínimo, Máximo <ninguno> PT1M
Enrutamiento: latencia de mensajes para el almacenamiento

Latencia media (milisegundos) entre la entrada de mensajes a IoT Hub y la entrada de mensajes de telemetría a un punto de conexión de almacenamiento.
d2c.endpoints.latency.storage Milisegundos Promedio, Mínimo, Máximo <ninguno> PT1M
Enrutamiento: mensajes de telemetría eliminados

Número de veces que el enrutamiento de IoT Hub eliminó mensajes debido a puntos de conexión muertos. Este valor no cuenta los mensajes entregados a la ruta de reserva porque los mensajes quitados no se entregan allí.
d2c.telemetry.egress.dropped Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Enrutamiento: mensajes entregados a la reserva

Número de veces que el enrutamiento de IoT Hub ha entregado mensajes al punto de conexión asociado con la ruta de reserva.
d2c.telemetry.egress.fallback Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Enrutamiento: mensajes de telemetría incompatibles

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. Este valor no incluye los reintentos.
d2c.telemetry.egress.invalid Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Enrutamiento: mensajes de telemetría huérfanos

El número de veces que los mensajes quedaron huérfanos por el enrutamiento de IoT Hub porque no coincidían con ninguna regla de enrutamiento (incluida la regla de reserva).
d2c.telemetry.egress.orphaned Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Enrutamiento: mensajes de telemetría entregados

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.
d2c.telemetry.egress.success Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Intentos de envío de mensajes de telemetría

Número de mensajes de telemetría de dispositivo a nube que se intentaron enviar a tu IoT Hub
d2c.telemetry.ingress.allProtocol Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Número de errores de limitación

Número de errores de limitación debido a las limitaciones de rendimiento del dispositivo
d2c.telemetry.ingress.sendThrottle Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Mensajes de telemetría enviados

Número de mensajes de telemetría de dispositivos a la nube enviados correctamente a su IoT Hub
d2c.telemetry.ingress.success Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Lecturas gemelas con error de los dispositivos

El recuento de todas las lecturas gemelas con error iniciadas por el dispositivo.
d2c.twin.read.failure Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Tamaño de respuesta de las lecturas gemelas de los dispositivos

El valor medio, mínimo y máximo de todas las lecturas gemelas correctas iniciadas por el dispositivo.
d2c.twin.read.size Bytes (unidades de información digital) Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Lecturas gemelas de dispositivos realizadas con éxito

El recuento de todas las lecturas gemelas correctas iniciadas por el dispositivo.
d2c.twin.read.success Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Actualizaciones gemelas de dispositivos con errores

El recuento de todas las actualizaciones gemelas con error iniciadas por el dispositivo.
d2c.twin.update.failure Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Tamaño de las actualizaciones gemelas de los dispositivos

El tamaño medio, mínimo y máximo de todas las actualizaciones gemelas correctas iniciadas por el dispositivo.
d2c.twin.update.size Bytes (unidades de información digital) Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Actualizaciones gemelas correctas de los dispositivos

El recuento de todas las actualizaciones gemelas correctas iniciadas por el dispositivo.
d2c.twin.update.success Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Número total de mensajes usados

Número de mensajes totales usados hoy
dailyMessageQuotaUsed Contar Promedio, Mínimo, Máximo <ninguno> PT1M
Uso total de datos del dispositivo

Bytes transferidos hacia y desde cualquier dispositivo conectado al IoT Hub
deviceDataUsage Bytes (unidades de información digital) Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Uso total de datos del dispositivo (versión preliminar)

Bytes transferidos hacia y desde cualquier dispositivo conectado al IoT Hub
deviceDataUsageV2 Bytes (unidades de información digital) Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Dispositivos conectados (en desuso)

Número de dispositivos conectados a IoT Hub
devices.connectedDevices.allProtocol Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Total de dispositivos (en desuso)

Número de dispositivos registrados en IoT Hub
devices.totalDevices Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Entregas de Event Grid

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).
EventGridDeliveries Contar Promedio, Mínimo, Máximo, Total (Suma) Result, EventType PT1M
Latencia de Event Grid

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.
EventGridLatency Milisegundos Promedio, Mínimo, Máximo EventType PT1M
Cancelaciones fallidas de trabajos

El recuento de todas las llamadas con error para cancelar un trabajo.
jobs.cancelJob.failure Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Cancelaciones de trabajos exitosas

El recuento de todas las llamadas correctas para cancelar un trabajo.
jobs.cancelJob.success Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Trabajos completados

El recuento de todos los trabajos completados.
jobs.completed Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Creaciones con error de trabajos de invocación de método

El recuento de todas las creaciones con error de los trabajos de invocación de método directos.
jobs.createDirectMethodJob.failure Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Creaciones exitosas de tareas de invocación de métodos

El recuento de todas las creaciones correctas de los trabajos de invocación de método directos.
jobs.createDirectMethodJob.success Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Creaciones con error de trabajos de actualización gemelos

El recuento de todas las creaciones con error de trabajos de actualización gemelos.
jobs.createTwinUpdateJob.failure Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Creaciones correctas de trabajos de actualización gemelos

El recuento de todas las creaciones correctas de trabajos de actualización gemelos.
jobs.createTwinUpdateJob.success Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Trabajos fallidos

El recuento de todos los trabajos fallidos.
jobs.failed Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Llamadas con error para enumerar trabajos

El recuento de todas las llamadas con error para enumerar trabajos.
jobs.listJobs.failure Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Llamadas correctas para enumerar trabajos

El recuento de todas las llamadas correctas para enumerar trabajos.
jobs.listJobs.success Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Consultas de trabajo con error

El recuento de todas las llamadas con error para consultar trabajos.
jobs.queryJobs.failure Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Consultas de trabajo exitosas

El recuento de todas las llamadas exitosas para consultar trabajos.
jobs.queryJobs.success Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Tamaño del mensaje de entrega de enrutamiento en bytes (vista previa)

Tamaño total en bytes de los mensajes entregados por un centro de IoT a un punto de conexión. También puede usar las dimensiones EndpointName y EndpointType para ver el tamaño de los mensajes en bytes entregados a los distintos puntos de conexión. El valor de la métrica se incrementa por cada mensaje entregado, incluido si el mensaje se entrega a varios puntos de conexión o si el mensaje se entrega varias veces en el mismo punto de conexión.
RoutingDataSizeInBytesDelivered Bytes (unidades de información digital) Promedio, Mínimo, Máximo, Total (Suma) EndpointType, EndpointName, RoutingSource PT1M
Enrutamiento de entregas (versión preliminar)

Número de veces que IoT Hub intentó la entrega de mensajes a todos los puntos de conexión mediante el enrutamiento. Para ver el número de intentos completados correctamente o con error, use la dimensión Result. Para ver el motivo del error, como no válido, quitado o huérfano, use la dimensión FailureReasonCategory. También puede usar las dimensiones EndpointName y EndpointType para entender cuántos mensajes se entregaron a los distintos puntos de conexión. El valor de la métrica se incrementa en uno por cada intento de entrega, incluido si el mensaje se entrega a varios puntos de conexión o si el mensaje se entrega varias veces en el mismo punto de conexión.
RoutingDeliveries Contar Promedio, Mínimo, Máximo, Total (Suma) EndpointType, , EndpointName, FailureReasonCategory, Result, RoutingSource PT1M
Latencia de entrega de enrutamiento (versión preliminar)

Latencia media (milisegundos) entre la entrada de mensajes a IoT Hub y la entrada de mensajes de telemetría a un punto de conexión. Puede usar las dimensiones EndpointName y EndpointType para comprender la latencia de los distintos puntos de conexión.
RoutingDeliveryLatency Milisegundos Promedio, Mínimo, Máximo EndpointType, EndpointName, RoutingSource PT1M
Total de dispositivos

Número de dispositivos registrados en IoT Hub
totalDeviceCount Contar Promedio, Máximo, Mínimo <ninguno> PT1M No
Consultas gemelas con error

El recuento de todas las consultas gemelas con error.
twinQueries.failure Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Tamaño de resultado de las consultas gemelas

El valor medio, mínimo y máximo del tamaño del resultado de todas las consultas gemelas correctas.
twinQueries.resultSize Bytes (unidades de información digital) Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M
Consultas gemelas correctas

El recuento de todas las consultas gemelas correctas.
twinQueries.success Contar Promedio, Mínimo, Máximo, Total (Suma) <ninguno> PT1M

Agregaciones soportadas

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

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

Para la mayoría de las métricas, todos los tipos de agregación son válidos. En el caso de las métricas de recuento con un valor de columna Unit de Count, solo algunas agregaciones son válidas. Las métricas de recuento pueden ser de dos tipos:

  • En el caso de las métricas de recuento de un solo punto , IoT Hub registra un único punto de datos (básicamente un 1) cada vez que se produce la operación medida. A continuación, Azure Monitor suma estos puntos de datos en la granularidad especificada. Ejemplos de métricas de punto único son los mensajes de telemetría enviados y las entregas de mensajes C2D completadas. Para estas métricas, el único tipo de agregación relevante es Total (Suma). El portal le permite elegir el mínimo, el máximo y el promedio. Estos valores son siempre 1.

  • En el caso de las métricas de recuento de instantáneas , IoT Hub registra un recuento total cuando se produce la operación medida. Actualmente, IoT Hub emite tres métricas de instantáneas : Número total de mensajes usados, Total de dispositivos y Dispositivos conectados. Dado que estas métricas presentan una cantidad "total" cada vez, sumarlas a lo largo de la granularidad especificada no tiene sentido. Azure Monitor limita la selección de promedio, mínimo y máximo para el tipo de agregación de estas métricas.

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 dimensión Descripción
Nombre del Punto Final El nombre del punto de conexión
Tipo de Punto Final eventHubs, serviceBusQueues, cosmosDB, serviceBusTopics, builtino blobStorage
Tipo de evento Microsoft.Devices.DeviceCreated, Microsoft.Devices.DeviceDeleted, Microsoft.Devices.DeviceConnected, Microsoft.Devices.DeviceDisconnectedo Microsoft.Devices.DeviceTelemetry
Para obtener más información, consulte Tipos de eventos.
FailureReasonCategory Uno de los siguientes valores: invalid, dropped, orphaned, o null.
Resultado Ya sea success o failure
EnrutamientoFuente Device Messages, Twin Change Events, Device Lifecycle Events

Nombre para mostrar y agregación de métricas

En las tablas siguientes se proporciona más información sobre las métricas descritas en la tabla anterior. Muestran las métricas de la plataforma IoT Hub por categoría general y enumeran las métricas por su nombre para mostrar asignado en Azure Portal.

Métricas de comandos de la nube al dispositivo:

Nombre de métrica para mostrar Métrica Unidad Descripción
Mensajes C2D caducados C2DMessagesExpired Contar Número de mensajes de la nube al dispositivo expirados
C2D message deliveries completed (Entregas de mensajes de C2D completadas) c2d.commands.egress.complete.success Contar Número de entregas de mensajes de la nube al dispositivo que el dispositivo ha completado correctamente.
C2D messages abandoned (Mensajes de C2D abandonados) c2d.comandos.egreso.abandono.éxito Contar Número de mensajes de nube a dispositivo abandonados por el dispositivo.
C2D messages rejected (Mensajes de C2D rechazados) c2d.commands.egress.reject.success Contar Número de mensajes de la nube al dispositivo que el dispositivo ha rechazado.

En el caso de las métricas con un valor unitario de Count, solo es válida la agregación total (suma). Las agregaciones mínima, máxima y media siempre devuelven 1. Para obtener más información, consulte Agregaciones admitidas.

Métricas de métodos directos de la nube al dispositivo:

Nombre de métrica para mostrar Métrica Unidad Descripción
Invocaciones al método directo con error C2D.Métodos.Falla Contar El recuento de todas las llamadas fallidas a métodos directos.
Tamaño de la solicitud de las invocaciones a métodos directos c2d.methods.requestSize Bytes (unidades de información digital) El recuento de todas las solicitudes de método directo correctas.
Tamaño de la respuesta de las invocaciones a métodos directos c2d.methods.responseSize Bytes (unidades de información digital) El recuento de todas las respuestas correctas del método directo.
Invocaciones correctas al método directo C2D.Métodos.Éxito Contar El recuento de todas las llamadas a métodos directos realizadas con éxito.

En el caso de las métricas con un valor unitario de Recuento , solo es válida la agregación total (suma). Las agregaciones mínima, máxima y media siempre devuelven 1. Para obtener más información, consulte Agregaciones admitidas.

Métricas de operaciones de la nube al dispositivo gemelo:

Nombre de métrica para mostrar Métrica Unidad Descripción
Lecturas gemelas con error del back-end c2d.twin.read.failure Contar El recuento de todas las lecturas gemelas con error iniciadas por el back-end.
Actualizaciones gemelas con error del back-end c2d.twin.update.failure Contar El recuento de todas las actualizaciones gemelas con error iniciadas por el back-end.
Tamaño de la respuesta de las lecturas gemelas del back-end c2d.twin.read.size Bytes (unidades de información digital) El recuento de todas las lecturas gemelas correctas iniciadas por el back-end.
Tamaño de las actualizaciones gemelas del back-end c2d.twin.update.size Bytes (unidades de información digital) El tamaño total de todas las actualizaciones gemelas iniciadas correctamente en el back-end.
Lecturas gemelas correctas del back-end c2d.twin.read.success Contar El recuento de todas las lecturas gemelas correctas iniciadas por el back-end.
Actualizaciones gemelas correctas del back-end c2d.twin.update.success Contar El recuento de todas las actualizaciones gemelas correctas iniciadas por el back-end.

En el caso de las métricas con un valor unitario de Count, solo es válida la agregación total (suma). Las agregaciones mínima, máxima y media siempre devuelven 1. Para obtener más información, consulte Agregaciones admitidas.

Métricas de configuraciones:

Nombre de métrica para mostrar Métrica Unidad Descripción
Métricas de configuración Configuraciones Contar 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.

En el caso de las métricas con un valor unitario de Count, solo es válida la agregación total (suma). Las agregaciones mínima, máxima y media siempre devuelven 1. Para obtener más información, consulte Agregaciones admitidas.

Métricas de cuota diaria:

Nombre de métrica para mostrar Métrica Unidad Descripción
Uso total de datos del dispositivo deviceDataUsage Bytes (unidades de información digital) Bytes transferidos hacia y desde cualquier dispositivo conectado al IoT Hub
Uso total de datos del dispositivo (versión preliminar) deviceDataUsageV2 Total Bytes transferidos hacia y desde cualquier dispositivo conectado al IoT Hub
Número total de mensajes usados dailyMessageQuotaUsed Contar Número total de mensajes utilizados en la actualidad. Un valor acumulativo que se restablece a cero a las 00:00 UTC todos los días.

Para Número total de mensajes utilizados, solo se admiten las agregaciones mínimas, máximas y medias. Para obtener más información, consulte Agregaciones admitidas.

Métricas del dispositivo:

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

En el caso de Total de dispositivos (en desuso) y Dispositivos conectados (en desuso), solo es válida la agregación total (suma). Las agregaciones mínima, máxima y media siempre devuelven 1. Para obtener más información, consulte Agregaciones admitidas.

En el caso de los dispositivos totales y los dispositivos conectados, solo son válidas las agregaciones mínima, máxima y media. Para obtener más información, consulte Agregaciones admitidas.

El total de dispositivos y los dispositivos conectados no se pueden exportar a través de la configuración de diagnóstico.

Métricas de telemetría del dispositivo:

Nombre de métrica para mostrar Métrica Unidad Descripción
Número de errores de limitación d2c.telemetry.ingress.sendThrottle Contar Número de errores de limitación debido a las limitaciones de rendimiento del dispositivo
Intentos de "envío de mensajes" de telemetría d2c.telemetry.ingress.allProtocol Contar Número de mensajes de telemetría de dispositivo a nube que se intentaron enviar a tu IoT Hub
Mensajes de telemetría enviados d2c.telemetry.ingress.success Contar Número de mensajes de telemetría de dispositivos a la nube enviados correctamente a su IoT Hub

En el caso de las métricas con un valor unitario de Count, solo es válida la agregación total (suma). Las agregaciones mínima, máxima y media siempre devuelven 1. Para obtener más información, consulte Agregaciones admitidas.

Métricas de operaciones de dispositivos gemelos en la nube:

Nombre de métrica para mostrar Métrica Unidad Descripción
Lecturas gemelas con error de los dispositivos d2c.twin.read.failure Contar El recuento de todas las lecturas gemelas con error iniciadas por el dispositivo.
Actualizaciones gemelas con error de los dispositivos d2c.twin.update.failure Contar El recuento de todas las actualizaciones gemelas con error iniciadas por el dispositivo.
Tamaño de la respuesta de las lecturas gemelas de dispositivos d2c.twin.read.size Bytes (unidades de información digital) El número de todas las lecturas gemelas iniciadas correctamente por el dispositivo.
Tamaño de las actualizaciones gemelas de los dispositivos d2c.twin.update.size Bytes (unidades de información digital) El tamaño total de todas las actualizaciones gemelas iniciadas correctamente por el dispositivo.
Lecturas gemelas correctas de los dispositivos d2c.twin.read.success Contar El recuento de todas las lecturas gemelas correctas iniciadas por el dispositivo.
Actualizaciones gemelas correctas de los dispositivos d2c.twin.update.success Contar El recuento de todas las actualizaciones gemelas correctas iniciadas por el dispositivo.

En el caso de las métricas con un valor unitario de Count, solo es válida la agregación total (suma). Las agregaciones mínima, máxima y media siempre devuelven 1. Para obtener más información, consulte Agregaciones admitidas.

Métricas de Event Grid:

Nombre de métrica para mostrar Métrica Unidad Descripción
Entregas de Event Grid EventGridDeliveries Contar 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).
Latencia de Event Grid EventGridLatency Milisegundos Latencia media (milisegundos) desde que se generó el evento de IoT Hub hasta que se publicó 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.

En el caso de las métricas con un valor unitario de Count, solo es válida la agregación total (suma). Las agregaciones mínima, máxima y media siempre devuelven 1. Para obtener más información, consulte Agregaciones admitidas.

Métricas de empleos:

Nombre de métrica para mostrar Métrica Unidad Descripción
Trabajos completados trabajos.completados Contar El recuento de todos los trabajos completados.
Llamadas con error para enumerar trabajos empleos.listTrabajos.fracaso Contar El recuento de todas las llamadas con error para enumerar trabajos.
Creaciones con error de trabajos de invocación de método jobs.createDirectMethodJob.failure Contar El recuento de todas las creaciones con error de los trabajos de invocación de método directos.
Creaciones con error de trabajos de actualización gemelos jobs.createTwinUpdateJob.failure Contar El recuento de todas las creaciones con error de trabajos de actualización gemelos.
Cancelaciones de trabajos con error jobs.cancelJob.failure Contar El recuento de todas las llamadas con error para cancelar un trabajo.
Consultas de trabajo con error trabajos.queryJobs.failure Contar El recuento de todas las llamadas con error para consultar trabajos.
Trabajos con error trabajos.fallidos Contar El recuento de todos los trabajos fallidos.
Llamadas correctas para enumerar trabajos empleos.listEmpleos.éxito Contar El recuento de todas las llamadas correctas para enumerar trabajos.
Creaciones correctas de trabajos de invocación de método jobs.createDirectMethodJob.success Contar El recuento de todas las creaciones correctas de los trabajos de invocación de método directos.
Creaciones correctas de trabajos de actualización gemelos jobs.createTwinUpdateJob.
éxito
Contar El recuento de todas las creaciones correctas de trabajos de actualización gemelos.
Cancelaciones de trabajos correctas jobs.cancelJob.success Contar El recuento de todas las llamadas correctas para cancelar un trabajo.
Consultas de trabajo correctas trabajos.queryJobs.success Contar El recuento de todas las llamadas exitosas para consultar trabajos.

En el caso de las métricas con un valor unitario de Count, solo es válida la agregación total (suma). Las agregaciones mínima, máxima y media siempre devuelven 1. Para obtener más información, consulte Agregaciones admitidas.

Métricas de enrutamiento:

Nombre de métrica para mostrar Métrica Unidad Descripción
Entregas de enrutamiento (versión preliminar) RutaEntregas Contar La métrica de entrega de enrutamiento. Utilice las dimensiones para identificar el estado de entrega de un punto de conexión específico o de un origen de enrutamiento específico.
Tamaño del mensaje de entrega de enrutamiento en bytes (versión preliminar) RoutingDataSizeInBytesDelivered Bytes (unidades de información digital) El número total de bytes enrutados por IoT Hub al punto de conexión personalizado y al punto de conexión integrado. Utilice las dimensiones para identificar el tamaño de los datos enrutados a un punto de conexión específico o a un origen de enrutamiento específico.
Latencia de entrega de enrutamiento (versión preliminar) RoutingDeliveryLatency Milisegundos La métrica de latencia de entrega de enrutamiento. Utilice las dimensiones para identificar la latencia de un punto de conexión específico o de un origen de enrutamiento específico.
Enrutamiento: blobs entregados al almacenamiento d2c.endpoints.egress.storage.blobs Contar Número de veces que el enrutamiento de IoT Hub ha entregado blobs a los puntos de conexión de almacenamiento.
Enrutamiento: datos entregados al almacenamiento d2c.endpoints.egress.storage.bytes Bytes (unidades de información digital) Cantidad de datos (bytes) que el enrutamiento de IoT Hub ha entregado a los punto de conexión de almacenamiento.
Enrutamiento: latencia de mensajes para Event Hubs d2c.endpoints.latency.eventHubs Milisegundos La latencia media (milisegundos) entre la entrada de mensajes a IoT Hub y la entrada de mensajes en puntos de conexión personalizados de tipo Event Hubs. Las rutas de mensajes al punto de conexión integrado (eventos) no se incluyen.
Enrutamiento: latencia de mensajes de la cola de Service Bus d2c.endpoints.latency.serviceBusQueues Milisegundos La latencia media (milisegundos) entre la entrada de mensajes a IoT Hub y la entrada de mensajes en un punto de conexión de cola de Service Bus.
Enrutamiento: latencia de mensajes del tema de Service Bus d2c.endpoints.latency.serviceBusTopics Milisegundos La latencia media (milisegundos) entre la entrada de mensajes en IoT Hub y la entrada de mensajes en un punto de conexión de tema de Service Bus.
Enrutamiento: latencia de mensajes para mensajes/eventos d2c.endpoints.latency.builtIn.events Milisegundos La latencia media (milisegundos) entre la entrada de mensajes a IoT Hub y la entrada de mensajes en el punto de conexión integrado (mensajes/eventos) y la ruta de reserva.
Enrutamiento: latencia de mensajes para almacenamiento d2c.endpoints.latency.storage Milisegundos La latencia media (milisegundos) entre la entrada de mensajes a IoT Hub y la entrada de mensajes en un punto de conexión de almacenamiento.
Enrutamiento: mensajes entregados a Event Hubs d2c.endpoints.egress.eventHubs Contar El número de veces que el enrutamiento de IoT Hub entregó correctamente mensajes a puntos de conexión personalizados de tipo Event Hubs. Las rutas de mensajes al punto de conexión integrado (eventos) no se incluyen.
Enrutamiento: mensajes entregados a la cola de Service Bus d2c.endpoints.egress.serviceBusQueues Contar 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.
Enrutamiento: mensajes entregados al tema de Service Bus d2c.endpoints.egress.serviceBusTopics Contar 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.
Enrutamiento: mensajes entregados a la reserva d2c.telemetry.egress.fallback Contar Número de veces que el enrutamiento de IoT Hub ha entregado mensajes al punto de conexión asociado con la ruta de reserva.
Enrutamiento: mensajes entregados a mensajes/eventos d2c.endpoints.egress.builtIn.events Contar El número de veces que el enrutamiento de IoT Hub entregó correctamente mensajes al punto de conexión integrado (mensajes/eventos) y la ruta de reserva.
Enrutamiento: mensajes entregados al almacenamiento d2c.endpoints.egress.storage Contar Número de veces que el enrutamiento de IoT Hub ha entregado mensajes correctamente a los puntos de conexión de almacenamiento.
Enrutamiento: mensajes de telemetría entregados d2c.telemetry.egress.success Contar 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.
Enrutamiento: se quitan los mensajes de telemetría d2c.telemetry.egress.dropped Contar El número de veces que el enrutamiento de IoT Hub quita mensajes debido a puntos de conexión inactivos. Este valor no cuenta los mensajes entregados a la ruta de reserva, ya que los mensajes eliminados no se entregan allí.
Enrutamiento: mensajes de telemetría incompatibles d2c.telemetry.egress.invalid Contar 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. Los mensajes no válidos no se vuelven a intentar. Este valor no incluye los reintentos.
Enrutamiento: mensajes de telemetría huérfanos d2c.telemetry.egress.orphaned Contar El número de veces que el enrutamiento de IoT Hub envía mensajes huérfanos porque no coincidían con ninguna consulta de enrutamiento, cuando la ruta de reserva está deshabilitada.

En el caso de las métricas con un valor unitario de Count, solo es válida la agregación total (suma). Las agregaciones mínima, máxima y media siempre devuelven 1. Para obtener más información, consulte Agregaciones admitidas.

Métricas de consulta dobles:

Nombre de métrica para mostrar Métrica Unidad Descripción
Consultas gemelas con error twinQueries.failure Contar El recuento de todas las consultas gemelas con error.
Consultas gemelas correctas twinQueries.success Contar El recuento de todas las consultas gemelas correctas.
Tamaño de resultado de consultas gemelas twinQueries.resultSize Bytes (unidades de información digital) El total del tamaño del resultado de todas las consultas gemelas correctas.

En el caso de las métricas con un valor unitario de Count, solo es válida la agregación total (suma). Las agregaciones mínima, máxima y media siempre devuelven 1. Para obtener más información, consulte Agregaciones admitidas.

Registros de recursos

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/IotHubs

Categoría Nombre de categoría mostrado Tabla de registro Admite el plan de registro básico Permite la transformación en el momento de la ingesta. Consultas de ejemplo Costes de exportación
C2DCommands Comandos C2D AzureDiagnostics

Registros procedentes de varios recursos de Azure.

No No Consultas No
C2DTwinOperations Operaciones gemelas C2D AzureDiagnostics

Registros procedentes de varios recursos de Azure.

No No Consultas No
Configurations Configuraciones AzureDiagnostics

Registros procedentes de varios recursos de Azure.

No No Consultas No
Connections Conexiones AzureDiagnostics

Registros procedentes de varios recursos de Azure.

No No Consultas No
D2CTwinOperations D2CTwinOperations AzureDiagnostics

Registros procedentes de varios recursos de Azure.

No No Consultas No
DeviceIdentityOperations Operaciones de identidad de dispositivos AzureDiagnostics

Registros procedentes de varios recursos de Azure.

No No Consultas No
DeviceStreams Flujos de dispositivos (versión preliminar) AzureDiagnostics

Registros procedentes de varios recursos de Azure.

No No Consultas No
DeviceTelemetry Telemetría de dispositivo AzureDiagnostics

Registros procedentes de varios recursos de Azure.

No No Consultas No
DirectMethods Métodos directos AzureDiagnostics

Registros procedentes de varios recursos de Azure.

No No Consultas No
DistributedTracing Seguimiento distribuido (versión preliminar) AzureDiagnostics

Registros procedentes de varios recursos de Azure.

No No Consultas No
FileUploadOperations Operaciones de carga de archivos AzureDiagnostics

Registros procedentes de varios recursos de Azure.

No No Consultas No
JobsOperations Operaciones de trabajos AzureDiagnostics

Registros procedentes de varios recursos de Azure.

No No Consultas No
Routes Rutas AzureDiagnostics

Registros procedentes de varios recursos de Azure.

No No Consultas No
TwinQueries Consultas gemelas AzureDiagnostics

Registros procedentes de varios recursos de Azure.

No No Consultas No

En las secciones siguientes se enumeran los tipos de categoría de registro de recursos y los esquemas recopilados para Azure IoT Hub. Los eventos solo se emiten para errores en algunas categorías.

Categoría de comandos de la nube al dispositivo

La categoría de comandos de la nube al dispositivo realiza un seguimiento de los errores que se producen en el centro de IoT y están relacionados con la canalización de mensajes de la nube al dispositivo. En esta categoría se incluyen los errores que se producen por:

  • Envío de mensajes de la nube al dispositivo (como errores de remitente no autorizado),
  • Recibir mensajes de la nube al dispositivo (como errores de recuento de entregas superados) y
  • Recibir comentarios de mensajes de la nube al dispositivo (como errores de comentarios caducados).

Esta categoría no detecta errores cuando el mensaje de la nube al dispositivo se entrega correctamente, pero luego 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"
        }
    ]
}

Categoría de operaciones gemelas de la nube al dispositivo

La categoría de operaciones de gemelo de la nube al dispositivo realiza un seguimiento de los eventos iniciados por el servicio en los dispositivos gemelos. Estas operaciones pueden incluir obtener etiquetas gemelas, actualizar o reemplazar y actualizar o reemplazar las propiedades deseadas.

{
    "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"
        }
    ]
}

Categoría de operaciones gemelas del dispositivo a la nube

La categoría de operaciones de dispositivos gemelos a nube realiza un seguimiento de los eventos iniciados por el dispositivo en dispositivos gemelos. Estas operaciones pueden incluir 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"
        }
    ]
}

Categoría de configuraciones

Los registros de configuración de IoT Hub realizan un 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"
         }
    ]
}

Categoría de conexiones

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

Para conocer el estado de conexión confiable de los dispositivos, consulte Supervisar el 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 obtener información detallada 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 con Azure IoT Hub.

Categoría de operaciones de identidad de dispositivo

La categoría de operaciones de identidad del dispositivo realiza un seguimiento de los errores que se producen al intentar crear, actualizar o eliminar una entrada en el registro de identidades del centro de IoT. El seguimiento de esta categoría es útil para 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"
        }
    ]
}

Categoría de flujos de dispositivos (versión preliminar)

La categoría de transmisiones de dispositivos realiza un seguimiento de las interacciones de solicitud-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"
         }
    ]
}

Categoría de telemetría del dispositivo

La categoría de telemetría del dispositivo realiza un seguimiento de los errores que se producen en el centro de IoT y están relacionados con la canalización de telemetría. Esta categoría incluye errores que se producen al enviar eventos de telemetría (como la limitación) y al recibir eventos de telemetría (como el lector no autorizado). Esta categoría no puede detectar errores causados por 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"
        }
    ]
}

Categoría de métodos directos

La categoría de métodos directos realiza un seguimiento de las interacciones de solicitud-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"
        }
    ]
}

Categoría de seguimiento distribuido (versión preliminar)

La categoría de seguimiento distribuido realiza un seguimiento de los identificadores de correlación de los mensajes que llevan el encabezado de contexto de seguimiento. Para habilitar completamente estos registros, el código del lado cliente debe actualizarse siguiendo Analizar y diagnosticar aplicaciones de IoT de un extremo a otro con el seguimiento distribuido de IoT Hub (versión preliminar).

Se correlationId ajusta a la propuesta de W3C Trace Context , donde contiene un trace-id y un span-id.

Registros D2C (del dispositivo a la nube) de IoT Hub

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

{
    "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, ya que es posible que el reloj de IoT Hub no esté sincronizado con el reloj del dispositivo y, por lo tanto, durationMs un cálculo de duración puede ser engañoso. Se recomienda escribir lógica con las marcas de tiempo de la sección para capturar picos en la latencia del dispositivo a la properties nube.

Propiedad Tipo Descripción
messageSize Entero El tamaño del mensaje del dispositivo a la nube en bytes
deviceId Cadena de caracteres alfanuméricos ASCII de 7 bits La identidad del dispositivo
callerLocalTimeUtc Marca de tiempo UTC La hora de creación del mensaje según lo informado por el reloj local del dispositivo
calleeLocalTimeUtc Marca de tiempo UTC La hora de llegada del mensaje a la puerta de enlace del Centro de IoT según lo informado por el reloj del lado del servicio del Centro de IoT

Registros de entrada de IoT Hub

IoT Hub registra este registro cuando un mensaje que contiene propiedades de seguimiento válidas se escribe en Event Hubs internos o integrados.

{
    "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, este registro contiene información adicional sobre la properties entrada de mensajes.

Propiedad Tipo Descripción
isRoutingEnabled Cuerda True o false, indica si el enrutamiento de mensajes está habilitado o no en IoT Hub
parentSpanId Cuerda El span-id del mensaje primario, que sería el seguimiento del mensaje D2C en este caso

Registros de salida de IoT Hub

IoT Hub registra este registro cuando el enrutamiento está habilitado y el mensaje se escribe en un punto de conexión. Si el enrutamiento no está habilitado, IoT Hub no registra 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, este registro contiene información adicional sobre la properties entrada de mensajes.

Propiedad Tipo Descripción
endpointName Cuerda El nombre del punto de conexión de enrutamiento
endpointType Cuerda El tipo del punto de conexión de enrutamiento
parentSpanId Cuerda El span-id del mensaje primario, que sería el seguimiento del mensaje de entrada de IoT Hub en este caso

Categoría de operaciones de carga de archivos

La categoría de carga de archivos realiza un seguimiento de los errores que se producen en el centro de IoT y están relacionados con la funcionalidad de carga de archivos. Esta categoría incluye:

  • Errores que se producen con el URI de SAS, como cuando expira antes de que un dispositivo notifique al hub que se ha completado una carga.
  • Cargas fallidas notificadas por el dispositivo.
  • Errores que se producen cuando un archivo no se encuentra en el almacenamiento durante la creación de mensajes de notificación de IoT Hub.

Esta categoría no puede detectar errores que se produzcan directamente mientras el dispositivo carga un archivo en el almacenamiento.

{
    "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"
        }
    ]
}

Categoría de operaciones de trabajos

La categoría de operaciones de trabajos informa sobre las solicitudes de trabajo para actualizar 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"
        }
    ]
}

Categoría de rutas

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

  • Una regla se evalúa como "indefinida"
  • IoT Hub marca un punto de conexión como inactivo
  • Cualquier error recibido de un punto de conexión

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

{
    "records":
    [
        {
            "time":"2019-12-12T03:25:14Z",
            "resourceId":"/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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"
        }
    ]
}

Estos son más detalles sobre el enrutamiento de registros de recursos:

Categoría de consultas gemelas

La categoría de consultas gemelas informa sobre las solicitudes de consulta de 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"
        }
    ]
}

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 Microsoft.Devices/IotHubs

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.