

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 檢視 CloudFront 快取統計資料報告
<a name="cache-statistics"></a>

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 快取統計資料報告
<a name="cache-statistics-howto"></a>

您可以在主控台檢視 CloudFront 快取統計資料報告。<a name="cache-statistics-procedure"></a>

**檢視 CloudFront 快取統計資料報告**

1. 登入 AWS 管理主控台 ，並在 開啟 CloudFront 主控台[https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home)。

1. 在導覽面板中選擇**快取統計資料**。

1. 在 **CloudFront 快取統計資料報告**窗格中，針對**開始日期**和**結束日期**，選擇您要顯示快取統計資料圖表的日期範圍。可用的範圍取決於您針對 **Granularity (精細度)** 選擇的值：
   + **每日** – 若要顯示每天一個資料點的圖表，請選擇前 60 天內的任何日期範圍。
   + **每小時** – 若要顯示每小時一個資料點的圖表，請選擇前 60 天內的任意日期範圍 (最多 14 天)。

   日期和時間都使用國際標準時間 (UTC)。

1. 對於 **Granularity (精細度)**，指定要在圖表中顯示每天一個資料點，或每小時一個資料點。如果您指定的日期範圍大於 14 天，則每小時指定一個資料點的選項不可用。

1. 針對 **Viewer Location (檢視器位置)**，選擇發出檢視器請求的洲別，或是選擇 **All Locations (所有位置)**。快取統計資料圖表包含 CloudFront 從指定位置收到的請求的資料。

1. 在 **Distribution (分佈)** 清單中，選擇要在用量圖表中顯示其資料的分佈：
   + **個別分佈** - 此圖表會顯示所選取 CloudFront 分佈的資料。**Distribution (分佈)** 清單會顯示分佈的分佈 ID 和替代網域名稱 (CNAME) (如果有的話)。如果分佈沒有備用網域名稱，則該清單包括分佈的來源網域名稱。
   + **所有分佈** – 圖表會顯示與目前 相關聯的所有分佈的加總資料 AWS 帳戶，不包括您已刪除的分佈。

1. 選擇**更新**。

**提示**  
若要查看圖表中每日或每小時資料點的資料，請將滑鼠指標停留在資料點上。
對於顯示傳輸資料的圖表，您可以將垂直擴展變更為 GB、MB 或 KB。

## 以 CSV 格式下載資料
<a name="cache-statistics-csv"></a>

您可使用 CSV 格式下載快取統計資料報告。本節說明如何下載報告和描述報告中的值。<a name="cache-statistics-csv-procedure"></a>

**以 CSV 格式下載快取統計資料報告。**

1. 請在檢視快取統計資料報告時選擇 **CSV**。

1. 在**開啟*檔案名稱***對話方塊中，選擇要開啟或儲存檔案。

### 有關報告的資訊
<a name="cache-statistics-csv-header"></a>

報告的前幾行包含以下資訊：

**版本**  
此 CSV 檔案的格式版本。

**報告**  
報告名稱。

**DistributionID**  
為執行報告所分佈的 ID，如果您為所有分佈執行報告，則為 `ALL`。

**StartDateUTC**  
您所執行報告日期範圍的開始時間，是以國際標準時間 (UTC) 為準。

**EndDateUTC**  
您執行報告的日期範圍的結束時間，以國際標準時間 (UTC) 為準。

**GeneratedTimeUTC**  
您執行報告的日期和時間，以國際標準時間 (UTC) 為準。

**精細程度**  
報告中的每一行表示一小時還是一天。

**ViewerLocation**  
該檢視器所請求來源的洲別，或是如果您選擇用於所有位置而下載報告的 `ALL`。

### 快取統計資料報告中的資料
<a name="cache-statistics-csv-data"></a>

該報告包含以下值：

**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**  
CloudFront 提供給檢視器的總位元組數，以回應所有 HTTP 方法的所有請求。

**BytesFromMisses**  
用於在請求時不在節點快取中的物件，所提供給檢視器的位元組數。該值是從原始伺服器傳輸到 CloudFront 邊緣快取的良好位元組近似值。但是，它會排除已經在節點快取但已過期的物件的請求。

## 快取統計資料圖表與 CloudFront 標準日誌 (存取日誌) 中資料的關係
<a name="cache-statistics-data"></a>

下表顯示了 CloudFront 主控台中的快取統計資料圖表與 CloudFront 存取日誌中的值的對應方式。如需有關 CloudFront 存取日誌的詳細資訊，請參閱 [存取日誌 （標準日誌）](AccessLogs.md)。

**請求總數**  
此圖表顯示所有 HTTP 狀態碼 (例如，200 或 404) 和所有方法 (例如，`GET`、 `HEAD` 或 `POST`) 的請求總數 此圖表中顯示的請求總數等於相同時間段中存取日誌檔中的請求總數。

**依結果類型的檢視器請求百分比**  
此圖表將命中數、未命中數和錯誤顯示為所選 CloudFront 分佈的檢視器請求總數的百分比：  
+ **命中** – 從 CloudFront 邊緣快取為其提供物件的檢視器請求數量。在存取日誌中，這些都是 `x-edge-response-result-type` 值為 `Hit` 的請求。
+ **未命中** – 檢視器請求的物件目前不在邊緣快取中，因此 CloudFront 必須從您的原始伺服器取得物件。在存取日誌中，這些都是 `x-edge-response-result-type` 值為 `Miss` 的請求。
+ **錯誤** – 造成錯誤的檢視器請求，因此 CloudFront 並未提供物件。在存取日誌中，這些都是 `x-edge-response-result-type` 值為 `Error`、`LimitExceeded` 或 `CapacityExceeded` 的請求。
圖表並不包括用於在邊緣快取中但已過期的物件所做的重新整理命中請求。在存取日誌中，重新整理命中是 `x-edge-response-result-type`值為 `RefreshHit` 的請求。

**傳輸到檢視器的位元組數**  
此圖表顯示兩個值：  
+ **總位元組數** – 為了回應所有 HTTP 方法的所有請求，CloudFront 提供給檢視器的總位元組數。在 CloudFront 存取日誌中，**總位元組數**是在同一個期間內所有請求的 `sc-bytes` 欄位值總和。
+ **未命中的位元組數** – 在請求發出時，針對不在邊緣快取中的物件，提供給檢視器的位元組數。在 CloudFront 存取日誌中，**bytes from misses** (未命中的位元組數) 是 `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`。