Registrar Amazon EventBridge Pipes

EventBridge El registro de tuberías le permite hacer que EventBridge Pipes envíe registros que detallen el rendimiento de las tuberías a AWS los servicios 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 AWS servicios como destinos de registro a los que EventBridge Pipes entrega los registros:

• CloudWatch Registros

  EventBridge entrega los registros al grupo de CloudWatch registros especificado.

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

• Registros de transmisión Firehose

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

  Amazon Data Firehose es un servicio totalmente gestionado para entregar datos de streaming en tiempo real a destinos como determinados AWS servicios, así como a cualquier punto de enlace HTTP personalizado o punto de enlace HTTP propiedad de proveedores de servicios externos compatibles. Para obtener 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 los 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 EventBridge de Amazon Pipes

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á activado, EventBridge genera un registro 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 Amazon EventBridge Pipes.

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

Si se configura un destino de Amazon CloudWatch Logs, los registros de registro 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 se EventBridge envían 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 se EventBridge envían los registros a los destinos de registro seleccionados. Para obtener más información, consulte Especificar el nivel EventBridge de registro de Pipes.

• Puede especificar si EventBridge Pipes incluye los datos de ejecución en los registros de los pasos de ejecución cuando sea relevante. Estos datos incluyen:

  • La carga del lote de eventos

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

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

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

Especificar el nivel EventBridge de registro de Pipes

Puede especificar los tipos de pasos de ejecución para los que se EventBridge envían los 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.

• DESACTIVADO: 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.

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

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

En la EventBridge consola, CloudWatch los registros se seleccionan como destino de registro de forma predeterminada, al igual que el nivel de ERROR registro. Por lo tanto, de forma predeterminada, EventBridge Pipes crea un nuevo grupo de CloudWatch registros al que envía los registros que contienen el ERROR nivel de detalle. 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

Incluir datos de ejecución en los registros EventBridge de Pipes

Puede especificar que se incluyan datos de ejecución en los registros que genera. EventBridge 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 agrega los siguientes campos a los registros pertinentes:

• payload

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

  EventBridge incluye el payload campo 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 awsRequest campo en los registros generados en las etapas finales del enriquecimiento y la segmentación, es decir, después de haber EventBridge ejecutado o intentado ejecutar la solicitud en relación con 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.

  Del mismo modoawsRequest, EventBridge incluye el awsResponse campo en los registros generados en las etapas finales del enriquecimiento y la segmentación, es decir, después EventBridge de ejecutar o intentar ejecutar una solicitud contra el servicio objetivo o de enriquecimiento especificado y haber recibido una respuesta. 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. EventBridge Canaliza los pasos de ejecución

Truncar los datos de ejecución en los registros de Pipes EventBridge

Si opta por EventBridge incluir los datos de ejecución en los registros de una tubería, existe la posibilidad de que un registro supere el límite de tamaño de 256 KB. Para evitarlo, trunca EventBridge automáticamente los campos de datos de ejecución, en el siguiente orden. EventBridge trunca cada campo por completo antes de avanzar para truncar el siguiente campo. EventBridge trunca los datos del 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 trunca los campos en ese caso, el truncatedFields campo EventBridge incluye una lista de los campos de datos truncados.

Informes de errores en los registros de Pipes EventBridge

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

• ExecutionThrottled

• ExecutionTimeout

• ExecutionFailed

• ExecutionPartiallyFailed

• EnrichmentTransformationFailed

• EnrichmentInvocationFailed

• EnrichmentStageFailed

• TargetTransformationFailed

• TargetInvocationFailed

• TargetInvocationPartiallyFailed

• TargetStageFailed

• TargetStagePartiallyFailed