HTTP API에 대한 지표 작업 - Amazon API Gateway

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

HTTP API에 대한 지표 작업

API Gateway에서 원시 데이터를 수집하고 읽기 가능한 실시간에 가까운 지표로 처리하는 CloudWatch를 사용하여 API 실행을 모니터링할 수 있습니다. 이러한 통계는 15개월 간 기록되므로 기록 정보에 액세스하고 웹 애플리케이션이나 서비스가 어떻게 수행되고 있는지 전체적으로 더 잘 파악할 수 있습니다. 기본적으로 API Gateway 지표 데이터는 1분 간격으로 CloudWatch로 자동 전송됩니다. 지표를 모니터링하려면 API용 CloudWatch 대시보드를 만드세요. CloudWatch 대시보드를 만드는 방법에 대한 자세한 내용은 Amazon CloudWatch 사용 설명서에서 CloudWatch 대시보드 생성을 참조하세요. 자세한 내용은 Amazon CloudWatch 사용 설명서Amazon CloudWatch란 무엇입니까?를 참조하십시오.

HTTP API에서는 다음과 같은 지표가 지원됩니다. 또한 세부 지표를 활성화하여 경로 수준 지표를 Amazon CloudWatch에 쓸 수도 있습니다.

측정치 설명
4xx 지정한 기간 내에 캡처된 클라이언트 측 오류 수
5xx 지정한 기간 내에 캡처된 서버 측 오류 수.
개수 지정된 기간 동안의 총 API 요청 수.
IntegrationLatency API Gateway가 요청을 백엔드로 릴레이할 때부터 백엔드에서 응답을 수신할 때까지의 시간입니다.
Latency API Gateway가 클라이언트에서 요청을 수신할 때부터 클라이언트에게 응답을 반환할 때까지의 시간입니다. 지연 시간에는 통합 지연 시간과 기타 API Gateway 오버헤드가 포함됩니다.
DataProcessed 처리된 데이터의 양(바이트)입니다.

다음 표의 차원을 사용하여 API Gateway 지표를 필터링할 수 있습니다.

차원 설명
ApiId 지정한 API ID를 사용하여 API에 대한 API Gateway 지표를 필터링합니다.
ApiId, 스테이지 지정한 API ID와 스테이지 ID를 사용하여 API 스테이지에 대한 API Gateway 지표를 필터링합니다.
ApiId, 스테이지, 라우팅

지정한 API ID, 스테이지 ID 및 라우팅 ID를 사용하여 API 메서드에 대한 API Gateway 지표를 필터링합니다.

사용자가 세부 CloudWatch 지표를 명시적으로 활성화하지 않으면 API Gateway는 이러한 지표를 전송하지 않습니다. API Gateway V2 REST API의 UpdateStage 작업을 호출하여 detailedMetricsEnabled 속성을 true로 업데이트하면 됩니다. 또는 update-stage AWS CLI 명령을 호출하여 DetailedMetricsEnabled 속성을 true로 업데이트할 수 있습니다. 이러한 지표를 활성화할 경우 계정에 추가 비용이 발생합니다. 요금에 대한 자세한 내용은 Amazon CloudWatch 요금을 참조하십시오.