기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 와 Amazon EventBridge 통합 AWS X-Ray
<a name="eb-related-service-xray"></a>

 AWS X-Ray 를 사용하여 EventBridge를 통과하는 [이벤트를](eb-events.md) 추적할 수 있습니다. EventBridge는 대상 서비스가 추적, 분석 및 디버깅할 수 있도록 원본 추적 헤더를 [대상](eb-targets.md)에 전달합니다.

EventBridge는 추적 컨텍스트를 전달한 `PutEvents` 요청에서 이벤트가 발생한 경우에만 이벤트에 대한 추적 헤더를 전달할 수 있습니다. X-Ray는 타사 파트너, 예정된 이벤트 또는 [AWS 서비스에서](eb-events.md#eb-service-event) 발생한 이벤트를 추적하지 않으며 이러한 이벤트 소스는 X-Ray 서비스 맵에 표시되지 않습니다.

X-Ray는 추적 헤더의 유효성을 검사하고 유효하지 않은 추적 헤더는 삭제됩니다. 하지만 이벤트는 계속 처리됩니다.

**중요**  
간접 호출 대상에 전달된 이벤트에서는 추적 헤더를 사용할 수 **없습니다**.  
[이벤트 아카이브](eb-archive-event.md)가 있는 경우 아카이브된 이벤트에는 추적 헤더를 사용할 수 없습니다. 아카이브된 이벤트를 재생하는 경우 추적 헤더는 포함되지 않습니다.
[DLQ(Dead Letter Queue)](eb-rule-dlq.md)가 있는 경우 이벤트를 DLQ로 보내는 `SendMessage` 요청에 추적 헤더가 포함됩니다. `ReceiveMessage`를 사용하여 DLQ에서 이벤트(메시지)를 검색하는 경우 이벤트와 관련된 추적 헤더는 Amazon SQS 메시지 속성에 포함되지만 이벤트 메시지에는 포함되지 않습니다.

EventBridge 이벤트 노드가 소스 및 대상 서비스를 연결하는 방법에 대한 자세한 내용은 *AWS X-Ray 개발자 안내서*의 [X-Ray 서비스 맵에서 소스 및 대상 보기](https://docs.aws.amazon.com//xray/latest/devguide/xray-services-eventbridge.html#xray-services-eventbridge-service-map)를 참조하세요.

EventBridge를 통해 다음과 같은 추적 헤더 정보를 전달할 수 있습니다.
+ **기본 HTTP 헤더** — X-Ray SDK는 모든 간접 호출 대상의 `X-Amzn-Trace-Id` HTTP 헤더로 추적 헤더를 자동으로 채웁니다. 기본 HTTP 헤더에 대한 자세한 내용은 *AWS X-Ray 개발자 안내서*의 [추적 헤더](https://docs.aws.amazon.com//xray/latest/devguide/xray-concepts.html#xray-concepts-tracingheader)를 참조하세요.
+ **`TraceHeader` 시스템 속성** - `TraceHeader`는 X-Ray 추적 헤더를 대상으로 전달하기 위해 EventBridge에서 예약한 [PutEventsRequestEntry 속성](https://docs.aws.amazon.com//eventbridge/latest/APIReference/API_PutEventsRequestEntry.html)입니다. `PutEventsRequestEntry`도 사용하는 경우 `PutEventsRequestEntry`가 HTTP 추적 헤더를 재정의합니다.

**참고**  
추적 헤더는 `PutEventsRequestEntry` 이벤트 크기에 포함되지 않습니다. 자세한 내용은 [PutEvents 이벤트 항목 크기 계산](eb-putevents.md#eb-putevent-size) 단원을 참조하십시오.

 다음 동영상은 X-Ray와 EventBridge를 함께 사용하는 방법을 보여줍니다.