Log Amazon EventBridge Pipes

EventBridge O registro de tubulações permite que você faça com que a EventBridge Pipes envie registros detalhando o desempenho da tubulação para os AWS serviços suportados. Use logs para obter informações sobre o desempenho de execução do seu pipe e para ajudar na solução de problemas e na depuração.

Você pode selecionar os seguintes AWS serviços como destinos de log para os quais o EventBridge Pipes entrega registros:

• CloudWatch Registros

  EventBridge entrega registros de registro para o grupo de CloudWatch registros de registros especificado.

  Use o CloudWatch Logs para centralizar os registros de todos os seus sistemas, aplicativos e AWS serviços que você usa, em um único serviço altamente escalável. Para obter mais informações, consulte Como trabalhar com grupos e fluxos de registros no Guia do usuário do Amazon CloudWatch Logs.

• Registros de transmissão do Firehose

  EventBridge entrega registros de log para um stream de entrega do Firehose.

  O Amazon Data Firehose é um serviço totalmente gerenciado para fornecer dados de streaming em tempo real para destinos como determinados AWS serviços, bem como qualquer endpoint HTTP personalizado ou endpoints HTTP de propriedade de provedores de serviços terceirizados compatíveis. Para obter mais informações, consulte Criação de um stream de entrega do Amazon Data Firehose no Guia do usuário do Amazon Data Firehose.

• Logs do Amazon S3

  EventBridge entrega registros de log como objetos do Amazon S3 para o bucket especificado.

  O Amazon S3 é um serviço de armazenamento de objetos que oferece escalabilidade, disponibilidade de dados, segurança e performance líderes do setor. Para obter mais informações, consulte Fazer upload, baixar e trabalhar com objetos no Amazon S3 no Manual do usuário do Amazon Simple Storage Service.

Como funciona o registro do Amazon EventBridge Pipes

Uma execução de pipe é um evento ou lote de eventos recebidos por um pipe que viaja até um enriquecimento e/ou destino. Se ativado, EventBridge gera um registro de log para cada etapa de execução executada à medida que o lote de eventos é processado. As informações contidas no registro se aplicam ao lote de eventos, seja ele um único evento ou até 10 mil eventos.

Também é possível configurar o tamanho do lote de eventos na origem e no destino do pipe. Para ter mais informações, consulte Lotes e simultaneidade do Amazon EventBridge Pipes.

Os dados de registro enviados para cada destino de registro são os mesmos.

Se um destino do Amazon CloudWatch Logs estiver configurado, os registros de log entregues a todos os destinos terão um limite de 256 kb. Os campos serão truncados conforme necessário.

Você pode personalizar os registros EventBridge enviados para os destinos de log selecionados da seguinte forma:

• Você pode especificar o nível de log, que determina as etapas de execução para as quais EventBridge envia registros para os destinos de log selecionados. Para ter mais informações, consulte Especificando o nível EventBridge de registro de tubos.

• Você pode especificar se o EventBridge Pipes inclui dados de execução nos registros das etapas de execução quando forem relevantes. Esses dados incluem:

  • A carga útil do lote de eventos

  • A solicitação enviada ao serviço de AWS enriquecimento ou de destino

  • A resposta retornada pelo serviço de AWS enriquecimento ou de destino

  Para ter mais informações, consulte Incluindo dados de execução nos registros do EventBridge Pipes.

Especificando o nível EventBridge de registro de tubos

Você pode especificar os tipos de etapas de execução para as quais os registros são EventBridge enviados para os destinos de log selecionados.

Escolha entre os níveis de detalhe a seguir para incluir nos registros de log. O nível de log se aplica a todos os destinos de log especificados para o pipe. Cada nível de log inclui as etapas de execução dos níveis de log anteriores.

• DESLIGADO — EventBridge não envia nenhum registro para nenhum destino de registro especificado. Essa é a configuração padrão.

• ERROR — EventBridge envia todos os registros relacionados aos erros gerados durante a execução do pipe para os destinos de log especificados.

• INFO — EventBridge envia todos os registros relacionados a erros, bem como seleciona outras etapas executadas durante a execução do pipe para os destinos de log especificados.

• TRACE — EventBridge envia todos os registros gerados durante qualquer etapa da execução do pipe para os destinos de log especificados.

No EventBridge console, CloudWatch os registros são selecionados como um destino de registro por padrão, assim como o nível do ERROR registro. Então, por padrão, o EventBridge Pipes cria um novo CloudWatch grupo de registros para o qual envia registros de log contendo o ERROR nível de detalhe. Nenhum padrão é selecionado ao configurar os logs programaticamente.

A tabela a seguir lista as etapas de execução inclusas em cada nível do log.

