로그 아마존 EventBridge 파이프

EventBridge 파이프 로깅을 사용하면 Pipes가 EventBridge 파이프 성능을 자세히 설명하는 레코드를 지원되는 AWS 서비스에 전송하도록 할 수 있습니다. 로그를 사용하면 파이프의 실행 성능을 파악하고 문제 해결 및 디버깅에 유용합니다.

Pipes가 레코드를 전달하는 로그 대상으로 다음 AWS 서비스를 선택할 수 있습니다. EventBridge

• CloudWatch 로그

  EventBridge 지정된 로그 로그 그룹에 CloudWatch 로그 레코드를 전달합니다.

  CloudWatch 로그를 사용하면 사용하는 모든 시스템, 애플리케이션 및 AWS 서비스의 로그를 확장성이 뛰어난 단일 서비스로 중앙 집중화할 수 있습니다. 자세한 내용은 Amazon CloudWatch Logs 사용 설명서의 로그 그룹 및 로그 스트림 작업을 참조하십시오.

• Firehose 스트림 로그

  EventBridge Firehose 전송 스트림에 로그 레코드를 전달합니다.

  Amazon Data Firehose는 지원되는 타사 서비스 공급자가 소유한 사용자 지정 HTTP 엔드포인트 또는 HTTP 엔드포인트는 물론 특정 AWS 서비스와 같은 대상에 실시간 스트리밍 데이터를 전송하는 완전 관리형 서비스입니다. 자세한 내용은 Amazon Data Firehose 사용 설명서의 Amazon Data Firehose 전송 스트림 생성을 참조하십시오.

• Amazon S3 로그

  EventBridge 로그 레코드를 Amazon S3 객체로 지정된 버킷에 전달합니다.

  Amazon S3는 업계 최고의 확장성, 데이터 가용성, 보안 및 성능을 제공하는 객체 스토리지 서비스입니다. 자세한 내용은 Amazon Simple Storage Service 사용 설명서의 Amazon S3에서 객체 업로드, 다운로드 및 작업을 참조하세요.

Amazon EventBridge 파이프 로깅 작동 방식

파이프 실행은 파이프가 수신하여 보강 및/또는 대상으로 이동하는 이벤트 또는 이벤트 배치입니다. 활성화된 경우, 이벤트 배치가 처리될 때 수행하는 각 실행 단계에 대한 로그 레코드를 EventBridge 생성합니다. 레코드에 포함된 정보는 이벤트 배치(단일 이벤트 또는 최대 10,000개 이벤트)에 적용됩니다.

파이프 소스 및 대상에서 이벤트 배치 크기를 구성할 수 있습니다. 자세한 정보는 Amazon EventBridge Pipes 일괄 처리 및 동시성을 참조하세요.

각 로그 대상으로 전송되는 레코드 데이터는 동일합니다.

Amazon CloudWatch Logs 대상이 구성된 경우 모든 대상으로 전송되는 로그 레코드의 한도는 256kb입니다. 필요에 따라 필드가 잘립니다.

다음과 같은 방법으로 선택한 로그 대상으로 레코드 EventBridge 전송을 사용자 지정할 수 있습니다.

• 선택한 로그 대상으로 레코드를 EventBridge 전송하는 실행 단계를 결정하는 로그 수준을 지정할 수 있습니다. 자세한 정보는 EventBridge 파이프 로그 수준 지정을 참조하세요.

• EventBridge 파이프가 관련 있는 실행 단계의 레코드에 실행 데이터를 포함할지 여부를 지정할 수 있습니다. 이 데이터에는 다음이 포함됩니다.

  • 이벤트 배치의 페이로드

  • AWS 인리치먼트 또는 대상 서비스에 전송된 요청

  • AWS 강화 또는 대상 서비스에서 반환한 응답

  자세한 정보는 EventBridge Pipes 로그에 실행 데이터 포함을 참조하세요.

