# CloudFront의 지표 유형
CloudWatch API 또는 AWS Command Line Interface(AWS CLI)를 사용하여, 빌드한 프로그램이나 애플리케이션의 CloudFront 지표를 가져올 수 있습니다. 원시 데이터를 사용하여 사용자 지정 대시보드, 사용자 고유의 경고 도구 등을 만들 수 있습니다.
자세한 내용은 **AWS CLI 명령 참조의 [get-metric-data](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-data.html) 또는 **Amazon CloudWatch API 참조의 [GetMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html) API 작업을참조하세요.
**Topics**
+ [모든 CloudFront 지표에 대한 값](#cloudfront-metrics-global-values)
+ [CloudFront 배포 지표에 대한 값](#cloudfront-metrics-distribution-values)
+ [CloudFront 함수 지표에 대한 값](#cloudfront-metrics-function-values)
**참고**
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`인 모든 최종 사용자 요청의 백분율입니다. 이 지표를 가져오려면 먼저 [추가 지표를 활성화](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional)해야 합니다.
+ 지표 이름: `401ErrorRate`
+ 유효한 통계: `Average`
+ 단위: `Percent`
**403 오류 발생률**
응답의 HTTP 상태 코드가 `403`인 모든 최종 사용자 요청의 백분율입니다. 이 지표를 가져오려면 먼저 [추가 지표를 활성화](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional)해야 합니다.
+ 지표 이름: `403ErrorRate`
+ 유효한 통계: `Average`
+ 단위: `Percent`
**404 오류 발생률**
응답의 HTTP 상태 코드가 `404`인 모든 최종 사용자 요청의 백분율입니다. 이 지표를 가져오려면 먼저 [추가 지표를 활성화](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional)해야 합니다.
+ 지표 이름: `404ErrorRate`
+ 유효한 통계: `Average`
+ 단위: `Percent`
**5xx 오류 발생률**
응답의 HTTP 상태 코드가 `5xx`인 모든 최종 사용자 요청의 백분율입니다.
+ 지표 이름: `5xxErrorRate`
+ 유효한 통계: `Average`
+ 단위: `Percent`
**502 오류 발생률**
응답의 HTTP 상태 코드가 `502`인 모든 최종 사용자 요청의 백분율입니다. 이 지표를 가져오려면 먼저 [추가 지표를 활성화](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional)해야 합니다.
+ 지표 이름: `502ErrorRate`
+ 유효한 통계: `Average`
+ 단위: `Percent`
**503 오류 발생률**
응답의 HTTP 상태 코드가 `503`인 모든 최종 사용자 요청의 백분율입니다. 이 지표를 가져오려면 먼저 [추가 지표를 활성화](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional)해야 합니다.
+ 지표 이름: `503ErrorRate`
+ 유효한 통계: `Average`
+ 단위: `Percent`
**504 오류 발생률**
응답의 HTTP 상태 코드가 `504`인 모든 최종 사용자 요청의 백분율입니다. 이 지표를 가져오려면 먼저 [추가 지표를 활성화](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional)해야 합니다.
+ 지표 이름: `504ErrorRate`
+ 유효한 통계: `Average`
+ 단위: `Percent`
**다운로드된 바이트**
`GET` 및 `HEAD` 요청에 대해 뷰어가 다운로드한 총 바이트 수입니다.
+ 지표 이름: `BytesDownloaded`
+ 유효한 통계: `Sum`
+ 단위: `None`
**업로드된 바이트**
뷰어가 `OPTIONS`, `POST` 및 `PUT` 요청을 사용하여 CloudFront에 업로드한 총 바이트 수입니다.
+ 지표 이름: `BytesUploaded`
+ 유효한 통계: `Sum`
+ 단위: `None`
**캐시 적중률**
CloudFront가 캐시에서 콘텐츠를 제공하는 캐시 가능한 모든 요청의 비율입니다. HTTP `POST` 및 `PUT` 요청, 오류는 캐시 가능한 요청으로 간주되지 않습니다. 이 지표를 가져오려면 먼저 [추가 지표를 활성화](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional)해야 합니다.
+ 지표 이름: `CacheHitRate`
+ 유효한 통계: `Average`
+ 단위: `Percent`
**오리진 지연 시간**
CloudFront에서 요청을 수신한 시점부터 CloudFront 캐시가 아닌 오리진에서 제공되는 요청에 대해 네트워크(최종 사용자 아님)에 대한 응답을 제공하기 시작하는 시점까지 소요되는 총 시간(밀리초)입니다. 이것을 *첫 번째 바이트 대기 시간* 또는 *time-to-first-byte*라고도 합니다. 이 지표를 가져오려면 먼저 [추가 지표를 활성화](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional)해야 합니다.
+ 지표 이름: `OriginLatency`
+ 유효한 통계: `Percentile`
+ 단위: `Milliseconds`
CloudWatch API에서 `Percentile` 통계를 확인하려면 `ExtendedStatistics`가 아닌 `Statistics` 파라미터를 사용합니다. 자세한 내용은 *Amazon CloudWatch API 참조*의 [GetMetricStatistics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricStatistics.html) 또는 [AWS SDK](https://docs.aws.amazon.com/#sdks) 관련 참조 설명서를 참조하세요.
**요청**
모든 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\$1100)의 최대 허용 시간의 백분율입니다. 예를 들어, 값이 35이면 함수가 최대 허용 시간의 35%에서 완료되었음을 의미합니다.
+ 지표 이름: `FunctionComputeUtilization`
+ 유효한 통계: `Average`
+ 단위: `Percent`
**제한**
지정된 기간 동안 함수가 제한된 횟수입니다.
+ 지표 이름: `FunctionThrottles`
+ 유효한 통계: `Sum`
+ 단위: `None`