Etapa	RASTREAR	INFO	ERRO	DESL.
Falha na execução	x	x	x
Execução com falha parcial	x	x	x
Execução iniciada	x	x
Execução bem-sucedida	x	x
Execução limitada	x	x	x
Tempo limite de execução	x	x	x
Invocação de enriquecimento com falha	x	x	x
Invocação de enriquecimento ignorada	x	x
Invocação de enriquecimento iniciada	x
Invocação de enriquecimento com êxito	x
Fase de enriquecimento iniciada	x	x
Fase de enriquecimento com falha	x	x	x
Estágio de enriquecimento com êxito	x	x
Transformação de enriquecimento com falha	x	x	x
Transformação de enriquecimento iniciada	x
Transformação do enriquecimento com êxito	x
Invocação de destino com falha	x	x	x
Invocação de destino com falha parcial	x	x	x
Invocação do destino ignorada	x
Invocação do destino iniciada	x
Invocação do destino com êxito	x
Estágio de destino inserido	x	x
Estágio de destino com falha	x	x	x
Falha parcial do estágio de destino	x	x	x
Estágio de destino ignorado	x
Estágio de destino com êxito	x	x
Falha na transformação do alvo	x	x	x
Transformação de destino iniciada	x
Transformação do destino com êxito	x

Incluindo dados de execução nos registros do EventBridge Pipes

Você pode especificar EventBridge para incluir dados de execução nos registros que ele gera. Os dados de execução incluem campos que representam a carga útil do lote de eventos, bem como a solicitação enviada e a resposta do enriquecimento e do destino.

Os dados de execução são úteis para solução de problemas e depuração. O campo payload contém o conteúdo real de cada evento incluído no lote, permitindo que você correlacione eventos individuais a uma execução de pipe específica.

Se optar por incluir dados de execução, eles serão incluídos em todos os destinos de log especificados para o pipe.

Importante

Esses campos podem conter informações confidenciais. EventBridge não faz nenhuma tentativa de redigir o conteúdo desses campos durante o registro.

Ao incluir dados de execução, EventBridge adicione os seguintes campos aos registros relevantes:

• payload

  Representa o conteúdo do lote de eventos que está sendo processado pelo pipe.

  EventBridge inclui o payload campo nos registros gerados nas etapas em que o conteúdo do lote de eventos pode ter sido atualizado. Isto inclui as seguintes etapas:

  • EXECUTION_STARTED

  • ENRICHMENT_TRANSFORMATION_SUCCEEDED

  • ENRICHMENT_STAGE_SUCCEEDED

  • TARGET_TRANSFORMATION_SUCCEEDED

  • TARGET_STAGE_SUCCEEDED

• awsRequest

  Representa a solicitação enviada ao enriquecimento ou ao destino como uma string JSON. Para solicitações enviadas para um destino de API, isto representa a solicitação HTTP enviada para esse endpoint.

  EventBridge inclui o awsRequest campo nos registros gerados nas etapas finais de enriquecimento e direcionamento; ou seja, depois EventBridge de ter executado ou tentado executar a solicitação em relação ao serviço de enriquecimento ou destino especificado. Isto inclui as seguintes etapas:

  • ENRICHMENT_INVOCATION_FAILED

  • ENRICHMENT_INVOCATION_SUCCEEDED

  • TARGET_INVOCATION_FAILED

  • TARGET_INVOCATION_PARTIALLY_FAILED

  • TARGET_INVOCATION_SUCCEEDED

• awsResponse

  Representa a resposta retornada pelo enriquecimento ou destino, no formato JSON. Para solicitações enviadas para um destino de API, isto representa a resposta HTTP retornada desse endpoint.

  Da mesma formaawsRequest, EventBridge inclui o awsResponse campo nos registros gerados nas etapas finais de enriquecimento e direcionamento; ou seja, depois de executar EventBridge ou tentar executar uma solicitação no serviço de enriquecimento ou destino especificado e receber uma resposta. Isto inclui as seguintes etapas:

  • ENRICHMENT_INVOCATION_FAILED

  • ENRICHMENT_INVOCATION_SUCCEEDED

  • TARGET_INVOCATION_FAILED

  • TARGET_INVOCATION_PARTIALLY_FAILED

  • TARGET_INVOCATION_SUCCEEDED

Para uma discussão sobre as etapas de execução do pipe, consulte EventBridge Etapas de execução de tubos.

Truncando dados de execução nos registros de log do EventBridge Pipes

Se você optar por EventBridge incluir dados de execução nos registros de log de um pipe, existe a possibilidade de que um registro exceda o limite de tamanho de 256 KB. Para evitar isso, trunca EventBridge automaticamente os campos de dados de execução, na seguinte ordem. EventBridge trunca cada campo inteiramente antes de prosseguir para truncar o próximo campo. EventBridge trunca os dados do campo simplesmente removendo caracteres do final da sequência de dados; nenhuma tentativa é feita para truncar com base na importância dos dados, e o truncamento invalidará a formatação JSON.

• payload

• awsRequest

• awsResponse

Se EventBridge truncar campos no evento, o truncatedFields campo incluirá uma lista dos campos de dados truncados.

Relatório de erros nos registros EventBridge de log do Pipes

EventBridge também inclui dados de erro, quando disponíveis, nas etapas de execução do pipe que representam estados de falha. Essas etapas incluem:

• ExecutionThrottled

• ExecutionTimeout

• ExecutionFailed

• ExecutionPartiallyFailed

• EnrichmentTransformationFailed

• EnrichmentInvocationFailed

• EnrichmentStageFailed

• TargetTransformationFailed

• TargetInvocationFailed

• TargetInvocationPartiallyFailed

• TargetStageFailed

• TargetStagePartiallyFailed