Uso del enrutamiento de mensajes de IoT Hub para enviar mensajes del dispositivo a la nube a servicios de Azure

El enrutamiento de mensajes le permite enviar mensajes desde los dispositivos a los servicios en la nube de forma automatizada, escalable y confiable. El enrutamiento de mensajes se puede usar para:

  • Envía mensajes y eventos de telemetría del dispositivo al endpoint integrado y a endpoints personalizados. Los eventos que se pueden enrutar incluyen eventos de ciclo de vida del dispositivo, eventos de cambio de dispositivos gemelos, eventos de cambio de gemelo digital y eventos de estado de conexión del dispositivo.

  • Filtra los datos antes de enrutarlos aplicando consultas enriquecidas. El enrutamiento de mensajes le permite realizar consultas sobre las propiedades de los mensajes y el cuerpo del mensaje, así como las etiquetas del dispositivo gemelo y las propiedades del dispositivo gemelo. Para más información, consulte Consultas en el enrutamiento de mensajes.

IoT Hub define un formato común para todos los mensajes del dispositivo a la nube a fin de generar interoperabilidad entre protocolos. Para más información, consulte Creación y lectura de mensajes de IoT Hub.

Nota:

Algunas de las características que se mencionan en este artículo, como la mensajería de la nube al dispositivo, los dispositivos gemelos y la administración de dispositivos, solo están disponibles en el nivel estándar de IoT Hub. Para obtener más información sobre los niveles básico y estándar o gratuito de IoT Hub, consulte Elección del nivel y tamaño adecuados de IoT Hub para la solución.

Diferencias entre perfiles de conexión

El modelo de enrutamiento se comparte entre perfiles de conexión, pero las fuentes de datos, puntos finales y operaciones disponibles dependen del perfil. Los hubs de perfil clásico admiten el punto de conexión integrado y el enrutamiento alternativo. Para el perfil MQTT v5 (vista previa):

  • El endpoint integrado messages/events no está disponible. No use un lector ni una fuente Fabric IoT Hub que dependa de ese endpoint.
  • No se admite el enrutamiento de reserva. Los mensajes que no coinciden con ninguna ruta habilitada no se entregan a los destinos configurados.
  • Configura rutas explícitas habilitadas hacia destinos compatibles. Para la verificación inicial, utilice la telemetría del dispositivo como fuente y la condición true para crear una ruta de todos los mensajes. Esta ruta normal no es una ruta de reserva, y IoT Hub no la crea automáticamente. Después de la prueba, consérvala solo si tu aplicación necesita esa ruta.

Estas restricciones no eliminan el endpoint integrado ni la alternativa de reserva de los hubs de perfil clásico. Para los destinos compatibles y sus requisitos, consulte Endpoints personalizados para el enrutamiento de mensajes. Para el filtrado MQTT v5, consulte Consultas de temas y propiedades de usuario. Compruebe las capacidades de MQTT v5 antes de utilizar las características descritas para el perfil de conexión clásico.

Puntos de conexión de enrutamiento

Los hubs con el perfil de conexión clásico tienen un endpoint de enrutamiento predeterminado llamado mensajes/eventos que es compatible con los Event Hubs. También puedes crear endpoints personalizados que apunten a servicios de Azure compatibles o a secuencias de eventos de Microsoft Fabric. Los hubs con el perfil de conexión MQTT v5 utilizan únicamente puntos finales personalizados.

IoT Hub admite actualmente los siguientes puntos de conexión para el enrutamiento de mensajes:

  • Endpoint integrado (solo perfil de conexión clásico)
  • Contenedores de almacenamiento
  • Colas de Service Bus
  • Temas de Service Bus
  • Event Hubs
  • Cosmos DB
  • Microsoft Fabric Eventstreams

Para obtener más información sobre cada uno de estos puntos de conexión, consulte Puntos de conexión de IoT Hub.

El endpoint de Fabric Eventstream está generalmente disponible para ambos perfiles de conexión; el perfil de conexión MQTT v5 permanece en vista previa. Para referencias del esquema de rutas en versión preliminar y formatos de carga útil de endpoint, consulte Preparar telemetría para agentes y análisis.

Cada mensaje se enruta a todos los puntos de conexión cuyas consultas de enrutamiento coinciden, lo que significa que un mensaje se puede enrutar a varios puntos de conexión. Sin embargo, si un mensaje coincide con varias rutas que apuntan al mismo punto de conexión, IoT Hub entrega el mensaje a ese punto de conexión solo una vez.

IoT Hub necesita acceso de escritura a estos puntos de conexión de servicio para que el enrutamiento de mensajes funcione. Si configura los puntos de conexión a través de Azure Portal, se agregan los permisos necesarios automáticamente. Si configura los puntos de conexión mediante PowerShell o la CLI de Azure, debe proporcionar el permiso de acceso de escritura.

Para obtener información sobre cómo crear puntos de conexión, consulte Administración de rutas y puntos de conexión mediante Azure Portal.

