Partekatu honen bidez:


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

Número de mensajes de la nube al dispositivo que el dispositivo ha abandonado.
c2d.commands.egress.abandon.success Count Promedio, Mínimo, Máximo, Total <none> 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 Count Promedio, Mínimo, Máximo, Total <none> PT1M
Mensajes C2D rechazados

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

El número de todas las llamadas al método directo con error.
c2d.methods.failure Count Promedio, Mínimo, Máximo, Total <none> PT1M
Tamaño de solicitud de invocaciones de método directo

El valor medio, mínimo y máximo de todas las solicitudes correctas de método directo.
c2d.methods.requestSize Bytes Promedio, Mínimo, Máximo, Total <none> PT1M
Tamaño de respuesta de las invocaciones de método directo

El valor medio, mínimo y máximo de todas las respuestas correctas de método directo.
c2d.methods.responseSize Bytes Promedio, Mínimo, Máximo, Total <none> PT1M
Invocaciones de método directo correctas

El número de todas las llamadas correctas al método directo.
c2d.methods.success Count Promedio, Mínimo, Máximo, Total <none> PT1M
Lecturas gemelas erróneas del back-end

El recuento de todas las lecturas gemelas con error iniciadas por el back-end.
c2d.twin.read.failure Count Promedio, Mínimo, Máximo, Total <none> PT1M
Tamaño de respuesta de 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 Promedio, Mínimo, Máximo, Total <none> PT1M
Lecturas gemelas correctas del back-end

El recuento de todas las lecturas gemelas correctas iniciadas por el back-end.
c2d.twin.read.success Count Promedio, Mínimo, Máximo, Total <none> PT1M
Actualizaciones de gemelos con errores del back-end

El recuento de todas las actualizaciones gemelas con error iniciadas por el back-end.
c2d.twin.update.failure Count Promedio, Mínimo, Máximo, Total <none> PT1M
Tamaño de las actualizaciones gemelas del 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 Promedio, Mínimo, Máximo, Total <none> PT1M
Actualizaciones gemelas correctas del back-end

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

Número de mensajes de la nube al dispositivo expirados
C2DMessagesExpired Count Promedio, Mínimo, Máximo, Total <none> PT1M
Métricas de configuración

Métricas de las operaciones de configuración
configurations Count Promedio, Mínimo, Máximo, Total <none> PT1M
Dispositivos conectados

Número de dispositivos conectados a IoT Hub
connectedDeviceCount Count Promedio, Máximo, Mínimo <none> PT1M No
Enrutamiento: mensajes entregados a mensajes o 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 Count Promedio, Mínimo, Máximo, Total <none> PT1M
Enrutamiento: mensajes entregados al centro de eventos

Número de veces que el enrutamiento de IoT Hub ha entregado mensajes correctamente a los puntos de conexión del centro de eventos.
d2c.endpoints.egress.eventHubs Count Promedio, Mínimo, Máximo, Total <none> 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 Count Promedio, Mínimo, Máximo, Total <none> 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 Count Promedio, Mínimo, Máximo, Total <none> 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 Count Promedio, Mínimo, Máximo, Total <none> 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 Count Promedio, Mínimo, Máximo, Total <none> 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 Promedio, Mínimo, Máximo, Total <none> 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 MilliSeconds Promedio, Mínimo, Máximo <none> 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 MilliSeconds Promedio, Mínimo, Máximo <none> PT1M
Enrutamiento: latencia de mensajes para la cola de Service Bus

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 la cola de Service Bus.
d2c.endpoints.latency.serviceBusQueues MilliSeconds Promedio, Mínimo, Máximo <none> PT1M
Enrutamiento: latencia de mensajes para el tema de Service Bus

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 MilliSeconds Promedio, Mínimo, Máximo <none> 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 MilliSeconds Promedio, Mínimo, Máximo <none> PT1M
Enrutamiento: mensajes de telemetría eliminados

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í.
d2c.telemetry.egress.dropped Count Promedio, Mínimo, Máximo, Total <none> PT1M
Enrutamiento: mensajes entregados a 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 Count Promedio, Mínimo, Máximo, Total <none> 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 Count Promedio, Mínimo, Máximo, Total <none> PT1M
Enrutamiento: mensajes de telemetría huérfanos

