API Gateway에서 AWS X-Ray 서비스 맵 및 추적 보기 사용

이 단원에는 API Gateway로 AWS X-Ray 서비스 맵 및 트레이스 보기를 사용하는 방법에 대한 자세한 정보가 나와 있습니다.

X-Ray 서비스 맵 예제

AWS X-Ray 서비스 맵은 API 및 그 다운스트림 서비스에 대한 정보를 보여줍니다. API Gateway에서 API 단계에 대해 X-Ray를 활성화하면 API Gateway 서비스에 사용된 전체 시간에 대한 정보를 포함하여 서비스 맵에 노드가 표시됩니다. 선택된 일정에 대한 API 응답 시간의 응답 상태 및 히스토그램에 대한 자세한 정보를 가져올 수 있습니다. AWS Lambda 및 Amazon DynamoDB와 같은 AWS 서비스와 통합하는 API의 경우, 이러한 서비스와 관련된 성능 지표를 제공하는 추가 노드가 표시됩니다. 각 API 단계에 대한 서비스 맵이 부여됩니다.

다음 예제는 test라는 API의 xray 단계에 대한 서비스 맵을 보여 줍니다. 이 API에는 Lambda 권한 부여자 함수 및 Lambda 백엔드 함수를 포함한 Lambda 통합이 있습니다. 노드는 API Gateway 서비스, Lambda 서비스 및 두 개의 Lambda 함수를 나타냅니다.

서비스 맵 구조에 대한 자세한 설명은 X-Ray 추적 맵 사용을 참조하세요.

서비스 맵에서 API 단계의 트레이스 보기를 확대하여 볼 수 있습니다. 트레이스는 세그먼트 및 하위 세그먼트로 표현된 API와 관련된 세부 정보를 표시합니다. 예를 들어, 위에 표시된 서비스 맵에 대한 추적에는 Lambda 서비스 및 Lambda 함수에 대한 세그먼트가 포함됩니다. 자세한 내용은 AWS Lambda 및 AWS X-Ray 단원을 참조하세요.

X-Ray 서비스 맵에서 노드 또는 엣지를 선택하면 X-Ray 콘솔에 지연 시간 분포 히스토그램이 표시됩니다. 지연 시간 히스토그램을 사용하여 서비스에서 요청을 완료하는 데 소요되는 시간을 확인할 수 있습니다. 다음은 이전 서비스 맵에 있는 xray/test라는 API Gateway 단계의 히스토그램입니다. 지연 시간 분포 히스토그램에 대한 자세한 설명은 지연 시간 히스토그램 사용을 참조하세요.

X-Ray 추적 보기 예

다음 다이어그램에서는 Lambda 백엔드 함수 및 Lambda 권한 부여자 함수와 함께 위에서 설명한 예제 API에 대해 생성된 추적 보기를 보여 줍니다. 성공적인 API 메서드 요청이 200 응답 코드로 표시됩니다.

추적 보기에 대한 자세한 설명은 추적 및 추적 세부 정보 보기를 참조하세요.