Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Creación de una canalización de Amazon EventBridge
Las canalizaciones de EventBridge le permiten crear integraciones punto a punto entre los orígenes y los destinos, incluidas transformaciones y enriquecimiento avanzados de los eventos. Para crear una canalización de EventBridge, realice los siguientes pasos:
Para obtener más información sobre cómo crear una canalización con la CLI de AWS, consulte create-pipe
Especificación de un origen
Para empezar, especifique el origen desde el que desea que la canalización reciba los eventos.
Para especificar un origen de la canalización mediante la consola
Abra la consola de Amazon EventBridge en https://console.aws.amazon.com/events/
. -
En el panel de navegación, seleccione Canalizaciones.
-
Seleccione Crear canalización.
-
Escriba un nombre para la canalización.
-
(Opcional) Agregue una descripción de la canalización.
-
En la pestaña Crear canalización, en Origen, seleccione el tipo de origen que desee especificar para esta canalización y configure el origen.
Las propiedades de configuración difieren en función del tipo de origen que seleccione:
Configuración del filtrado de eventos (opcional)
Puede añadir filtros a su canalización de forma que solo envíe un subconjunto de eventos del origen al destino.
Para configurar el filtrado mediante la consola
-
Seleccione Filtrado.
-
En Evento de muestra: opcional, verá un evento de muestra que puede usar para crear su patrón de eventos, o puede introducir su propio evento seleccionando Introduce el suyo.
-
En Patrón de eventos, introduce el patrón de eventos que quiere usar para filtrar los eventos. Para obtener más información sobre cómo crear filtros, consulte Filtrado de eventos de las canalizaciones de Amazon EventBridge.
A continuación se muestra un ejemplo de patrón de eventos que solo envía eventos con el valor Seattle en el campo Ciudad.
{ "data": { "City": ["Seattle"] } }
Ahora que se están filtrando los eventos, puede añadir un enriquecimiento opcional y un destino para la canalización.
Definición del enriquecimiento de eventos (opcional)
Puede enviar los datos del evento para su enriquecimiento a una función de Lambda, a una máquina de estado de AWS Step Functions, a Amazon API Gateway o a un destino de API.
Para seleccionar el enriquecimiento
-
Seleccione Enriquecimiento.
-
En Detalles, en Servicio, seleccione el servicio y la configuración relacionada que desee usar para el enriquecimiento.
También puede transformar los datos antes de enviarlos para su enriquecimiento.
(Opcional) Para definir el transformador de entrada
-
Seleccione Transformador de entrada de enriquecimiento: opcional.
-
En Eventos de muestra/Carga de evento, seleccione el tipo de evento de muestra.
-
En Transformador, introduzca la sintaxis del transformador, por ejemplo
"Event happened at <$.detail.field>."
, donde<$.detail.field>
es una referencia a un campo del evento de muestra. También puede hacer doble clic en un campo del evento de muestra para añadirlo al transformador. -
En Salida, compruebe que la salida tenga el aspecto que desea.
Ahora que los datos se han filtrado y enriquecido, debe definir un destino al que enviar los datos del evento.
Configuración de un destino
Para configurar un destino
-
Seleccione Destino.
-
En Detalles, en Servicio de destino, seleccione el destino. Los campos mostrados varían en función del destino que seleccione. Introduzca la información específica de este tipo de destino, según sea necesario.
También puede transformar los datos antes de enviarlos al destino.
(Opcional) Para definir el transformador de entrada
-
Seleccione Transformador de entrada de destino: opcional.
-
En Eventos de muestra/Carga de evento, seleccione el tipo de evento de muestra.
-
En Transformador, introduzca la sintaxis del transformador, por ejemplo
"Event happened at <$.detail.field>."
, donde<$.detail.field>
es una referencia a un campo del evento de muestra. También puede hacer doble clic en un campo del evento de muestra para añadirlo al transformador. -
En Salida, compruebe que la salida tenga el aspecto que desea.
Ahora que la canalización está configurada, asegúrese de que sus ajustes estén configurados correctamente.
Configuración de los ajustes de la canalización
Una canalización está activa por defecto, pero puede desactivarla. También puede especificar los permisos de la canalización, configurar el registro de la canalización y añadir etiquetas.
Para configurar los ajustes de la canalización
-
Seleccione la pestaña Ajustes de la canalización.
-
Por defecto, las canalizaciones recién creadas están activas desde su creación. Si quiere crear una canalización inactiva, en Activación, en Activar canalización, desactive la opción Activa.
-
En Permisos, en Rol de ejecución, realice una de las siguientes acciones:
-
Para que EventBridge cree un rol de ejecución nuevo para esta canalización, seleccione Crear un rol nuevo para este recurso. En Nombre del rol, si lo desea, puede editar el nombre del rol.
-
Para usar un rol de ejecución existente, seleccione Usar un rol existente. En Nombre del rol, seleccione el rol.
-
-
(Opcional) Si ha especificado un flujo de Kinesis o de DynamoDB como origen de la canalización, puede configurar una política de reintentos y una cola de mensajes fallidos (DLQ).
En Política de reintentos y cola de mensajes fallidos: opcional, haga lo siguiente:
En Política de reintentos, haga lo siguiente:
-
Si quieres activar las políticas de reintentos, active Reintento. De forma predeterminada, las canalizaciones recién creadas no tienen activada la política de reintentos.
-
En Antigüedad máxima del evento, introduzca un valor entre un minuto (00:01) y 24 horas (24:00).
-
En Cantidad de reintentos, introduzca un número entre 0 y 185.
-
Si desea usar una cola de mensajes fallidos (DLQ), active Cola de mensajes fallidos, seleccione el método que prefiera y elija la cola o el tema que quiera usar. De forma predeterminada, las canalizaciones recién creadas no utilizan una DLQ.
-
-
Elija la KMS key para EventBridge que desea utilizar al cifrar los datos de canalizaciones.
Para obtener más información sobre cómo EventBridge usa las KMS keys, consulte Cifrado en reposo.
-
Elija Usar la Clave propiedad de AWS para que EventBridge cifre los datos mediante una Clave propiedad de AWS.
Esta Clave propiedad de AWS es una KMS key que EventBridge posee y administra para su uso en varias cuentas de AWS. En general, a menos que se le pida que audite o controle la clave de cifrado que protege sus recursos, una Clave propiedad de AWS es una buena opción.
Esta es la opción predeterminada.
-
Elija Usar la clave administrada por el cliente para que EventBridge cifre los datos con la clave administrada por el cliente que especifique o cree.
Las Claves administradas por el cliente son KMS keys en la cuenta de AWS que ha creado, posee y administra. Usted tiene el control total de estas KMS keys.
-
Especifique una clave administrada por el cliente existente o seleccione Crear una nueva KMS key.
EventBridge muestra el estado de la clave y cualquier alias de clave que se haya asociado a la clave administrada por el cliente especificada.
-
-
-
(Opcional) En Registros: opcional, puede configurar la forma en que las canalizaciones de EventBridge envían la información de registro a los servicios compatibles, incluida la forma de configurar esos registros.
Para obtener más información sobre los registros de canalizaciones, consulte Registrar el rendimiento de las canalizaciones de Amazon EventBridge.
Registros de CloudWatch se selecciona como destino de registro predeterminado, al igual que el nivel de registro de
ERROR
. Por lo tanto, de forma predeterminada, las canalizaciones de EventBridge crean un grupo de registro de CloudWatch nuevo al que envía los registros que contienen el nivel de detalle deERROR
.Para que las canalizaciones de EventBridge envíen los registros a cualquiera de los destinos de registro compatibles, haga lo siguiente:
-
En Registros: opcional, seleccione los destinos a los que quiere que se envíen los registros.
-
En Nivel de registro, elija el nivel de información para EventBridge que desee incluir en los registros. El nivel de registro de
ERROR
está seleccionado de forma predeterminada.Para obtener más información, consulte Especificación del nivel de registro de las canalizaciones de EventBridge.
-
Seleccione Incluir datos de ejecución si desea que EventBridge incluya la información de carga del evento y la información de solicitud y respuesta de servicio en los registros.
Para obtener más información, consulte Inclusión de datos de ejecución en los registros de canalizaciones de EventBridge.
-
Configure cada destino de registro que haya seleccionado:
En registros de CloudWatch Logs, en Registros de CloudWatch, haga lo siguiente:
-
En Grupo de registro de CloudWatch, elija si desea que EventBridge cree un grupo de registro nuevo o puede seleccionar un grupo de registro existente o especificar el ARN de un grupo de registro existente.
-
Para los grupos de registro nuevos, edite el nombre del grupo de registro según desee.
Registros de CloudWatch está seleccionado de manera predeterminada.
Para los registros de flujo de Firehose, en Registro de flujo de Firehose, seleccione el flujo de Firehose.
En registros de Amazon S3, en Registros de S3, haga lo siguiente:
-
Introduzca el nombre del bucket que utilizará como destino del registro.
-
Introduzca el ID de la cuenta de AWS del propietario del bucket.
-
Introduzca el texto de prefijo que desee utilizar cuando EventBridge crea objetos S3.
Para obtener más información, consulte Organizar objetos mediante prefijos en la Guía del usuario de Amazon Simple Storage Service.
-
Elija cómo desea que EventBridge formatee los registros de S3:
-
json
: JSON -
plain
: Texto sin formato
-
-
-
-
(Opcional) En Etiquetas; opcional, seleccione Añadir etiqueta nueva e introduzca una o varias etiquetas para la regla. Para obtener más información, consulte Etiquetado de recursos en Amazon EventBridge.
-
Seleccione Crear canalización.
Validación de los parámetros de configuración
Tras crear una canalización, EventBridge valida los siguientes parámetros de configuración:
-
Rol de IAM: dado que el origen de una canalización no se puede cambiar una vez creada la canalización, EventBridge comprueba que el rol de IAM proporcionado pueda acceder al origen.
nota
EventBridge no realiza la misma validación para los enriquecimientos o los destinos, ya que estos se pueden actualizar una vez creada la canalización.
-
Procesamiento por lotes: EventBridge valida que el tamaño del lote del origen no supere el tamaño máximo del lote del destino. Si es así, EventBridge exige un tamaño de lote inferior. Además, si un destino no admite el procesamiento por lotes, no puede configurar el procesamiento por lotes en EventBridge para el origen.
-
Enriquecimientos: EventBridge valida que el tamaño de lote para los enriquecimientos de API Gateway y API de destino sea 1, ya que solo se admiten lotes de 1.