Número de veces que los mensajes eran huérfanos a causa del enrutamiento de IoT Hub porque no coincidían con las reglas de enrutamiento (incluida la regla de reserva).
d2c.telemetry.egress.orphaned Count Promedio, Mínimo, Máximo, Total <none> 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 Count Promedio, Mínimo, Máximo, Total <none> PT1M
Intentos de envío de mensajes de telemetría

Número de mensajes de telemetría de dispositivo a la nube para enviar a IoT Hub
d2c.telemetry.ingress.allProtocol Count Promedio, Mínimo, Máximo, Total <none> 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 Count Promedio, Mínimo, Máximo, Total <none> PT1M
Mensajes de telemetría enviados

Número de mensajes de telemetría de dispositivo a la nube enviados correctamente a IoT Hub
d2c.telemetry.ingress.success Count Promedio, Mínimo, Máximo, Total <none> PT1M
Lecturas gemelas con errores de dispositivos

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

El valor medio, mínimo y máximo de todas las lecturas gemelas correctas iniciadas por el dispositivo.
d2c.twin.read.size Bytes Promedio, Mínimo, Máximo, Total <none> PT1M
Lecturas gemelas correctas desde dispositivos

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

El recuento de todas las actualizaciones gemelas con error iniciadas por el dispositivo.
d2c.twin.update.failure Count Promedio, Mínimo, Máximo, Total <none> 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 Promedio, Mínimo, Máximo, Total <none> PT1M
Actualizaciones gemelas correctas de dispositivos

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

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

Bytes transferidos hacia y desde cualquier dispositivo conectado al Centro de IOT
deviceDataUsage Bytes Promedio, Mínimo, Máximo, Total <none> PT1M
Uso total de datos del dispositivo (versión preliminar)

Bytes transferidos hacia y desde cualquier dispositivo conectado al Centro de IOT
deviceDataUsageV2 Bytes Promedio, Mínimo, Máximo, Total <none> PT1M
Dispositivos conectados (en desuso)

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

Número de dispositivos registrados en IoT Hub
devices.totalDevices Count Promedio, Mínimo, Máximo, Total <none> 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 Count Promedio, Mínimo, Máximo, Total 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 MilliSeconds Promedio, Mínimo, Máximo EventType PT1M
Cancelaciones de trabajos con errores

El recuento de todas las llamadas con error para cancelar un trabajo.
jobs.cancelJob.failure Count Promedio, Mínimo, Máximo, Total <none> PT1M
Cancelaciones de trabajos correctas

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

El recuento de todos los trabajos completados.
jobs.completed Count Promedio, Mínimo, Máximo, Total <none> PT1M
Creaciones erróneas de trabajos de invocación de métodos

El recuento de todas las creaciones con error de los trabajos de invocación de método directos.
jobs.createDirectMethodJob.failure Count Promedio, Mínimo, Máximo, Total <none> PT1M
Creaciones correctas de trabajos 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 Count Promedio, Mínimo, Máximo, Total <none> PT1M
Creaciones erróneas de trabajos de actualización de gemelos

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

El recuento de todas las creaciones correctas de trabajos de actualización gemelos.
jobs.createTwinUpdateJob.success Count Promedio, Mínimo, Máximo, Total <none> PT1M
Trabajos con error

El recuento de todos los trabajos con error.
jobs.failed Count Promedio, Mínimo, Máximo, Total <none> PT1M
Llamadas con error a la lista de trabajos

El recuento de todas las llamadas con error para enumerar trabajos.
jobs.listJobs.failure Count Promedio, Mínimo, Máximo, Total <none> PT1M
Llamadas correctas a la lista de trabajos