EventBridge 파이프 로그 수준 지정

선택한 로그 대상으로 레코드를 EventBridge 전송하는 실행 단계 유형을 지정할 수 있습니다.

로그 레코드에 포함할 세부 정보 수준을 다음 중에서 선택합니다. 로그 수준은 파이프에 지정된 모든 로그 대상에 적용됩니다. 각 로그 수준에는 이전 로그 수준의 실행 단계가 포함됩니다.

• 끄기 - 지정된 로그 대상으로 레코드를 보내지 EventBridge 않습니다. 이것이 기본 설정입니다.

• 오류 — 파이프 실행 중에 생성된 오류와 관련된 모든 레코드를 지정된 로그 대상으로 EventBridge 보냅니다.

• 정보 — 오류와 관련된 모든 레코드와 파이프 실행 중에 수행된 다른 단계를 선택하여 지정된 로그 대상으로 EventBridge 전송합니다.

• TRACE — 파이프 실행의 모든 단계에서 생성된 모든 레코드를 지정된 로그 대상으로 EventBridge 보냅니다.

EventBridge 콘솔에서는 기본적으로 CloudWatch 로그 수준과 마찬가지로 로그가 ERROR 로그 대상으로 선택됩니다. 따라서 EventBridge Pipes는 기본적으로 세부 ERROR 수준이 포함된 로그 레코드를 보내는 새 CloudWatch 로그 그룹을 생성합니다. 프로그래밍 방식으로 로그를 구성할 때는 기본값이 선택되지 않습니다.

아래는 각 로그 수준에 포함된 실행 단계를 나타낸 표입니다.

단계	TRACE	INFO	ERROR	OFF
실행 실패	x	x	x
실행 부분적으로 실패	x	x	x
실행 시작됨	x	x
실행 성공	x	x
실행 제한됨	x	x	x
실행 제한 시간	x	x	x
보강 간접 호출 실패	x	x	x
보강 간접 호출 건너뜀	x	x
보강 간접 호출 시작됨	x
보강 간접 호출 성공	x
보강 단계 진입	x	x
보강 단계 실패	x	x	x
보강 단계 성공	x	x
보강 변환 실패	x	x	x
보강 변환 시작	x
보강 변환 성공	x
대상 간접 호출 실패	x	x	x
대상 간접 호출 부분 실패	x	x	x
대상 간접 호출 건너뜀	x
대상 간접 호출 시작됨	x
대상 간접 호출 성공	x
대상 단계 진입	x	x
대상 단계 실패	x	x	x
대상 단계 부분 실패	x	x	x
대상 단계 건너뜀	x
대상 단계 성공	x	x
대상 변환 실패	x	x	x
대상 변환 시작됨	x
대상 변환 성공	x

EventBridge Pipes 로그에 실행 데이터 포함

생성되는 레코드에 실행 데이터를 EventBridge 포함하도록 형식을 지정할 수 있습니다. 실행 데이터에는 이벤트 배치 페이로드를 나타내는 필드는 물론 보강 및 대상으로 전송된 요청 및 응답이 포함됩니다.

실행 데이터는 문제 해결 및 디버깅에 유용합니다. 이 payload 필드에는 배치에 포함된 각 이벤트의 실제 내용이 포함되므로 개별 이벤트를 특정 파이프 실행과 연관시킬 수 있습니다.

실행 데이터를 포함하도록 선택하면 파이프에 지정된 모든 로그 대상에 해당 데이터가 포함됩니다.

중요

이러한 필드에는 민감한 정보가 포함될 수 있습니다. EventBridge 로깅 중에는 이러한 필드의 내용을 삭제하려고 시도하지 않습니다.

실행 데이터를 포함할 때 관련 레코드에 다음 필드를 EventBridge 추가합니다.

