Amazon CloudWatch API를 사용하여 지표 가져오기
CloudWatch API 또는 AWS Command Line Interface(AWS CLI)를 사용하여, 빌드한 프로그램이나 애플리케이션의 CloudFront 지표를 가져올 수 있습니다. 원시 데이터를 사용하여 사용자 지정 대시보드, 사용자 고유의 경고 도구 등을 만들 수 있습니다.
자세한 내용은 AWS CLI 명령 참조의 get-metric-data 또는 Amazon CloudWatch API 참조의 GetMetricData API 작업을참조하세요.
참고
CloudWatch API에서 CloudFront 지표를 가져오려면 미국 동부(버지니아 북부) 리전(us-east-1)을 사용해야 합니다. 또한 각 지표의 특정 값과 유형을 알아야 합니다.
모든 CloudFront 지표에 대한 값
다음 값은 모든 CloudFront 지표에 적용됩니다.
Namespace-
Namespace의 값은 항상AWS/CloudFront입니다. - Dimensions
-
각 CloudFront 지표에는 다음의 차원이 있습니다.
DistributionId-
지표를 가져오려는 CloudFront 배포의 ID입니다.
FunctionName-
(CloudFront 함수에서) 지표를 가져오려는 함수 이름입니다.
이 차원은 함수에만 적용됩니다.
Region-
Region의 값은 항상Global입니다. CloudFront는 글로벌 서비스이기 때문입니다.
CloudFront 배포 지표에 대한 값
다음 목록의 정보를 사용하여 CloudWatch API에서 특정 CloudFront 배포 지표에 대한 세부 정보를 얻을 수 있습니다. 이러한 지표 중 일부는 배포에 대한 추가 지표를 활성화한 경우에만 사용할 수 있습니다.
참고
각 지표에 대해 하나의 통계, Average 또는 Sum만 적용할 수 있습니다. 다음 목록은 해당 지표에 적용할 수 있는 통계를 지정합니다.
- 4xx 오류 발생률
-
응답의 HTTP 상태 코드가
4xx인 모든 최종 사용자 요청의 백분율입니다.-
지표 이름:
4xxErrorRate -
유효한 통계:
Average -
단위:
Percent
-
- 401 오류 발생률
-
응답의 HTTP 상태 코드가
401인 모든 최종 사용자 요청의 백분율입니다. 이 지표를 가져오려면 먼저 추가 지표를 활성화해야 합니다.-
지표 이름:
401ErrorRate -
유효한 통계:
Average -
단위:
Percent
-
- 403 오류 발생률
-
응답의 HTTP 상태 코드가
403인 모든 최종 사용자 요청의 백분율입니다. 이 지표를 가져오려면 먼저 추가 지표를 활성화해야 합니다.-
지표 이름:
403ErrorRate -
유효한 통계:
Average -
단위:
Percent
-
- 404 오류 발생률
-
응답의 HTTP 상태 코드가
404인 모든 최종 사용자 요청의 백분율입니다. 이 지표를 가져오려면 먼저 추가 지표를 활성화해야 합니다.-
지표 이름:
404ErrorRate -
유효한 통계:
Average -
단위:
Percent
-
- 5xx 오류 발생률
-
응답의 HTTP 상태 코드가
5xx인 모든 최종 사용자 요청의 백분율입니다.-
지표 이름:
5xxErrorRate -
유효한 통계:
Average -
단위:
Percent
-
- 502 오류 발생률
-
응답의 HTTP 상태 코드가
502인 모든 최종 사용자 요청의 백분율입니다. 이 지표를 가져오려면 먼저 추가 지표를 활성화해야 합니다.-
지표 이름:
502ErrorRate -
유효한 통계:
Average -
단위:
Percent
-
- 503 오류 발생률
-
응답의 HTTP 상태 코드가
503인 모든 최종 사용자 요청의 백분율입니다. 이 지표를 가져오려면 먼저 추가 지표를 활성화해야 합니다.-
지표 이름:
503ErrorRate -
유효한 통계:
Average -
단위:
Percent
-
- 504 오류 발생률
-
응답의 HTTP 상태 코드가
504인 모든 최종 사용자 요청의 백분율입니다. 이 지표를 가져오려면 먼저 추가 지표를 활성화해야 합니다.-
지표 이름:
504ErrorRate -
유효한 통계:
Average -
단위:
Percent
-
- 다운로드된 바이트
-
GET,HEAD,OPTIONS요청에 대해 최종 사용자가 다운로드한 총 바이트 수입니다.-
지표 이름:
BytesDownloaded -
유효한 통계:
Sum -
단위:
None
-
- 업로드된 바이트
-
최종 사용자가
POST및PUT요청을 사용하여 오리진에 CloudFront와 함께 업로드한 총 바이트 수입니다.-
지표 이름:
BytesUploaded -
유효한 통계:
Sum -
단위:
None
-
- 캐시 적중률
-
CloudFront가 캐시에서 콘텐츠를 제공하는 캐시 가능한 모든 요청의 비율입니다. HTTP
POST및PUT요청, 오류는 캐시 가능한 요청으로 간주되지 않습니다. 이 지표를 가져오려면 먼저 추가 지표를 활성화해야 합니다.-
지표 이름:
CacheHitRate -
유효한 통계:
Average -
단위:
Percent
-
- 오리진 지연 시간
-
CloudFront에서 요청을 수신한 시점부터 CloudFront 캐시가 아닌 오리진에서 제공되는 요청에 대해 네트워크(최종 사용자 아님)에 대한 응답을 제공하기 시작하는 시점까지 소요되는 총 시간(밀리초)입니다. 이것을 첫 번째 바이트 대기 시간 또는 time-to-first-byte라고도 합니다. 이 지표를 가져오려면 먼저 추가 지표를 활성화해야 합니다.
-
지표 이름:
OriginLatency -
유효한 통계:
Percentile -
단위:
Milliseconds
참고
CloudWatch API에서
Percentile통계를 확인하려면ExtendedStatistics가 아닌Statistics파라미터를 사용합니다. 자세한 내용은 Amazon CloudWatch API 참조의 GetMetricStatistics 또는 AWS SDK 관련 참조 설명서를 참조하세요. -
- 요청
-
모든 HTTP 메서드와 HTTP 및 HTTPS 요청에 대해 CloudFront에서 수신한 최종 사용자 요청의 총 수입니다.
-
지표 이름:
Requests -
유효한 통계:
Sum -
단위:
None
-
- 총 오류 발생률
-
응답의 HTTP 상태 코드가
4xx또는5xx인 모든 최종 사용자 요청의 백분율입니다.-
지표 이름:
TotalErrorRate -
유효한 통계:
Average -
단위:
Percent
-
CloudFront 함수 지표에 대한 값
다음 목록의 정보를 사용하여 CloudWatch API에서 특정 CloudFront 함수 지표에 대한 세부 정보를 얻을 수 있습니다.
참고
각 지표에 대해 하나의 통계, Average 또는 Sum만 적용할 수 있습니다. 다음 목록은 해당 지표에 적용할 수 있는 통계를 지정합니다.
- 호출
-
지정된 기간 동안 함수가 시작된(호출된) 횟수입니다.
-
지표 이름:
FunctionInvocations -
유효한 통계:
Sum -
단위:
None
-
- 유효성 검사 오류
-
지정된 기간 동안 함수에서 생성된 유효성 검사 오류의 수입니다. 유효성 검사 오류는 함수가 성공적으로 실행되지만 잘못된 데이터(잘못된 이벤트 객체)를 반환할 때 발생합니다.
-
지표 이름:
FunctionValidationErrors -
유효한 통계:
Sum -
단위:
None
-
- 실행 오류
-
지정된 기간 동안 발생한 실행 오류의 수입니다. 함수가 성공적으로 완료되지 않을 때 실행 오류가 발생합니다.
-
지표 이름:
FunctionExecutionErrors -
유효한 통계:
Sum -
단위:
None
-
- 컴퓨팅 사용률
-
함수가 실행되는 데 걸린 시간(0~100)의 최대 허용 시간의 백분율입니다. 예를 들어, 값이 35이면 함수가 최대 허용 시간의 35%에서 완료되었음을 의미합니다.
-
지표 이름:
FunctionComputeUtilization -
유효한 통계:
Average -
단위:
Percent
-
- 제한
-
지정된 기간 동안 함수가 제한된 횟수입니다.
-
지표 이름:
FunctionThrottles -
유효한 통계:
Sum -
단위:
None
-