El recuento de todas las llamadas correctas para enumerar trabajos.
jobs.listJobs.success Count Promedio, Mínimo, Máximo, Total <none> PT1M
Consultas de trabajo con errores

El recuento de todas las llamadas con error para consultar trabajos.
jobs.queryJobs.failure Count Promedio, Mínimo, Máximo, Total <none> PT1M
Consultas de trabajo correctas

El recuento de todas las llamadas correctas para consultar trabajos.
jobs.queryJobs.success Count Promedio, Mínimo, Máximo, Total <none> PT1M
Tamaño del mensaje de entrega de enrutamiento en bytes (versión preliminar)

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 Promedio, Mínimo, Máximo, Total 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 Count Promedio, Mínimo, Máximo, Total 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 MilliSeconds Promedio, Mínimo, Máximo EndpointType, , EndpointName, RoutingSource PT1M
Total de dispositivos

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

El recuento de todas las consultas gemelas con error.
twinQueries.failure Count Promedio, Mínimo, Máximo, Total <none> 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 Promedio, Mínimo, Máximo, Total <none> PT1M
Consultas gemelas correctas

El recuento de todas las consultas gemelas correctas.
twinQueries.success Count Promedio, Mínimo, Máximo, Total <none> PT1M

Agregaciones compatibles

La columna Tipo de agregación de la tabla corresponde a la agregación predeterminada que se usa cuando se selecciona la métrica para un gráfico o 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. Para 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 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 permite elegir el mínimo, máximo y promedio. Estos valores siempre son 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, sumarlas sobre la granularidad especificada no tiene sentido. Azure Monitor le limita a seleccionar los valores promedio, mínimo y máximo del 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 la 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 Uno de los siguientes valores: invalid, dropped, orphanedo null.
Resultado success o failure
RoutingSource 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 de IoT Hub por categoría general y enumeran las métricas por su nombre para mostrar tal y como se asigna en Azure Portal.

Métricas de comandos de nube a dispositivo:

Nombre para mostrar de la métrica Métrica Unidad Descripción
Mensajes de C2D expirados C2DMessagesExpired Count 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 Count 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.commands.egress.abandon.success Count Número de mensajes de la nube al dispositivo que el dispositivo ha abandonado.
C2D messages rejected (Mensajes de C2D rechazados) c2d.commands.egress.reject.success Count Número de mensajes de la nube al dispositivo que el dispositivo ha rechazado.

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 para mostrar de la métrica Métrica Unidad Descripción
Invocaciones al método directo con error c2d.methods.failure Count El número de todas las llamadas al método directo con error.
Tamaño de la solicitud de las invocaciones a métodos directos c2d.methods.requestSize Bytes El número de todas las solicitudes correctas del método directo.
Tamaño de la respuesta de las invocaciones a métodos directos c2d.methods.responseSize Bytes El número de todas las respuestas correctas del método directo.
Invocaciones correctas al método directo c2d.methods.success Count El número de todas las llamadas correctas al método directo.

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 operaciones de nube a dispositivo gemelo:

Nombre para mostrar de la métrica Métrica Unidad Descripción
Lecturas gemelas con error del back-end c2d.twin.read.failure Count 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 Count 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 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 El tamaño total de todas las actualizaciones gemelas correctas iniciadas por el back-end.
Lecturas gemelas correctas del back-end c2d.twin.read.success Count El recuento de todas las lecturas gemelas correctas iniciadas por el back-end.
Actualizaciones gemelas correctas del back-end c2d.twin.update.success Count El recuento de todas las actualizaciones gemelas correctas iniciadas por el back-end.

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 configuraciones:

Nombre para mostrar de la métrica Métrica Unidad Descripción
Métricas de configuración configuraciones Count 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 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 cuota diarias:

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

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 del dispositivo:

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

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 del dispositivo:

Nombre para mostrar de la métrica Métrica Unidad Descripción
Número de errores de limitación d2c.telemetry.ingress.sendThrottle Count 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 Count Número de mensajes de telemetría de dispositivo a la nube para enviar a IoT Hub
Mensajes de telemetría enviados d2c.telemetry.ingress.success Count Número de mensajes de telemetría de dispositivo a la nube enviados correctamente a IoT Hub

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 operaciones de dispositivo a gemelo en la nube:

Nombre para mostrar de la métrica Métrica Unidad Descripción
Lecturas gemelas con error de los dispositivos d2c.twin.read.failure Count El recuento de todas las lecturas gemelas con error iniciadas por el dispositivo.
Actualizaciones gemelas con error de los dispositivos d2c.twin.update.failure Count 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 El número de todas las lecturas gemelas correctas iniciadas por el dispositivo.
Tamaño de las actualizaciones gemelas de los dispositivos d2c.twin.update.size Bytes El tamaño total de todas las actualizaciones gemelas correctas iniciadas por el dispositivo.
Lecturas gemelas correctas de los dispositivos d2c.twin.read.success Count El recuento de todas las lecturas gemelas correctas iniciadas por el dispositivo.
Actualizaciones gemelas correctas de los dispositivos d2c.twin.update.success Count El recuento de todas las actualizaciones gemelas correctas iniciadas por el dispositivo.

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 Event Grid:

Nombre para mostrar de la métrica Métrica Unidad Descripción
Entregas de Event Grid EventGridDeliveries Count 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 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.

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 trabajos:

Nombre para mostrar de la métrica Métrica Unidad Descripción
Trabajos completados jobs.completed Count El recuento de todos los trabajos completados.
Llamadas con error para enumerar trabajos jobs.listJobs.failure Count 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 Count 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 Count El recuento de todas las creaciones con error de trabajos de actualización gemelos.
Cancelaciones de trabajos con error jobs.cancelJob.failure Count El recuento de todas las llamadas con error para cancelar un trabajo.
Consultas de trabajo con error jobs.queryJobs.failure Count El recuento de todas las llamadas con error para consultar trabajos.
Trabajos con error jobs.failed Count El recuento de todos los trabajos con error.
Llamadas correctas para enumerar trabajos jobs.listJobs.success Count El recuento de todas las llamadas correctas para enumerar trabajos.
Creaciones correctas de trabajos de invocación de método jobs.createDirectMethodJob.success Count 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.
success
Count El recuento de todas las creaciones correctas de trabajos de actualización gemelos.
Cancelaciones de trabajos correctas jobs.cancelJob.success Count El recuento de todas las llamadas correctas para cancelar un trabajo.
Consultas de trabajo correctas jobs.queryJobs.success Count El recuento de todas las llamadas correctas para consultar trabajos.

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 enrutamiento:

