API를 사용하여 지표 가져오기 CloudWatch - 아마존 CloudFront

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

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

업로드된 바이트

최종 사용자가 POSTPUT 요청을 사용하여 오리진에 CloudFront과 함께 업로드한 총 바이트 수입니다.

  • 지표 이름: BytesUploaded

  • 유효한 통계: Sum

  • 단위: None

캐시 적중률

캐시에서 콘텐츠를 CloudFront 제공한 캐시 가능한 모든 요청의 비율입니다. HTTP POSTPUT 요청, 오류는 캐시 가능한 요청으로 간주되지 않습니다. 이 지표를 가져오려면 먼저 추가 지표를 활성화해야 합니다.

  • 지표 이름: 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