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

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

이 단원에서는 API Gateway에서 AWS X-Ray 서비스 맵 및 추적 보기를 사용하는 방법에 대한 자세한 내용을 알아볼 수 있습니다.

서비스 맵 및 추적 보기에 대한 자세한 내용과 서비스 맵 및 추적 보기를 해석하는 방법은 AWS X-Ray 콘솔을 참조하십시오.

X-Ray 서비스 맵 예제

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

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

서비스 맵 구조에 대한 자세한 설명은 서비스 맵 보기를 참조하십시오.


                API Gateway API 단계의 서비스 맵 예제

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

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


                API Gateway API 단계의 X-Ray 히스토그램

X-Ray 추적 보기 예

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

추적 보기에 대한 자세한 설명은 추적 보기를 참조하십시오.


                활성 추적이 활성화된 API Gateway