Registrar el rendimiento de las canalizaciones de Amazon EventBridge

El registro de canalizaciones de EventBridge le permite hacer que las canalizaciones de EventBridge envíen registros que detallen el rendimiento de las canalizaciones a los servicios de AWS compatibles. Utilice los registros para obtener información sobre el rendimiento de ejecución de su canalización y para ayudar a solucionar problemas y depurar.

Puede seleccionar los siguientes servicios de AWS como destinos de registro a los que las canalizaciones de EventBridge entregan registros:

• Registros de CloudWatch

  EventBridge entrega entradas de registros al grupo de registro de Registros de CloudWatch.

  Utilice Registros de CloudWatch para centralizar los registros de todos los sistemas, aplicaciones y servicios de AWS que utilice, en un único servicio de gran escalabilidad. Para obtener más información, consulte Trabajar con grupos de registro y flujos de registro en la Guía del usuario de Registros de Amazon CloudWatch.

• Registros de flujo Firehose

  EventBridge entrega entradas de registros a un flujo de entrega de Firehose.

  Amazon Data Firehose es un servicio completamente administrado para entregar datos de transmisión en tiempo real a destinos como determinados servicios de AWS, así como a cualquier punto de conexión HTTP personalizado o puntos de conexión HTTP propiedad de proveedores de servicios de terceros compatibles. Para más información, consulte Creación de un flujo de entrega de Amazon Data Firehose en la Guía del usuario de Amazon Data Firehose.

• Registros de Amazon S3

  EventBridge entrega entradas de registros como objetos de Amazon S3 al bucket especificado.

  Amazon S3 es un servicio de almacenamiento de objetos que ofrece escalabilidad, disponibilidad de datos, seguridad y rendimiento líderes del sector. Para obtener más información, consulte Cargar, descargar y trabajar con objetos en Amazon S3 en la Guía del usuario de Amazon Simple Storage Service.

Cómo funciona el registro de canalizaciones de Amazon EventBridge

Cada evento o lote de eventos recibido por una canalización que se dirige a un enriquecimiento o un destino se considera una ejecución de canalización. Si está habilitado, EventBridge genera una entrada de registro para cada paso de ejecución que realiza a medida que se procesa el lote de eventos. La información contenida en el registro se aplica al lote de eventos, ya sea un evento único o hasta 10.000 eventos.

Puede configurar el tamaño del lote de eventos en la canalización de origen y destino. Para obtener más información, consulte Procesamiento por lotes y simultaneidad de canalizaciones de Amazon EventBridge.

Los datos de registro enviados a cada destino de registro son los mismos.

Si se configura un destino de los Registros de Amazon CloudWatch, los entradas de registros entregados a todos los destinos tienen un límite de 256 KB. Los campos se truncarán según sea necesario.

Puede personalizar los registros que EventBridge envía a los destinos de registro seleccionados de la siguiente manera:

• Puede especificar el nivel de registro, que determina los pasos de ejecución para los que EventBridge envía registros a los destinos de registro seleccionados. Para obtener más información, consulte Especificación del nivel de registro de las canalizaciones de EventBridge.

• Puede especificar si las canalizaciones de EventBridge incluyen datos de ejecución en los registros para los pasos de ejecución cuando proceda. Estos datos incluyen:

  • La carga del lote de eventos

  • La solicitud enviada al servicio de destino o de enriquecimiento de AWS

  • La respuesta devuelta por el servicio de destino o de enriquecimiento de AWS

  Para obtener más información, consulte Inclusión de datos de ejecución en los registros de canalizaciones de EventBridge.

Especificación del nivel de registro de las canalizaciones de EventBridge

Puede especificar los tipos de pasos de ejecución para los que EventBridge envía registros a los destinos de registro seleccionados.

Elija entre los siguientes niveles de detalles para incluirlos en los entradas de registros. El nivel de registro se aplica a todos los destinos de registro especificados para la canalización. Cada nivel de registro incluye los pasos de ejecución de los niveles de registro anteriores.

• OFF: EventBridge no envía ningún registro a ningún destino de registro especificado. Este es el valor predeterminado.

• ERROR: EventBridge envía todos los registros relacionados con los errores generados durante la ejecución de la canalización a los destinos de registro especificados.

• INFO: EventBridge envía todos los registros relacionados con errores y selecciona otros pasos realizados durante la ejecución de la canalización a los destinos de registro especificados.

• ERROR: EventBridge envía todos los registros generados durante los pasos de ejecución de la canalización a los destinos de registro especificados.

En la consola de EventBridge, los registros de CloudWatch se seleccionan 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ían los registros que contienen el nivel de detalle de ERROR. Al configurar los registros mediante programación, no se selecciona ningún valor predeterminado.

En la siguiente tabla se enumeran los pasos de ejecución incluidos en cada nivel de registro.

