

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

# 이벤트 기반 애플리케이션 추적
<a name="xray-tracelinking"></a>

AWS X-Ray는 Amazon SQS와 AWS Lambda를 사용하여 이벤트 기반 애플리케이션 추적을 지원합니다. CloudWatch 콘솔을 사용하면 각 요청이 Amazon SQS로 대기열에 추가되고 하나 이상의 Lambda 함수에 의해 처리될 때 연결된 보기를 볼 수 있습니다. 업스트림 메시지 생산자의 트레이스가 다운스트림 Lambda 함수의 트레이스에 자동으로 연결되므로 전체 애플리케이션을 종합적으로 파악할 수 있습니다.

**참고**  
각 추적 세그먼트는 최대 20개의 추적에 연결할 수 있으며, 추적에는 최대 100개의 링크가 포함될 수 있습니다. 특정 시나리오에서 추가 추적을 연결하면 [최대 추적 문서 크기](https://docs.aws.amazon.com/general/latest/gr/xray.html#limits_xray)를 초과하여 잠재적으로 불완전한 추적을 초래할 수 있습니다. 예를 들어 추적이 활성화된 Lambda 함수가 한 번의 간접 호출로 많은 SQS 메시지를 대기열에 전송하는 경우 이런 일이 발생할 수 있습니다. 이 문제가 발생하는 경우 X-Ray SDK를 사용하는 완화 방법을 사용할 수 있습니다. 자세한 내용은 [자바](https://github.com/aws/aws-xray-sdk-java#oversampling-mitigation), [Node.js](https://github.com/aws/aws-xray-sdk-node/tree/master/packages/core#oversampling-mitigation), [Python](https://github.com/aws/aws-xray-sdk-python#oversampling-mitigation), [Go](https://github.com/aws/aws-xray-sdk-go#oversampling-mitigation) 또는 [.NET용](https://github.com/aws/aws-xray-sdk-dotnet#oversampling-mitigation) X-Ray SDK를 참조하십시오.

## 트레이스 맵에서 연결된 트레이스 보기
<a name="xray-tracelinking-servicemap"></a>

[CloudWatch 콘솔](https://console.aws.amazon.com/cloudwatch/) 내의 **트레이스 맵** 페이지에서는 메시지 생산자의 트레이스가 Lambda 소비자의 트레이스에 연결된 트레이스 맵을 볼 수 있습니다. 이러한 링크는 Amazon SQS 노드와 다운스트림 Lambda 소비자 노드를 연결하는 점선 엣지와 함께 표시됩니다.

![Amazon SQS와 Lambda 노드 사이의 엣지](http://docs.aws.amazon.com/ko_kr/xray/latest/devguide/images/console-batch-servicemap-linkededge.png)


점선 엣지를 선택하면 *수신된 이벤트 기간* 히스토그램을 표시합니다. 이 히스토그램은 소비자가 수신한 이벤트 기간의 분포를 매핑합니다. 기간은 이벤트가 수신될 때마다 계산됩니다.

![수신된 이벤트 기간 히스토그램의 엣지.](http://docs.aws.amazon.com/ko_kr/xray/latest/devguide/images/console-servicemap-linkededgedetails-cw.png)


## 연결된 추적 세부 정보 보기
<a name="xray-tracelinking-tracedetails"></a>

**메시지 생산자, Amazon SQS 대기열 또는 람다 소비자로부터 전송된 추적 세부 정보를 확인합니다:**

1. **트레이스 맵**을 사용하여 메시지 생산자, Amazon SQS 또는 Lambda 소비자 노드를 선택합니다.

1. 노드 세부 정보 창에서 **추적 보기**를 선택하여 추적 목록을 표시합니다. CloudWatch 콘솔 내에서 **추적** 페이지로 직접 이동할 수도 있습니다.

1. 목록에서 특정 추적을 선택하면 추적 세부정보 페이지가 열립니다. 선택한 추적이 연결된 추적 집합의 일부인 경우 추적 세부정보 페이지에 메시지가 표시됩니다.  
![연결된 추적 세부 정보](http://docs.aws.amazon.com/ko_kr/xray/latest/devguide/images/console-batch-tracedetails-header.png)

트레이스 세부 정보 맵에는 현재 트레이스와 함께 업스트림 및 다운스트림에 연결된 트레이스가 표시되며, 각 트레이스의 경계를 나타내는 상자 안에 각 트레이스가 포함되어 있습니다. 현재 선택된 트레이스가 여러 업스트림 또는 다운스트림 트레이스에 연결되어 있는 경우, 연결된 업스트림 또는 다운스트림 트레이스 내의 노드가 스택되고 **트레이스 선택** 버튼이 표시됩니다.

![여러 개의 연결된 업스트림 트레이스](http://docs.aws.amazon.com/ko_kr/xray/latest/devguide/images/console-batch-tracedetails-tracemap.png)


트레이스 세부 정보 맵 아래에는 업스트림 및 다운스트림에 연결된 트레이스가 포함된 트레이스 세그먼트의 타임라인이 표시됩니다. 업스트림 또는 다운스트림에 연결된 트레이스가 여러 개 있는 경우 해당 세그먼트 세부 정보를 표시할 수 없습니다. 연결된 추적 세트 내의 단일 추적에 대한 세그먼트 세부 정보를 보려면 아래에 설명된 대로 [단일 추적을 선택](#xray-tracelinking-filterbatch)합니다.

![연결된 트레이스를 보여주는 세그먼트 타임라인](http://docs.aws.amazon.com/ko_kr/xray/latest/devguide/images/console-batch-tracedetails-timeline.png)


## 연결된 트레이스 세트 내에서 단일 트레이스 선택하기
<a name="xray-tracelinking-filterbatch"></a>

**연결된 트레이스 세트를 단일 트레이스에 필터링하여 타임라인에서 세그먼트 세부 정보를 확인할 수 있습니다.**

1. 트레이스 세부 정보 맵의 연결된 트레이스 아래에서 **트레이스 선택**을 선택합니다. 추적 목록이 표시됩니다.  
![연결된 추적 목록](http://docs.aws.amazon.com/ko_kr/xray/latest/devguide/images/console-batch-tracedetails-tracelist.png)

1. 트레이스 옆의 라디오 버튼을 선택하여 트레이스 세부 정보 맵에서 트레이스를 확인합니다.

1. 연결된 트레이스의 전체 세트를 보려면 **트레이스 선택 취소**를 선택합니다.  
![단일 연결 추적](http://docs.aws.amazon.com/ko_kr/xray/latest/devguide/images/console-batch-tracedetails-filteredbatch.png)