Adición de un origen del evento de IoT Hub a su entorno de Azure Time Series Insights
Nota:
El servicio Time Series Insights (TSI) dejará de admitirse a partir de marzo de 2025. Considere la posibilidad de migrar los entornos de TSI existentes a soluciones alternativas lo antes posible. Para más información sobre la entrada en desuso y la migración, consulte nuestra documentación.
Este artículo describe cómo usar Azure Portal para agregar un origen de eventos que lee datos de Azure IoT Hub en su entorno de Time Series Insights.
Nota:
Las instrucciones de este artículo se aplican a los entornos de Azure Time Series Insights Gen 1 y de Azure Time Series Insight Gen 2.
Requisitos previos
- Creación de un entorno de Azure Time Series Insights.
- Creación de una instancia de IoT Hub mediante Azure Portal.
- El centro de IoT Hub debe tener eventos de mensajes activos en proceso de envío.
- Cree un grupo de consumidores dedicado en IoT Hub del que el entorno de Time Series Insight pueda consumir. Cada origen del evento de Azure Time Series Insights debe tener su propio grupo de consumidores dedicado que no se comparte con otros consumidores. Si varios lectores consumen eventos desde el mismo grupo de consumidores, es probable que todos los lectores exhiban errores. Para más información, lea la Guía para desarrolladores de IoT Hub.
Adición de un grupo de consumidores a IoT Hub
Las aplicaciones usan grupos de consumidores para extraer datos de Azure IoT Hub. Para leer datos de manera confiable de IoT Hub, especifique un grupo de consumidores dedicado que use solo este entorno de Azure Time Series Insights.
Para agregar un nuevo grupo de consumidores a la instancia de IoT Hub:
En Azure Portal, busque y abra el centro de IoT Hub.
En el menú, en Configuración, seleccione Puntos de conexión integrados y, luego, seleccione el punto de conexión Eventos.
En Grupos de consumidores, escriba un nombre único para el grupo de consumidores. Use este mismo nombre en el entorno de Azure Time Series Insights al crear un origen del evento.
Seleccione Guardar.
Adición de un nuevo origen del evento
Inicie sesión en Azure Portal.
En el menú izquierdo, seleccione Todos los recursos. Seleccione el entorno de Azure Time Series Insights.
En Configuración, seleccione Orígenes de eventos y luego Agregar.
En el panel Nuevo origen del evento, en Nombre del origen del evento, escriba un nombre que sea exclusivo para este entorno de Azure Time Series Insights. Por ejemplo, escriba event-stream.
En Origen, seleccione IoT Hub.
Seleccione un valor para Opción de importación:
Si ya tiene un centro de IoT en una de sus suscripciones, seleccione Usar IoT Hub desde las suscripciones disponibles. Esta opción presenta el enfoque más sencillo.
En la siguiente tabla se explican las propiedades necesarias para la opción Usar IoT Hub desde las suscripciones disponibles:
Propiedad Descripción Suscripción La suscripción a la que pertenece el centro de IoT deseado. Nombre de IoT Hub El nombre del centro de IoT seleccionado. Nombre de la directiva de IoT Hub Seleccione la directiva de acceso compartido. Puede encontrar esta directiva en la pestaña Configuración de centro de IoT. Cada directiva de acceso compartido tiene un nombre, los permisos establecidos y las claves de acceso. La directiva de acceso compartido para el origen de eventos debe tener permisos de conexión de servicios. Clave de la directiva de IoT Hub La clave se rellena previamente. Si el centro de IoT es externo a sus suscripciones, o si desea elegir opciones avanzadas, seleccione Proporcionar configuración del centro de IoT de forma manual.
En la siguiente tabla se explican las propiedades necesarias para la opción Proporcionar configuración del Centro de IoT de forma manual:
Propiedad Descripción Id. de suscripción La suscripción a la que pertenece el centro de IoT deseado. Resource group El nombre del grupo de recursos en el que se creó este centro de IoT. Nombre de IoT Hub El nombre del centro de IoT. Cuando creó el centro de IoT especificó un nombre para este. Nombre de la directiva de IoT Hub La directiva de acceso compartido. Puede crear esta directiva en la pestaña Configuración de centro de IoT. Cada directiva de acceso compartido tiene un nombre, los permisos establecidos y las claves de acceso. La directiva de acceso compartido para el origen de eventos debe tener permisos de conexión de servicios. Clave de la directiva de IoT Hub La clave de acceso compartido que se usa para autenticar el acceso al espacio de nombres de Azure Service Bus. Especifique la clave principal o secundaria aquí. Ambas opciones comparten las siguientes opciones de configuración:
Propiedad Descripción Grupo de consumidores de IoT Hub El grupo de consumidores que lee eventos del centro de IoT. Es muy recomendable usar un grupo de consumidores dedicado para el origen del evento. Formato de serialización de eventos Actualmente, JSON es el único formato de serialización disponible. Los mensajes de eventos deberán estar en este formato o no se podrá leer ningún dato. Nombre de la propiedad de marca de tiempo Para determinar este valor, es necesario que comprenda el formato de mensaje de los datos del mensaje que se envía al centro de IoT. Este valor es el nombre de la propiedad específica del evento en los datos del mensaje que quiere usar como marca de tiempo del evento. El valor distingue mayúsculas de minúsculas. Si se deja en blanco, se usa la hora de puesta en cola del evento como marca de tiempo del evento en el origen del evento.
Agregue el nombre del grupo de consumidores de Azure Time Series Insight dedicado que agregó a su centro de IoT.
Seleccione Crear.
Una vez que haya creado el origen del evento, Azure Time Series Insights inicia automáticamente la transmisión de datos al entorno.
Pasos siguientes
Defina las directivas de acceso a datos para proteger los datos.
Realice el envío de eventos al origen del evento.
Acceso al entorno en el explorador de Azure Time Series Insights.