# API Gateway에서 X-Ray를 사용하여 REST API에 대한 사용자 요청 추적
<a name="apigateway-xray"></a>

[AWS X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-services-apigateway.html)를 사용하여 Amazon API Gateway REST API를 통해 기본 서비스로 이동하는 사용자 요청을 추적하고 분석할 수 있습니다. API Gateway는 모든 API Gateway REST API 엔드포인트 유형(리전, 엣지 최적화, 프라이빗)에 대해 X-Ray 추적을 지원합니다. X-Ray를 사용할 수 있는 모든 AWS 리전에서 Amazon API Gateway와 함께 X-Ray를 사용할 수 있습니다.

X-Ray는 전체 요청에 대한 엔드 투 엔드 보기를 제공하므로 API와 백엔드 서비스에서 지연 시간을 분석할 수 있습니다. X-Ray 서비스 맵을 사용하여 전체 요청의 지연 시간과 X-Ray와 통합되는 다운스트림 서비스의 지연 시간을 볼 수 있습니다. 또한 샘플링 규칙을 구성하여 지정한 기준에 따라 어떤 요청을 어떤 샘플링 속도로 기록할지를 X-Ray에 지정할 수도 있습니다.

이미 추적 중인 서비스에서 API Gateway API를 호출하면, API에서 X-Ray 추적을 활성화하지 않더라도 API Gateway가 추적을 전달합니다.

API Gateway 콘솔을 사용하거나 API Gateway API 또는 CLI를 사용하여 API 단계에 대해 X-Ray를 활성화할 수 있습니다.

**Topics**
+ [API Gateway REST API를 사용하여 AWS X-Ray 설정](apigateway-enabling-xray.md)
+ [API Gateway에서 AWS X-Ray 서비스 맵 및 추적 보기 사용](apigateway-using-xray-maps.md)
+ [API Gateway API에 대한 AWS X-Ray 샘플링 규칙 구성](apigateway-configuring-xray-sampling-rules.md)
+ [Amazon API Gateway API에 대한 AWS X-Ray 추적](apigateway-understanding-xray-traces.md)