Asegúrese de configurar los servicios para admitir el rendimiento esperado. Por ejemplo, si usa Event Hubs como punto de conexión personalizado, debe configurar las unidades de procesamiento para ese centro de eventos de forma que pueda controlar la entrada de eventos que planea enviar mediante el enrutamiento de mensajes de IoT Hub. Del mismo modo, cuando se usa una cola de Service Bus como punto de conexión, es preciso configurar el tamaño máximo para asegurarse de que puede contener todos los datos que se introduzcan, hasta que los consumidores los extraigan. Al configurar por primera vez la solución de IoT, es posible que tenga que supervisar los demás puntos de conexión y realizar ajustes para la carga real.

Si el punto de conexión personalizado tiene configuraciones de firewall, considere la posibilidad de usar excepciones propias de confianza de Microsoft.

Ruta a un punto de conexión en otra suscripción

Si el recurso de punto de conexión está en una suscripción diferente a la del centro de IoT, puede usar distintos métodos de autenticación en función de los requisitos de seguridad:

  • Autenticación basada en claves: Puedes usar cadenas de conexión para autenticarte en puntos finales en diferentes suscripciones o incluso en distintos inquilinos. Este método usa las claves de acceso o las cadenas de conexión del punto de conexión para la autenticación.

  • Identidad administrada asignada por el usuario: Para mayor seguridad, puedes configurar tu hub IoT como un servicio de confianza de Microsoft y usar la identidad administrada asignada por el usuario para la autenticación. Este método requiere configurar la identidad administrada antes de crear el punto de conexión personalizado.

Para más información sobre la autenticación de identidad administrada, consulte Conectividad de salida de IoT Hub a otros recursos de Azure.

Enrutamiento de consultas

El enrutamiento de mensajes de IoT Hub proporciona una funcionalidad de consulta para filtrar los datos antes de enrutarlos a los puntos de conexión. Cada consulta de enrutamiento tiene las siguientes propiedades:

Propiedad Descripción
Nombre Nombre único que identifica la consulta.
Source El origen del flujo de datos sobre el que se debe actuar. Por ejemplo, telemetría de dispositivo.
Condición La expresión de consulta para la consulta de enrutamiento que se ejecuta en las propiedades de la aplicación de mensajes, las propiedades del sistema, el cuerpo del mensaje, las etiquetas del dispositivo gemelo y las propiedades del dispositivo gemelo para determinar si coincide con el punto de conexión.
Punto de conexión El nombre del punto de conexión donde IoT Hub envía mensajes que cumplen la consulta. Se recomienda que elija un punto de conexión en la misma región que su instancia de IoT Hub.

Un único mensaje puede coincidir con la condición en varias consultas de enrutamiento, en cuyo caso IoT Hub entrega el mensaje al punto de conexión asociado a cada consulta coincidente. IoT Hub también desduplica automáticamente la entrega de mensajes. Si un mensaje coincide con varias consultas que tienen el mismo destino, IoT Hub solo la entrega una vez a ese destino.

Para más información, consulte Sintaxis de las consultas de enrutamiento de mensajes de IoT Hub.

Leer datos enrutados

En los siguientes artículos obtendrá información sobre cómo leer mensajes de un punto de conexión.

Ruta de reserva

El enrutamiento de reserva está disponible para el perfil de conexión clásico, pero no para el perfil de conexión MQTT v5. Una ruta explícita con la condición true selecciona toda la telemetría del dispositivo. Esta ruta no es una ruta de respaldo y debes crearla por separado.

La ruta de reserva envía todos los mensajes que no cumplen las condiciones de consulta en cualquiera de las rutas existentes al punto de conexión integrado (mensajes o eventos) que sea compatible con Event Hubs. Si el enrutamiento de mensajes está habilitado, puede habilitar la funcionalidad de ruta de reserva. Una vez que se crea cualquier ruta, los datos dejan de fluir al punto de conexión integrado, a menos que se cree una ruta a ese punto de conexión. Si no hay rutas al punto de conexión integrado y se habilita una ruta de respaldo, solo se envían al punto de conexión integrado los mensajes que no coinciden con ninguna condición de consulta establecida en las rutas. Incluso si se eliminan todas las rutas existentes, se debe habilitar la capacidad de ruta de reserva para recibir todos los datos en el punto de conexión integrado.

Puede habilitar o deshabilitar la ruta de reserva en Azure Portal en la página Enrutamiento de mensajes. También puede usar Azure Resource Manager para que FallbackRouteProperties use un punto de conexión personalizado para la ruta de reserva.

Eventos que no son de telemetría

Además de la telemetría del dispositivo, el enrutamiento de mensajes también permite enviar eventos de no telemetría, entre los que se incluyen:

  • Eventos de cambio de dispositivo gemelo
  • Eventos de ciclo de vida del dispositivo
  • Eventos de ciclo de vida del trabajo del dispositivo
  • Eventos de cambio de gemelo digital
  • Eventos del estado de conexión del dispositivo

