# CloudFront 캐시 통계 보고서 보기
Amazon CloudFront 캐시 통계 보고서에는 다음 정보가 표시됩니다.
+ **요청 합계** - 해당 기간 동안의 전체 HTTP 상태 코드(예: 200 또는 404)와 전체 메서드(예: GET, HEAD, POST)의 총 요청 수
+ **결과 유형별 뷰어 요청 비율** - 선택한 CloudFront 배포에 대한 총 뷰어 요청 중에서 적중, 누락 및 오류 비율
+ **뷰어에 전송된 바이트** - 총 바이트 수와 누락 바이트 수
+ **HTTP 상태 코드** - HTTP 상태 코드별 뷰어 요청
+ **다운로드가 완료되지 않은 GET 요청 비율** - 요청한 객체의 다운로드가 완료되지 않은 뷰어 GET 요청을 총 요청의 백분율로 표시한 값
이러한 통계에 대한 데이터는 CloudFront 액세스 로그와 동일한 소스에서 가져옵니다. 하지만 캐시 통계를 보기 위해 [액세스 로깅](AccessLogs.md)을 활성화할 필요는 없습니다.
한 시간 또는 하루 기준의 데이터 지점을 포함해 지난 60일 동안 지정된 날짜 범위에 대한 차트를 표시할 수 있습니다. 일반적으로 한 시간 전까지 CloudFront에서 수신한 요청에 대한 데이터를 볼 수 있지만, 이따금씩 데이터가 24시간 가량 지연될 수 있습니다.
**Topics**
+ [콘솔에서 CloudFront 캐시 통계 보고서 보기](#cache-statistics-howto)
+ [데이터를 CSV 형식으로 다운로드](#cache-statistics-csv)
+ [캐시 통계 차트와 CloudFront 액세스 로그 데이터 간의 연결(액세스 로그)](#cache-statistics-data)
## 콘솔에서 CloudFront 캐시 통계 보고서 보기
콘솔에서 CloudFront 캐시 통계 보고서를 볼 수 있습니다.
**CloudFront 캐시 통계 보고서를 보려면**
1. AWS Management Console에 로그인한 다음 [https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home)에서 CloudFront 콘솔을 엽니다.
1. 탐색 창에서 **캐시 통계**를 선택합니다.
1. **CloudFront 캐시 통계 보고서(CloudFront Cache Statistics Reports)** 창의 **시작일(Start Date)** 및 **종료일(End Date)** 필드에서 캐시 통계 차트를 표시할 날짜 범위를 선택합니다. 사용 가능한 범위는 **세부 수준**에 선택한 값에 따라 다릅니다.
+ **매일(Daily)** - 하루에 데이터 포인트 하나씩 포함하는 차트를 표시하려면 이전 60일에 해당하는 날짜 범위를 선택합니다.
+ **매 시간(Hourly)** - 한 시간에 데이터 포인트 하나씩 포함하는 차트를 표시하려면 이전 60일 내에서 날짜 범위를 최대 14일까지 선택합니다.
날짜 및 시간이 협정 세계시(UTC)로 표시됩니다.
1. **세부 수준**의 경우 차트에 하루에 데이터 지점 하나씩 표시할지, 한 시간에 데이터 지점 하나씩 표시할지 지정합니다. 날짜 범위를 14일보다 길게 지정할 경우 한 시간에 데이터 지점 하나를 지정하는 옵션을 사용할 수 없습니다.
1. **최종 사용자**에서는 최종 사용자 요청이 시작된 대륙을 선택하거나 **All Locations**(모든 위치)를 선택합니다. 캐시 통계 보고서에는 CloudFront에서 지정된 위치로부터 수신된 요청에 대한 데이터가 포함됩니다.
1. **배포** 목록에서 사용 차트에 데이터를 표시할 배포를 선택합니다.
+ **개별 배포(An individual distribution)** - 이 차트에는 선택한 CloudFront 배포에 대한 데이터가 표시됩니다. **배포** 목록은 배포에 대한 ID와 대체 도메인 이름(CNAME)이 있는 경우 이를 표시합니다. 배포에 대체 도메인 이름이 없으면 목록에 배포에 대한 오리진 도메인 이름이 포함됩니다.
+ **모든 배포** – 이 차트에는 사용자가 삭제한 배포를 제외한 현재 AWS 계정과 연결된 모든 배포에 대해 합산된 데이터가 표시됩니다.
1. **업데이트**를 선택합니다.
**작은 정보**
차트 안에서 일별 또는 시간별 데이터를 보려면 마우스 포인터를 데이터 지점 위로 이동합니다.
전송된 데이터를 보여 주는 차트의 경우 수직 눈금을 기가바이트, 메가바이트 또는 킬로바이트로 변경할 수 있습니다.
## 데이터를 CSV 형식으로 다운로드
캐시 통계 보고서를 CSV 형식으로 다운로드할 수 있습니다. 이 단원에서는 보고서를 다운로드하는 방법과 보고서의 값을 설명합니다.
**캐시 통계 보고서를 CSV 형식으로 다운로드하려면**
1. 캐시 통계 보고서를 표시한 상태에서 **CSV**를 선택합니다.
1. ***파일 이름* 열기** 대화 상자에서 파일을 열지 또는 저장할지 여부를 선택합니다.
### 보고서에 대한 정보
보고서의 처음 몇 줄에는 다음 정보가 포함됩니다.
**버전**
이 CSV 파일 형식의 버전입니다.
**보고서**
보고서의 이름입니다.
**DistributionID**
보고서가 실행된 배포의 ID 또는, 모든 배포에 대한 보고서를 실행한 경우 `ALL`입니다.
**StartDateUTC**
보고서 실행 기간에 해당하는 날짜 범위의 시작 일시를 협정 세계시(UTC)로 표시합니다.
**EndDateUTC**
보고서 실행 기간에 해당하는 날짜 범위의 종료 일시를 협정 세계시(UTC)로 표시합니다.
**GeneratedTimeUTC**
보고서를 실행 날짜 및 시간을 협정 세계시(UTC)로 표시합니다.
**Granularity**
보고서의 각 줄이 한 시간을 나타내는지 하루를 나타내는지 지정합니다.
**ViewerLocation**
최종 사용자 요청이 시작된 대륙, 도는 모든 위치에 대한 보고서를 다운로드하도록 선택한 경우 `ALL`입니다.
### 캐시 통계 보고서의 데이터
이 보고서에는 다음 값이 포함됩니다.
**DistributionID**
보고서가 실행된 배포의 ID 또는, 모든 배포에 대한 보고서를 실행한 경우 `ALL`입니다.
**FriendlyName**
배포의 대체 도메인 이름(CNAME)입니다(있는 경우). 배포에 대체 도메인 이름이 없으면 목록에 배포에 대한 원래 도메인 이름이 포함됩니다.
**ViewerLocation**
최종 사용자 요청이 시작된 대륙, 도는 모든 위치에 대한 보고서를 다운로드하도록 선택한 경우 `ALL`입니다.
**TimeBucket**
데이터가 적용되는 시간 또는 날짜를 협정 세계시(UTC)로 표시합니다.
**RequestCount**
해당 기간 동안의 전체 HTTP 상태 코드(예: 200 또는 404)와 전체 메서드(예: GET, HEAD, POST)의 총 요청 수입니다.
**HitCount**
CloudFront 엣지 캐시에서 객체가 제공되는 최종 사용자 요청 수입니다.
**MissCount**
현재 엣지 캐시에 객체가 없어서 CloudFront가 오리진에서 객체를 가져와야 하는 최종 사용자 요청 수입니다.
**ErrorCount**
오류가 발생하여 CloudFront에서 객체를 제공하지 못한 최종 사용자 요청 수입니다.
**IncompleteDownloadCount**
최종 사용자가 객체 다운로드를 시작했지만 완료하지 못한 최종 사용자 요청 수입니다.
**HTTP2xx**
HTTP 상태 코드가 2xx 값(성공)인 최종 사용자 요청 수입니다.
**HTTP3xx**
HTTP 상태 코드가 3xx 값(추가 작업 필요)인 최종 사용자 요청 수입니다.
**HTTP4xx**
HTTP 상태 코드가 4xx 값(클라이언트 오류)인 최종 사용자 요청 수입니다.
**HTTP5xx**
HTTP 상태 코드가 5xx 값(서버 오류)인 최종 사용자 요청 수입니다.
**TotalBytes**
모든 HTTP 메서드에 대한 모든 요청의 응답으로 CloudFront에서 최종 사용자에게 제공한 총 바이트 수입니다.
**BytesFromMisses**
요청 시 엣지 캐시에 없는 객체에 대해 최종 사용자에게 제공한 바이트 수입니다. 이 값은 오리진에서 CloudFront 엣지 캐시로 전송된 예상 정상 바이트 수입니다. 하지만 이미 엣지 캐시에 있지만 만료된 객체에 대한 요청은 제외됩니다.
## 캐시 통계 차트와 CloudFront 액세스 로그 데이터 간의 연결(액세스 로그)
다음 표에는 CloudFront 콘솔의 캐시 통계 차트가 CloudFront 액세스 로그의 값과 어떻게 연결되는지 보여 줍니다. CloudFront 액세스 로그에 대한 자세한 내용은 [액세스 로그(표준 로그)](AccessLogs.md) 단원을 참조하세요.
**전체 요청**
이 차트에는 해당 기간 동안의 전체 HTTP 상태 코드(예: 200 또는 404)와 전체 메서드(예: `GET`, `HEAD` 또는 `POST`)의 총 요청 수가 표시됩니다. 이 차트에 표시된 총 요청 수는 동일 기간 동안의 액세스 로그 파일의 총 요청 수와 동일합니다.
**결과 유형별 뷰어 요청의 비율**
이 차트에는 선택한 CloudFront 배포에 대한 적중, 누락 및 오류 수를 총 최종 사용자 요청 수의 백분율로 표시합니다.
+ **적중(Hit)** - 객체가 CloudFront 엣지 캐시에서 제공되는 최종 사용자 요청입니다. 액세스 로그에서 이러한 요청은 `x-edge-response-result-type`의 값이 `Hit`인 요청입니다.
+ **누락(Miss)** - 객체가 현재 엣지 캐시에 없어서 CloudFront가 객체를 오리진에서 가져와야 하는 최종 사용자 요청입니다. 액세스 로그에서 이러한 요청은 `x-edge-response-result-type`의 값이 `Miss`인 요청입니다.
+ **오류(Error)** - 오류가 발생하여 CloudFront에서 객체를 제공하지 못한 최종 사용자 요청 수입니다. 액세스 로그에서 이러한 요청은 `x-edge-response-result-type`의 값이 `Error`, `LimitExceeded` 또는 `CapacityExceeded`인 요청입니다.
이 차트에는 엣지 캐시에 있지만 만료된 객체에 대한 적중 새로 고침 요청이 포함되지 않습니다. 액세스 로그에서 적중 새로 고침은 `x-edge-response-result-type`의 값이 `RefreshHit`인 요청입니다.
**뷰어로 전송되는 바이트 수**
이 차트에는 두 가지 값이 표시됩니다.
+ **총 바이트 수(Total bytes)** - 모든 HTTP 메서드와 관련된 모든 요청에 대한 응답으로 CloudFront에서 최종 사용자에게 제공한 총 바이트 수입니다. CloudFront 액세스 로그에서 **총 바이트 수(Total Bytes)**는 동일 기간 동안 모든 요청에 대한 `sc-bytes` 열의 값 합계입니다.
+ **누락 바이트 수(Bytes from misses)** - 요청 시 엣지 캐시에 없는 객체에 대해 최종 사용자에게 제공한 바이트 수입니다. CloudFront 액세스 로그에서 **누락 바이트 수**는 `sc-bytes`의 값이 `x-edge-result-type`인 요청에 대한 `Miss` 열의 값 합계입니다. 이 값은 오리진에서 CloudFront 엣지 캐시로 전송된 예상 정상 바이트 수입니다. 하지만 이미 엣지 캐시에 있지만 만료된 객체에 대한 요청은 제외됩니다.
**HTTP 상태 코드**
이 차트에는 HTTP 상태 코드에 의한 최종 사용자 요청이 표시됩니다. CloudFront 액세스 로그에서 상태 코드는 `sc-status` 열에 나타납니다.
+ **2xx** - 요청이 성공했습니다.
+ **3xx** - 추가 작업이 필요합니다. 예를 들어 301(영구 이동됨)은 요청된 객체가 다른 위치로 이동되었음을 의미합니다.
+ **4xx** - 명백하게 클라이언트로 인해 오류가 발생했습니다. 예를 들어 404(찾을 수 없음)는 클라이언트가 찾을 수 없는 객체를 요청했음을 의미합니다.
+ **5xx** - 오리진 서버에서 요청을 이행하지 않았습니다. 예를 들어 503(서비스를 사용할 수 없음)은 오리진 서버를 현재 사용할 수 없음을 의미합니다.
**다운로드를 마치지 않는 GET 요청의 비율**
이 차트에는 요청한 객체의 다운로드를 완료하지 않은 최종 사용자 `GET` 요청이 총 요청 수의 백분율로 표시됩니다. 일반적으로 다른 링크를 클릭하거나 브라우저를 닫는 등의 동작으로 최종 사용자가 다운로드를 취소하여 객체 다운로드가 완료되지 않습니다. CloudFront 액세스 로그에서 이러한 요청은 `200` 열의 값이 `sc-status`이며 `Error` 열의 값은 `x-edge-result-type`입니다.