Nombre para mostrar de la métrica Métrica Unidad Descripción
Entregas de enrutamiento (versión preliminar) RoutingDeliveries Count 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.
Tamaño del enrutamiento de los mensajes entregados en bytes (versión preliminar) RoutingDataSizeInBytesDelivered Bytes 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.
Latencia de entrega de enrutamiento (versión preliminar) RoutingDeliveryLatency Milisegundos 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.
Enrutamiento: blobs entregados al almacenamiento d2c.endpoints.egress.storage.blobs Count 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 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 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).
Enrutamiento: latencia de mensajes de la cola de Service Bus d2c.endpoints.latency.serviceBusQueues Milisegundos 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.
Enrutamiento: latencia de mensajes del tema de Service Bus d2c.endpoints.latency.serviceBusTopics Milisegundos 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.
Enrutamiento: latencia de mensajes para mensajes/eventos d2c.endpoints.latency.builtIn.events Milisegundos 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.
Enrutamiento: latencia de mensajes para almacenamiento d2c.endpoints.latency.storage Milisegundos Latencia media (milisegundos) entre la entrada de mensajes a IoT Hub y la entrada de mensajes a un punto de conexión de almacenamiento.
Enrutamiento: mensajes entregados a Event Hubs d2c.endpoints.egress.eventHubs Count 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).
Enrutamiento: mensajes entregados a la cola de Service Bus d2c.endpoints.egress.serviceBusQueues Count 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 Count 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 Count 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 Count 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.
Enrutamiento: mensajes entregados al almacenamiento d2c.endpoints.egress.storage Count 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 Count 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: mensajes de telemetría eliminados d2c.telemetry.egress.dropped Count El número de veces que el enrutamiento de IoT Hub quita los mensajes debidos a 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í.
Enrutamiento: mensajes de telemetría incompatibles d2c.telemetry.egress.invalid Count 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 no es compatible con un punto de conexión cuando Iot Hub intenta entregar el mensaje a un punto de conexión y se produce un error notransciente. No se reintentan los mensajes no válidos. Este valor no incluye los reintentos.
Enrutamiento: mensajes de telemetría huérfanos d2c.telemetry.egress.orphaned Count Número de veces que IoT Hub enruta mensajes huérfanos porque no coinciden con ninguna consulta de enrutamiento, cuando la ruta de reserva está deshabilitada.

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 consulta gemelas:

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

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.

Registros del recurso

En esta sección se enumeran los tipos de registros de recursos que se pueden recopilar para este servicio. La sección extrae de la lista de todos los tipos de categorías de registros admitidos en Azure Monitor.

Registros de recursos admitidos para Microsoft.Devices/IotHubs

Category Nombre para mostrar de categoría Tabla de registro Admite el plan de registro básico Admite la transformación en tiempo de ingesta Consultas de ejemplo Costos para exportar
C2DCommands Comandos C2D AzureDiagnostics

Registros de varios recursos de Azure.

No No Consultas No
C2DTwinOperations Operaciones gemelas C2D AzureDiagnostics

Registros de varios recursos de Azure.

No No Consultas No
Configurations Configurations AzureDiagnostics

Registros de varios recursos de Azure.

No No Consultas No
Connections Conexiones AzureDiagnostics

Registros de varios recursos de Azure.

No No Consultas No
D2CTwinOperations D2CTwinOperations AzureDiagnostics

Registros de varios recursos de Azure.

No No Consultas No
DeviceIdentityOperations Operaciones de identidad de dispositivos AzureDiagnostics

Registros de varios recursos de Azure.

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

Registros de varios recursos de Azure.

No No Consultas No
DeviceTelemetry Telemetría de dispositivo AzureDiagnostics

Registros de varios recursos de Azure.

No No Consultas No
DirectMethods Métodos directos AzureDiagnostics

Registros de varios recursos de Azure.

No No Consultas No
DistributedTracing Seguimiento distribuido (versión preliminar) No N.º No
FileUploadOperations Operaciones de carga de archivos AzureDiagnostics

Registros de varios recursos de Azure.

No No Consultas No
JobsOperations Operaciones de trabajos AzureDiagnostics

Registros de varios recursos de Azure.

No No Consultas No
Routes Rutas AzureDiagnostics

Registros de varios recursos de Azure.

No No Consultas No
TwinQueries Consultas gemelas AzureDiagnostics

Registros de varios recursos de Azure.

No No Consultas No

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

Categoría de 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"
        }
    ]
}

Categoría de operaciones de gemelos de nube a 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"
        }
    ]
}

Categoría de operaciones de dispositivos a nube gemelos

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

Categoría Configuraciones

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

Categoría 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.

Categoría de operaciones de identidad de dispositivo

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

Categoría de flujos de dispositivo (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"
         }
    ]
}

Categoría de telemetría del 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"
        }
    ]
}

Categoría de 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"
        }
    ]
}

Categoría de 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.

Categoría de 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"
        }
    ]
}

Categoría de 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"
        }
    ]
}

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 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 inactivo
  • Los errores recibidos de 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:

Categoría de 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"
        }
    ]
}

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.