Por ejemplo, si se crea una ruta con el origen de datos establecido en Eventos de cambio de dispositivo gemelo, IoT Hub envía mensajes al punto de conexión que contienen el cambio en el dispositivo gemelo. De forma similar, si se crea una ruta con el origen de datos establecido en Eventos de ciclo de vida del dispositivo, IoT Hub envía un mensaje que indica si el dispositivo o el módulo se han eliminado o creado. Para más información sobre los eventos del ciclo de vida de los dispositivos, consulte Notificaciones del ciclo de vida de dispositivos y módulos.

Al usar Azure IoT Plug and Play, un desarrollador puede crear rutas con el origen de datos establecido en Eventos de cambio de gemelo digital e IoT Hub enviará mensajes siempre que se establezca o cambie una propiedad de gemelo digital, se sustituya un gemelo digital o se produzca un evento de cambio para el dispositivo gemelo subyacente. Finalmente, si se crea una ruta con el origen de datos establecido en Device Connection State Events (Eventos de estado de conexión del dispositivo), IoT Hub enviará un mensaje que indica si el dispositivo se ha conectado o desconectado.

IoT Hub también se integra con Azure Event Grid para publicar los eventos de dispositivo con el fin de admitir integraciones en tiempo real y la automatización de flujos de trabajo basados en estos eventos. Para obtener información sobre qué servicio funciona mejor para su escenario, consulte las diferencias entre el enrutamiento de mensajes y Event Grid.

Limitaciones de los eventos de estado de conexión del dispositivo

Los eventos de estado de conexión de dispositivos están disponibles para los dispositivos que se conectan mediante el protocolo MQTT o AMQP, o mediante cualquiera de estos protocolos a través de WebSockets. Las solicitudes realizadas solo con HTTPS no desencadenan notificaciones de estado de conexión del dispositivo. Para que IoT Hub comience a enviar eventos de estado de conexión de dispositivos, después de abrir una conexión, un dispositivo debe llamar a la operación de recepción de mensajes de nube a dispositivo o a la operación de telemetría de envío de dispositivo a nube. Fuera de los SDK de Azure IoT, en MQTT estas operaciones equivalen a las operaciones SUBSCRIBE o PUBLISH en los temas de mensajería correspondientes. Con AMQP, estas operaciones equivalen a adjuntar o transferir un mensaje en las rutas de acceso al vínculo adecuadas. Para más información, consulte los siguientes artículos.

IoT Hub no notifica cada evento individual de conexión y desconexión de los dispositivos, sino que publica el estado de conexión actual tomado en una instantánea periódica de 60 segundos. Si se recibe el mismo evento de estado de conexión con diferentes números de secuencia o eventos de estado de conexión distintos, quiere decir que se ha producido un cambio en el estado de conexión del dispositivo durante el período de 60 segundos.

Prueba de rutas

Al crear una ruta nueva o al modificar una ruta existente, debe probar la consulta de ruta con un mensaje de ejemplo. Puede probar rutas individuales o probar todas las rutas a la vez y no se enruta ningún mensaje a los puntos de conexión durante la prueba. Puede usar Azure Portal, Azure Resource Manager, Azure PowerShell y la CLI de Azure para realizar las pruebas. Los resultados ayudan a identificar si el mensaje de ejemplo coincide o no con la consulta, o si no se pudo ejecutar la prueba porque la sintaxis del mensaje de ejemplo o de la consulta son incorrectas. Para obtener más información, consulte Prueba de una ruta y Prueba de todas las rutas.

Latencia

Al enrutar mensajes de telemetría del dispositivo a la nube, aumenta ligeramente la latencia de un extremo a otro tras las creación de la primera ruta.

En la mayoría de los casos, el aumento medio de la latencia es inferior a 500 milisegundos. Sin embargo, la latencia que experimenta puede variar y puede ser mayor en función del nivel del centro de IoT y de la arquitectura de la solución. Puede supervisar la latencia con las métricas de IoT Hub Enrutamiento: latencia de mensaje para mensajes y eventos o d2c.endpoints.latency.builtIn.events. La creación o eliminación de cualquier ruta después de la primera no afecta a la latencia de un extremo a otro.

Supervisión y solución de problemas

IoT Hub proporciona varias métricas relacionadas con el enrutamiento y los puntos de conexión para ofrecerle una visión general del mantenimiento del centro y los mensajes enviados. También puede realizar el seguimiento de los errores que se producen durante la evaluación de una consulta de enrutamiento y del estado del punto de conexión que percibe IoT Hub con la categoría rutas de los registros de recursos de IoT Hub. Para obtener más información sobre el uso de métricas y registros de recursos con IoT Hub, consulte Supervisión de Azure IoT Hub.

Puede usar la API REST Get Endpoint Health para obtener el estado de mantenimiento de los puntos de conexión.

Use la guía de solución de problemas del enrutamiento para obtener una información más detallada y soporte técnico para solucionar problemas de enrutamiento.