

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

# X-Ray 트레이스 맵 사용
<a name="xray-console-servicemap"></a>

X-Ray 트레이스 맵을 보고 오류가 발생한 서비스, 지연 시간이 긴 연결 또는 실패한 요청에 대한 트레이스를 식별할 수 있습니다.

**참고**  
 이제 CloudWatch에 애플리케이션 서비스, 클라이언트, Synthetics Canary 및 서비스 종속성을 검색하고 모니터링할 수 있는 [Application Signals](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Application-Monitoring-Sections.html)가 포함됩니다. Application Signals를 사용하여 서비스의 목록 또는 시각적 맵을 확인하고, 서비스 수준 목표(SLO)를 기준으로 상태 지표를 확인하고, 더 자세한 문제 해결을 위해 상관관계가 있는 X-Ray 트레이스를 드릴다운할 수 있습니다.  
X-Ray 서비스 맵과 CloudWatch ServiceLens 맵은 Amazon CloudWatch 콘솔 내의 X-Ray 트레이스 맵에 결합됩니다. [CloudWatch 콘솔](https://console.aws.amazon.com/cloudwatch/)을 열고 왼쪽 탐색 창의 **X-Ray 트레이스**에서 **트레이스 맵**을 선택합니다.

## 추적 맵 보기
<a name="xray-console-servicemap-view"></a>

트레이스 맵은 애플리케이션에서 생성되는 트레이스 데이터를 시각적으로 표현한 것입니다. 맵에는 요청을 처리하는 서비스 노드, 요청의 출처를 나타내는 업스트림 클라이언트 노드, 요청을 처리하는 동안 애플리케이션에서 사용하는 웹 서비스 및 리소스를 나타내는 다운스트림 서비스 노드가 표시됩니다.

트레이스 맵은 Amazon SQS 및 Lambda를 사용하는 이벤트 기반 애플리케이션 전반의 트레이스에 대한 연관성을 표시합니다. 자세한 내용은 [이벤트 중심 애플리케이션 트레이싱](xray-tracelinking.md)을 참조하세요. 또한 트레이스 맵은 [교차 계정 추적](xray-console-crossaccount.md)을 지원하여 여러 계정의 노드를 단일 맵에 표시합니다.

------
#### [ CloudWatch console ]

**CloudWatch 콘솔에서 트레이스 맵을 보려면**

1. [CloudWatch 콘솔을 엽니다](https://console.aws.amazon.com/cloudwatch/). 왼쪽 탐색 창의 **X-Ray 트레이스** 섹션에서 **트레이스 맵**을 선택합니다.  
![\[CloudWatch 콘솔 트레이스 맵 페이지\]](http://docs.aws.amazon.com/ko_kr/xray/latest/devguide/images/console-servicemap-cw.png)

1. 노드에 대한 요청을 보려는 서비스 노드 또는 그 사이를 이동하는 요청을 보려는 두 노드 간 에지를 선택합니다.

1.  트레이스 맵 아래에 지표, 알림 및 응답 시간 분포에 대한 탭을 비롯한 추가 정보가 표시됩니다. **지표** 탭에서 각 그래프 내 범위를 선택하여 드릴다운하여 자세한 내용을 보거나, **결함** 또는 **오류** 옵션을 선택하여 트레이스를 필터링합니다. **응답 시간 분포** 탭에서 그래프 내의 범위를 선택하여 응답 시간별로 추적을 필터링합니다.  
![\[Dashboard showing latency, requests, and faults metrics for an ElasticBeanstalk environment.\]](http://docs.aws.amazon.com/ko_kr/xray/latest/devguide/images/console-cw-servicemap-node-detail.png)

1. **트레이스 보기**를 선택하여 트레이스를 보거나, 필터가 적용된 경우 **필터링된 트레이스 보기**를 선택합니다.

1.  선택한 노드와 관련된 CloudWatch 로그를 보려면 **로그 보기** 를 선택합니다. 모든 트레이스 맵 노드가 로그 보기를 지원하는 것은 아닙니다. 자세한 내용은 [CloudWatch 로그 문제 해결](xray-troubleshooting.md#xray-troubleshooting-Nologs)을 참조하세요.

트레이스 맵은 각 노드 내의 문제를 색상별로 표시합니다.
+ **빨간색**은 서버 장애를 의미합니다(500 시리즈 오류)
+ **노란색**은 클라이언트 오류를 의미합니다(400 시리즈 오류)
+ **보라색**은 병목 오류를 의미합니다(429 요청 과다)

트레이스 맵이 큰 경우 화면의 컨트롤이나 마우스를 사용하여 맵을 확대/축소하거나 이동할 수 있습니다.

------
#### [ X-Ray console ]

**서비스 맵을 보려면**

1. [X-Ray 콘솔](https://console.aws.amazon.com/xray/home#)을 엽니다. 기본적으로 서비스 맵이 표시됩니다. 왼쪽 탐색 창에서 **서비스 맵**을 선택할 수도 있습니다.  
![\[X-Ray 콘솔 서비스 맵 페이지\]](http://docs.aws.amazon.com/ko_kr/xray/latest/devguide/images/console-servicemap-xray.png)

1. 노드에 대한 요청을 보려는 서비스 노드 또는 그 사이를 이동하는 요청을 보려는 두 노드 간 에지를 선택합니다.

1. 응답 분포 [히스토그램](xray-console-histograms.md)을 사용하여 트레이스를 기간별로 필터링하고 트레이스를 보려는 상태 코드를 선택합니다. 그런 다음 [**View traces**]를 선택하여 필터 표현식이 적용된 트레이스 목록을 엽니다.  
![\[Response distribution graph showing latency peaks and service details for Scorekeep AWS ECS container.\]](http://docs.aws.amazon.com/ko_kr/xray/latest/devguide/images/console-servicemap-nodedetail-xray.png)

이 서비스는 오류 및 장애 호출 성공 비율을 토대로 각 노드의 색상을 다르게 표시해 노드의 상태를 보여줍니다:
+ **녹색**은 성공적인 호출을 의미합니다
+ **빨간색**은 서버 장애를 의미합니다(500 시리즈 오류)
+ **노란색**은 클라이언트 오류를 의미합니다(400 시리즈 오류)
+ **보라색**은 병목 오류를 의미합니다(429 요청 과다)

서비스 맵이 큰 경우 화면의 컨트롤이나 마우스를 사용하여 맵을 확대/축소하거나 이동할 수 있습니다.

------

**참고**  
X-Ray 트레이스 맵에는 최대 10,000개의 노드가 표시될 수 있습니다. 드물지만 총 서비스 노드 수가 이 한도를 초과할 경우 오류가 발생하여 콘솔에 전체 트레이스 맵이 표시되지 않을 수 있습니다.

## 그룹으로 트레이스 맵 필터링
<a name="xray-console-servicemap-groups"></a>

[필터 표현식](xray-console-filters.md)을 사용하여 그룹에 트레이스를 허용하는 기준을 정의할 수 있습니다. 다음 단계에 따라 트레이스 맵에 해당 특정 그룹을 표시합니다.

------
#### [ CloudWatch console ]

트레이스 맵의 왼쪽 상단에 있는 그룹 필터에서 그룹 이름을 선택합니다.

![\[Search bar for filtering by X-Ray group, with "TestGroup" displayed as an option.\]](http://docs.aws.amazon.com/ko_kr/xray/latest/devguide/images/console-servicemap-groups-cw.png)


------
#### [ X-Ray console ]

검색 창 왼쪽에 있는 드롭다운 메뉴에서 그룹 이름을 선택합니다.

![\[Drop-down menu showing Default, TestGroup, Create group, and Learn more options.\]](http://docs.aws.amazon.com/ko_kr/xray/latest/devguide/images/group-select-console.png)


------

이제 서비스 맵이 필터링되어 선택한 그룹의 필터 표현식과 일치하는 추적을 표시합니다.

## 트레이스 맵 범례 및 옵션
<a name="xray-console-servicemap-options"></a>

트레이스 맵에는 범례와 맵 표시를 사용자 지정할 수 있는 몇 가지 옵션이 포함되어 있습니다.

------
#### [ CloudWatch console ]

지도 오른쪽 상단의 **범례 및 옵션** 드롭다운을 선택합니다. 다음을 포함하여 노드 내에 표시할 항목을 선택합니다:
+  **지표는** 선택한 시간 범위 동안 분당 평균 응답 시간과 전송된 추적 횟수를 표시합니다.
+  **노드는** 각 노드 내의 서비스 아이콘이 표시됩니다.

 맵 오른쪽 상단의 톱니바퀴 아이콘을 통해 액세스할 수 있는 **기본 설정** 창에서 추가 맵 설정을 선택합니다. 이러한 설정에는 각 노드의 크기를 결정하는 데 사용되는 메트릭과 맵에 표시할 카나리아를 선택하는 것이 포함됩니다.

------
#### [ X-Ray console ]

맵 오른쪽 상단의 맵 레전드 링크를 선택하여 서비스 **맵 범례**를 표시합니다. 서비스 맵 오른쪽 하단에서 다음을 포함한 트레이스 맵 옵션을 선택할 수 있습니다.
+  **서비스 아이콘**은 각 노드 내에 표시되는 내용을 전환하여 서비스 아이콘 또는 선택한 시간 범위 동안 분당 평균 응답 시간 및 전송된 추적 횟수를 표시합니다.
+  **노드 크기 조정: 없음**은 모든 노드의 크기를 동일하게 설정합니다.
+  **노드 크기 조정: Health**는 오류, 결함 또는 병목 현상이 발생한 요청을 포함하여 영향을 받는 요청 수를 기준으로 노드 크기를 조정합니다.
+  **노드 크기 조정: 트래픽** 총 요청 수를 기준으로 노드의 크기를 조정합니다.

------