View a markdown version of this page

CloudFront의 지표 유형 - Amazon CloudFront

CloudFront의 지표 유형

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입니다.

측정 기준

각 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 요청에 대해 뷰어가 다운로드한 총 바이트 수입니다.

  • 지표 이름: BytesDownloaded

  • 유효한 통계: Sum

  • 단위: None

업로드된 바이트

뷰어가 OPTIONS, 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