내용으로 건너뛰기

API Gateway 확장 요청 ID를 수집하려면 어떻게 해야 합니까?

1분 분량
0

Amazon API Gateway 확장 요청 ID를 수집하고 싶습니다.

해결 방법

확장 요청 ID를 수집하려면 액세스 로그 레코드, 실행 로그 레코드 또는 HTTP 응답 헤더를 확인하십시오.

로깅 구성

API에 대한 로깅을 설정하지 않은 경우 API Gateway에서 HTTP API에 대한 로깅 구성API Gateway에서 REST API에 대한 CloudWatch 로깅 설정을 참조하십시오.

참고: 확장 요청 ID를 캡처하려면 액세스 로깅을 활성화해야 합니다. 액세스 로그는 실행 로깅에 도달하지 못한 요청을 캡처할 수 있습니다.

액세스 로그 레코드 확인

액세스 로그 레코드를 확인하면 누가 어떻게 API에 액세스했는지 확인할 수 있습니다. 액세스 로그에서 요청 ID를 확인하려면 로그 콘텐츠를 사용자 지정할 때 context.extendedRequestId 컨텍스트 변수를 포함하십시오.

실행 로그 레코드 확인

API Gateway에서 관리하는 실행 로그에서 확장 요청 ID를 확인할 수 있습니다.

확장 요청 ID는 다음 형식 중 하나로 표시됩니다.

  • 로그 그룹 형식: API-Gateway-Execution-Logs_{rest-api-id}/{stage_name}
  • 확장 요청 ID 형식: "XxxXXXxx="

HTTP 응답 헤더 확인

API 응답 헤더에서 확장 요청 ID를 찾을 수 있습니다.

예를 들어 verbose 플래그(-v)를 사용하여 다음 curl 명령을 실행합니다.

curl -v GET https://your-api-id.execute-api.region.amazonaws.com/stage/resource

응답에 다음과 같은 헤더가 표시됩니다.

x-amz-apigw-id: XxxXXXxx=