Incorporación de un origen de eventos de Event Hubs al entorno de Azure Time Series Insights
Nota:
El servicio Time Series Insights se retirará el 7 de julio de 2024. Considere la posibilidad de migrar los entornos existentes a otras soluciones 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 Event Hubs en su entorno de Azure Time Series Insights.
Nota:
Los pasos que se describen en este artículo son válidos tanto en entornos de Azure Time Series Insights G1 como en entornos de Azure Time Series Insights G2.
Requisitos previos
- Cree un entorno de Azure Time Series Insights según lo explicado en Creación de un entorno de Azure Time Series Insights.
- Creación de un centro de eventos. Lea Creación de un espacio de nombres de Event Hubs y un centro de eventos con Azure Portal.
- El centro de eventos tiene que tener eventos de mensajes activos que se le hayan enviado. Encontrará más información en Envío de eventos a Azure Event Hubs mediante .NET Framework.
- Cree un grupo de consumidores dedicado en el centro de eventos para que el entorno de Azure Time Series Insights los consuma. 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. Hay un límite de 20 grupos de consumidores por centro de eventos. Si desea información más detallada, lea la Guía de programación de Event Hubs.
Incorporación de un grupo de consumidores al centro de eventos
Las aplicaciones usan grupos de consumidores para extraer datos de Azure Event Hubs. Para leer datos de manera confiable del centro de eventos, proporcione un grupo de consumidores dedicado, solo para su uso en este entorno de Azure Time Series Insights.
Para agregar un nuevo grupo de consumidores al centro de eventos:
En Azure Portal, busque y abra la instancia del centro de eventos desde el panel Información general del espacio de nombres del centro de eventos. Seleccione Entidades > Event Hubs o busque su instancia en Nombre.
En la instancia del centro de eventos, seleccione Entidades > Grupos de consumidores. Luego, seleccione + Grupo de consumidores para agregar un nuevo grupo de consumidores.
En caso contrario, seleccione un grupo de consumidores existente y vaya a la sección siguiente.
En la página Grupos de consumidores, proporcione un nuevo valor exclusivo para Nombre. Use este mismo nombre al crear un nuevo origen del evento en el entorno de Azure Time Series Insights.
Seleccione Crear.
Adición de un nuevo origen del evento
Inicie sesión en Azure Portal.
Busque su entorno de Azure Time Series Insights existente. En el menú de la izquierda, seleccione Todos los recursos y después el entorno de Azure Time Series Insights.
Seleccione Orígenes de eventos y, luego, seleccione Agregar.
Especifique un valor para Nombre de origen del evento que sea exclusivo para este entorno de Azure Time Series Insights, como
Contoso-TSI-Gen 1-Event-Hub-ES.En Origen, seleccione Centro de eventos.
Seleccione los valores apropiados para Opción de importación:
Cuando ya tenga un centro de eventos en una de sus suscripciones seleccione Use Event Hub from available subscriptions (Usar el centro de eventos de 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 Use Event Hub from available subscriptions (Usar el centro de eventos de las suscripciones disponibles):
Propiedad Descripción Suscripción La suscripción a la que pertenece la instancia y el espacio de nombres del centro de eventos deseado. Espacio de nombres del centro de eventos El espacio de nombres del centro de eventos al que pertenece la instancia de centro de eventos deseada. Nombre del centro de eventos Nombre de la instancia de centro de eventos deseada. Valor de la directiva del centro de eventos Seleccione la directiva de acceso compartido deseada. Puede crear la directiva de acceso compartido en el centro de eventos en la pestaña Configurar. 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 lectura. Clave de la directiva del Centro de eventos Se rellena previamente a partir del valor de la directiva del centro de eventos seleccionado. Si el centro de eventos es externo a sus suscripciones o si quiere elegir opciones avanzadas, seleccione Indicar manualmente la configuración del Centro de eventos.
En la siguiente tabla se explican las propiedades necesarias para la opción Indicar manualmente la configuración del Centro de eventos:
Propiedad Descripción Id. de suscripción La suscripción a la que pertenece la instancia y el espacio de nombres del centro de eventos deseado. Resource group El grupo de recursos al que pertenece la instancia y el espacio de nombres del centro de eventos deseado. Espacio de nombres del centro de eventos El espacio de nombres del centro de eventos al que pertenece la instancia de centro de eventos deseada. Nombre del centro de eventos Nombre de la instancia de centro de eventos deseada. Valor de la directiva del centro de eventos Seleccione la directiva de acceso compartido deseada. Puede crear la directiva de acceso compartido en el centro de eventos en la pestaña Configurar. 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 lectura. Clave de la directiva del Centro de eventos La clave de acceso compartido que se usa para autenticar el acceso al espacio de nombres de 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 Event Hubs El grupo de consumidores que lee eventos del centro de eventos. 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 tienen que estar en este formato, de lo contrario 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 eventos. 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 dedicado de Azure Time Series Insights que agregó al centro de eventos.
Seleccione Crear.
Una vez que se haya creado el origen del evento, Azure Time Series Insights iniciará 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.