기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
API를 사용하여 지표 가져오기 CloudWatch
Amazon CloudWatch API 또는 CLI를 사용하여 빌드한 프로그램 또는 애플리케이션에서 CloudFront 메트릭을 가져올 수 있습니다. 원시 데이터를 사용하여 사용자 지정 대시보드, 사용자 고유의 경고 도구 등을 만들 수 있습니다.
CloudWatch API에서 CloudFront 지표를 가져오려면 미국 동부 (버지니아 북부) 지역 (us-east-1
) 을 사용해야 합니다. 또한 각 지표의 특정 값과 유형을 알아야 합니다.
모든 CloudFront 지표의 값
다음 값은 모든 CloudFront 지표에 적용됩니다.
Namespace
-
Namespace
의 값은 항상AWS/CloudFront
입니다. - 차원
-
각 CloudFront 지표에는 다음과 같은 두 가지 측정기준이 있습니다.
DistributionId
-
지표를 가져오려는 CloudFront 배포의 ID.
FunctionName
-
지표를 가져오려는 함수의 이름 ( CloudFront 함수 내).
이 차원은 함수에만 적용됩니다.
Region
-
Region
는 글로벌Global
서비스이므로 의 값은 항상 CloudFront 입니다.
참고
CloudWatch API에서 CloudFront 지표를 가져오려면 미국 동부 (버지니아 북부) 지역 (us-east-1) 을 사용해야 합니다.
배포 지표의 값 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
자세한 GetMetricStatistics내용은 Amazon CloudWatch API 참조 또는 AWSSDK에 대한 참조 설명서를 참조하십시오. -
- 요청
-
모든 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
-