Paso	TRACE	INFO	ERROR	OFF
Ejecución errónea	x	x	x
Ejecución errónea parcialmente	x	x	x
Ejecución iniciada	x	x
Ejecución correcta	x	x
Ejecución limitada	x	x	x
Tiempo de espera de la ejecución	x	x	x
Invocación de enriquecimiento errónea	x	x	x
Invocación de enriquecimiento omitida	x	x
Invocación de enriquecimiento iniciada	x
Invocación de enriquecimiento correcta	x
Fase de enriquecimiento iniciada	x	x
Fase de enriquecimiento errónea	x	x	x
Fase de enriquecimiento correcta	x	x
Transformación de enriquecimiento errónea	x	x	x
Transformación del enriquecimiento iniciada	x
Transformación del enriquecimiento correcta	x
Invocación de destino errónea	x	x	x
Invocación de destino parcialmente errónea	x	x	x
Invocación de destino omitida	x
Invocación de destino iniciada	x
Invocación de destino correcta	x
Fase de destino iniciada	x	x
Fase de destino errónea	x	x	x
Fase de destino parcialmente errónea	x	x	x
Fase de destino omitida	x
Fase de destino correcta	x	x
Transformación de destino errónea	x	x	x
Transformación de destino iniciada	x
Transformación de destino correcta	x

Inclusión de datos de ejecución en los registros de canalizaciones de EventBridge

Puede especificar que EventBridge incluya datos de ejecución en los registros que genere. Los datos de ejecución incluyen campos que representan la carga del lote de eventos, así como la solicitud enviada y la respuesta del enriquecimiento y el destino.

Los datos de ejecución son útiles para solucionar problemas y depurar errores. En el campo payload figura el contenido real de cada evento incluido en el lote, lo que permite correlacionar eventos individuales con una ejecución de canalización específica.

Si opta por incluir los datos de ejecución, estos se incluyen para todos los destinos de registro especificados para la canalización.

importante

Estos campos pueden contener información confidencial. EventBridge no intenta censurar el contenido de estos campos durante el registro.

Al incluir los datos de ejecución, EventBridge añade los siguientes campos a los registros pertinentes:

• payload

  Representa el contenido del lote de eventos que la canalización está procesando.

  EventBridge incluye el campo payload en los registros generados en los pasos en los que es posible que se haya actualizado el contenido del lote de eventos. Esto incluye los siguientes pasos:

  • EXECUTION_STARTED

  • ENRICHMENT_TRANSFORMATION_SUCCEEDED

  • ENRICHMENT_STAGE_SUCCEEDED

  • TARGET_TRANSFORMATION_SUCCEEDED

  • TARGET_STAGE_SUCCEEDED

• awsRequest

  Representa la solicitud enviada al enriquecimiento o al destino como una cadena JSON. En el caso de las solicitudes enviadas a un destino de API, esto representa la solicitud HTTP enviada a ese punto de conexión.

  EventBridge incluye el campo awsRequest en los registros generados en los pasos finales del enriquecimiento y el destino, es decir, después de que EventBridge haya ejecutado o intentado ejecutar la solicitud en el servicio de enriquecimiento o destino especificado. Esto incluye los siguientes pasos:

  • ENRICHMENT_INVOCATION_FAILED

  • ENRICHMENT_INVOCATION_SUCCEEDED

  • TARGET_INVOCATION_FAILED

  • TARGET_INVOCATION_PARTIALLY_FAILED

  • TARGET_INVOCATION_SUCCEEDED

• awsResponse

  Representa la respuesta devuelta por el enriquecimiento o el destino, en formato JSON. En el caso de las solicitudes enviadas a un destino de API, esto representa la respuesta HTTP devuelta por ese punto de conexión.

  Al igual que awsRequest, EventBridge incluye el campo awsResponse en los registros generados en los pasos finales del enriquecimiento y el destino, es decir, después de que EventBridge haya ejecutado o intentado ejecutar la solicitud en el servicio de enriquecimiento o destino especificado. Esto incluye los siguientes pasos:

  • ENRICHMENT_INVOCATION_FAILED

  • ENRICHMENT_INVOCATION_SUCCEEDED

  • TARGET_INVOCATION_FAILED

  • TARGET_INVOCATION_PARTIALLY_FAILED

  • TARGET_INVOCATION_SUCCEEDED

Para obtener más información sobre los pasos de ejecución de canalizaciones, consulte. Pasos de ejecución de canalizaciones de EventBridge

Truncamiento de datos de ejecución en los entradas de registros de canalizaciones de EventBridge

Si opta por que EventBridge incluya los datos de ejecución en los registros de una canalización, existe la posibilidad de que un registro supere el límite de tamaño de 256 KB. Para evitarlo, EventBridge trunca automáticamente los campos de datos de ejecución en el orden siguiente. EventBridge trunca cada campo por completo antes de proceder a truncar el siguiente campo. EventBridge trunca los datos de campo simplemente eliminando los caracteres del final de la cadena de datos; no se intenta truncar en función de la importancia de los datos y el truncamiento invalidará el formato JSON.

• payload

• awsRequest

• awsResponse

Si EventBridge trunca los campos del evento, el campo truncatedFields incluye una lista de los campos de datos truncados.

Informes de errores en los entradas de registros de canalizaciones de EventBridge

EventBridge también incluye datos de errores, cuando están disponibles, en pasos de ejecución de canalizaciones que representan estados de error. Estos pasos incluyen:

• ExecutionThrottled

• ExecutionTimeout

• ExecutionFailed

• ExecutionPartiallyFailed

• EnrichmentTransformationFailed

• EnrichmentInvocationFailed

• EnrichmentStageFailed

• TargetTransformationFailed

• TargetInvocationFailed

• TargetInvocationPartiallyFailed

• TargetStageFailed

• TargetStagePartiallyFailed