• payload

  파이프에서 처리 중인 이벤트 배치의 내용을 나타냅니다.

  EventBridge 이벤트 배치 콘텐츠가 업데이트되었을 수 있는 단계에서 생성된 레코드에 payload 필드를 포함합니다. 여기에는 다음 단계가 포함됩니다.

  • EXECUTION_STARTED

  • ENRICHMENT_TRANSFORMATION_SUCCEEDED

  • ENRICHMENT_STAGE_SUCCEEDED

  • TARGET_TRANSFORMATION_SUCCEEDED

  • TARGET_STAGE_SUCCEEDED

• awsRequest

  보강 또는 대상에 전송된 요청을 JSON 문자열로 나타냅니다. API 대상으로 전송된 요청의 경우 이는 해당 엔드포인트로 전송된 HTTP 요청을 나타냅니다.

  EventBridge 보강 및 타깃팅의 최종 단계, 즉 지정된 보강 또는 대상 서비스에 대해 요청을 실행하거나 실행을 시도한 후 EventBridge 생성된 레코드에 awsRequest 필드를 포함합니다. 여기에는 다음 단계가 포함됩니다.

  • ENRICHMENT_INVOCATION_FAILED

  • ENRICHMENT_INVOCATION_SUCCEEDED

  • TARGET_INVOCATION_FAILED

  • TARGET_INVOCATION_PARTIALLY_FAILED

  • TARGET_INVOCATION_SUCCEEDED

• awsResponse

  보강 또는 대상이 반환한 응답을 JSON 형식으로 나타냅니다. API 대상으로 전송된 요청의 경우 이는 해당 엔드포인트에서 반환된 HTTP 응답을 나타냅니다.

  와 마찬가지로awsRequest, 보강 및 대상 서비스의 최종 단계에서 생성된 레코드, 즉 지정된 보강 또는 대상 서비스에 대해 요청을 실행하거나 실행을 시도한 후 응답을 EventBridge 받은 후에 생성된 레코드에 awsResponse 필드를 EventBridge 포함합니다. 여기에는 다음 단계가 포함됩니다.

  • ENRICHMENT_INVOCATION_FAILED

  • ENRICHMENT_INVOCATION_SUCCEEDED

  • TARGET_INVOCATION_FAILED

  • TARGET_INVOCATION_PARTIALLY_FAILED

  • TARGET_INVOCATION_SUCCEEDED

파이프 실행 단계에 대한 설명은 EventBridge 파이프 실행 단계 단원을 참조하세요.

Pipes 로그 레코드의 실행 데이터 잘라내기 EventBridge

파이프의 로그 레코드에 실행 데이터를 EventBridge 포함하도록 선택하면 레코드가 256KB 크기 제한을 초과할 수 있습니다. 이를 방지하기 위해 는 다음과 같은 순서로 실행 데이터 필드를 EventBridge 자동으로 잘라냅니다. EventBridge 다음 필드를 잘라내기 전에 각 필드를 완전히 잘라냅니다. EventBridge 데이터 문자열 끝에서 문자를 제거하기만 하면 필드 데이터를 자릅니다. 데이터 중요도에 따라 자르려고 시도하지 않으며 잘라내면 JSON 형식이 무효화됩니다.

• payload

• awsRequest

• awsResponse

이벤트에서 EventBridge 필드가 잘리는 경우 잘린 데이터 필드 목록이 필드에 포함됩니다. truncatedFields

파이프 로그 레코드의 오류 보고 EventBridge

EventBridge 또한 오류 상태를 나타내는 파이프 실행 단계에 가능한 경우 오류 데이터를 포함합니다. 이러한 단계는 다음과 같습니다.

• ExecutionThrottled

• ExecutionTimeout

• ExecutionFailed

• ExecutionPartiallyFailed

• EnrichmentTransformationFailed

• EnrichmentInvocationFailed

• EnrichmentStageFailed

• TargetTransformationFailed

• TargetInvocationFailed

• TargetInvocationPartiallyFailed

• TargetStageFailed

• TargetStagePartiallyFailed