配置和使用標準日誌（訪問日誌）

您可以設定 CloudFront 為建立記錄檔，其中包含有關 CloudFront 接收之每個使用者要求的詳細資訊。這些稱為 標準日誌，也稱為存取日誌。如果啟用標準日誌，也可以指定要 CloudFront 在其中儲存檔案的 Amazon S3 儲存貯體。

您可以在建立或更新分佈時啟用標準日誌。如需詳細資訊，請參閱 日誌。

CloudFront 也提供即時記錄，提供即時對分發的要求的相關資訊 (記錄會在收到要求後的幾秒內傳送)。您可以使用即時日誌來監控、分析並根據內容交付效能採取動作。如需詳細資訊，請參閱 使用即時記錄。

標準記錄的運作方式

下圖顯示有關物件要求的 CloudFront 記錄資訊的方式。

以下說明如何 CloudFront 記錄物件請求的相關資訊，如上圖所示。

如果在指定的某小時內沒有使用者存取您的內容，您不會收到該小時的任何日誌檔案。

每個日誌檔案中的項目提供單一請求的詳細資訊。如需關於日誌檔案格式的詳細資訊，請參閱標準日誌檔案格式。

為標準日誌選擇 Amazon S3 儲存貯體

啟用分發的記錄功能時，您可CloudFront 以指定要在其中存放日誌檔的 Amazon S3 儲存貯體。如果您使用 Amazon S3 做為原始伺服器，建議您為日誌檔使用單獨的儲存貯體。

您可以在同一個儲存貯體存放多個分佈的日誌檔案。啟用記錄時，您可以指定檔案名稱的選用字首，以便您可以繼續追蹤哪個日誌檔案與那個分佈關聯。

設定標準記錄和存取記錄檔所需的權限

對於您為記錄檔指定的值區，您 AWS 帳戶 必須具備下列權限：

適用於 SSE-KMS 儲存貯體的必要金鑰政策

如果標準日誌的 S3 儲存貯體透過客戶受管金鑰來使用 AWS KMS keys (SSE-KMS) 實現伺服器端加密，則必須將下列陳述式新增至客戶受管金鑰的金鑰政策。這允許 CloudFront 將日誌文件寫入存儲桶。您無法搭配使用 SSE-KMS， AWS 受管金鑰 因為 CloudFront 無法將記錄檔寫入值區。

{
    "Sid": "Allow CloudFront to use the key to deliver logs",
    "Effect": "Allow",
    "Principal": {
        "Service": "delivery.logs.amazonaws.com"
    },
    "Action": "kms:GenerateDataKey*",
    "Resource": "*"
}

如果標準日誌的 S3 儲存貯體使用 SSE-KMS 搭配 S3 儲存貯體金鑰，您還需要將 kms:Decrypt 權限新增至政策陳述式。在此情況下，完整的政策陳述式如下所示。

{
    "Sid": "Allow CloudFront to use the key to deliver logs",
    "Effect": "Allow",
    "Principal": {
        "Service": "delivery.logs.amazonaws.com"
    },
    "Action": [
        "kms:GenerateDataKey*",
        "kms:Decrypt"
    ],
    "Resource": "*"
}

檔案名稱格式

儲存在 Amazon S3 CloudFront 儲存貯體中的每個日誌檔案名稱使用下列檔案名稱格式：

<optional prefix>/<distribution ID>.YYYY-MM-DD-HH.unique-ID.gz

使用國際標準時間 (UTC) 的日期與時間。

例如，如果您使用 example-prefix 做為前綴，且您的分佈 ID 為 EMLARXS9EXAMPLE，則檔案名稱看起來像這樣：

example-prefix/EMLARXS9EXAMPLE.2019-11-14-20.RT4KCN4SGK9.gz

啟用分佈的記錄時，您可以指定檔案名稱的選用字首，以便您可以繼續追蹤哪個日誌檔案與那個分佈關聯。如果您包含記錄檔前置詞的值，且前置詞的結尾不是正斜線 (/)，則會自動 CloudFront 附加一個值。如果您的前綴確實以正斜杠結尾，則 CloudFront 不要添加另一個。

檔案名稱末尾的表示 CloudFront 已使用 gzip 壓縮記錄檔。.gz

標準日誌檔案交付的時間

CloudFront 每小時最多可提供數次發佈的標準記錄。一般而言，記錄檔包含指定期間內 CloudFront 收到之要求的相關資訊。 CloudFront 通常會在日誌中出現的事件發生後一小時內，將該期間的日誌檔交付到 Amazon S3 儲存貯體。不過，請注意，一個時段的部分或全部日誌檔案項目有時會延遲高達 24 小時。延遲記錄項目時，會 CloudFront 將它們儲存在記錄檔中，檔案名稱包含要求發生的期間的日期和時間，而不是傳送檔案的日期和時間。

建立記錄檔時，會在記錄檔涵蓋的期間內，從收到物件要求的所有邊緣位置 CloudFront 合併發佈的資訊。

CloudFront 可以在一段時間內保存多個文件，具體取決於 CloudFront 收到與發布相關聯的對象的請求數量。

CloudFront 啟用記錄大約四小時後，便會開始可靠地傳遞存取記錄。該時段之前，您可能會收到幾個存取日誌。

CloudFront 也提供即時記錄，提供即時對分發的要求的相關資訊 (記錄會在收到要求後的幾秒內傳送)。您可以使用即時日誌來監控、分析並根據內容交付效能採取動作。如需詳細資訊，請參閱 使用即時記錄。

請求 URL 或標頭超過大小上限時，記錄請求的方式

如果所有要求標頭 (包括 Cookie) 的總大小超過 20 KB，或者 URL 超過 8192 個位元組，則 CloudFront 無法完全剖析要求，也無法記錄要求。因為沒有記錄請求，您將無法在日誌檔案中看到傳回的 HTTP 錯誤狀態代碼。

如果要求主體超過大小上限，則會記錄請求，包含 HTTP 錯誤狀態代碼。

分析標準記錄

由於您每個小時可以收到多個存取日誌，我們建議您將指定期間內收到的所有日誌檔案整合成一個檔案。然後，您可以更準確且完整地分析該期間的資料。

使用 Amazon Athena 是分析存取日誌的其中一種方法。Athena 是一項互動式查詢服務，可協助您分析 AWS 服務的資料，包括 CloudFront. 若要進一步了解，請參閱 Amazon Athena 使用者指南中的查詢亞馬遜 CloudFront 日誌。

此外，下面的 AWS 博客文章討論了一些分析訪問日誌的方法。

編輯標準記錄設定

您可以使用CloudFront 主控台或 CloudFront API 啟用或停用記錄、變更存放日誌的 Amazon S3 儲存貯體，以及變更日誌檔的前置詞。記錄設定的變更在 12 小時內生效。

如需詳細資訊，請參閱下列主題：

從 Amazon S3 儲存貯體刪除標準日誌檔

CloudFront 不會自動從您的 Amazon S3 儲存貯體刪除日誌檔。如需從 Amazon S3 儲存貯體將日誌檔案刪除的詳細資訊，請參閱下列主題：

標準日誌檔案格式

日誌檔案中的每個項目會提供有關單一檢視器請求的詳細資訊。日誌檔案具有下列特性：

標準日誌檔案欄位

分佈的日誌檔案包含 33 個欄位。下列清單依序包含每個欄位名稱，以及該欄位中資訊的描述。

以下是分佈的範例日誌檔案：

#Version: 1.0
#Fields: date time x-edge-location sc-bytes c-ip cs-method cs(Host) cs-uri-stem sc-status cs(Referer) cs(User-Agent) cs-uri-query cs(Cookie) x-edge-result-type x-edge-request-id x-host-header cs-protocol cs-bytes time-taken x-forwarded-for ssl-protocol ssl-cipher x-edge-response-result-type cs-protocol-version fle-status fle-encrypted-fields c-port time-to-first-byte x-edge-detailed-result-type sc-content-type sc-content-len sc-range-start sc-range-end
2019-12-04	21:02:31	LAX1	392	192.0.2.100	GET	d111111abcdef8.cloudfront.net	/index.html	200	-	Mozilla/5.0%20(Windows%20NT%2010.0;%20Win64;%20x64)%20AppleWebKit/537.36%20(KHTML,%20like%20Gecko)%20Chrome/78.0.3904.108%20Safari/537.36	-	-	Hit	SOX4xwn4XV6Q4rgb7XiVGOHms_BGlTAC4KyHmureZmBNrjGdRLiNIQ==	d111111abcdef8.cloudfront.net	https	23	0.001	-	TLSv1.2	ECDHE-RSA-AES128-GCM-SHA256	Hit	HTTP/2.0	-	-	11040	0.001	Hit	text/html	78	-	-
2019-12-04	21:02:31	LAX1	392	192.0.2.100	GET	d111111abcdef8.cloudfront.net	/index.html	200	-	Mozilla/5.0%20(Windows%20NT%2010.0;%20Win64;%20x64)%20AppleWebKit/537.36%20(KHTML,%20like%20Gecko)%20Chrome/78.0.3904.108%20Safari/537.36	-	-	Hit	k6WGMNkEzR5BEM_SaF47gjtX9zBDO2m349OY2an0QPEaUum1ZOLrow==	d111111abcdef8.cloudfront.net	https	23	0.000	-	TLSv1.2	ECDHE-RSA-AES128-GCM-SHA256	Hit	HTTP/2.0	-	-	11040	0.000	Hit	text/html	78	-	-
2019-12-04	21:02:31	LAX1	392	192.0.2.100	GET	d111111abcdef8.cloudfront.net	/index.html	200	-	Mozilla/5.0%20(Windows%20NT%2010.0;%20Win64;%20x64)%20AppleWebKit/537.36%20(KHTML,%20like%20Gecko)%20Chrome/78.0.3904.108%20Safari/537.36	-	-	Hit	f37nTMVvnKvV2ZSvEsivup_c2kZ7VXzYdjC-GUQZ5qNs-89BlWazbw==	d111111abcdef8.cloudfront.net	https	23	0.001	-	TLSv1.2	ECDHE-RSA-AES128-GCM-SHA256	Hit	HTTP/2.0	-	-	11040	0.001	Hit	text/html	78	-	-	
2019-12-13	22:36:27	SEA19-C1	900	192.0.2.200	GET	d111111abcdef8.cloudfront.net	/favicon.ico	502	http://www.example.com/	Mozilla/5.0%20(Windows%20NT%2010.0;%20Win64;%20x64)%20AppleWebKit/537.36%20(KHTML,%20like%20Gecko)%20Chrome/78.0.3904.108%20Safari/537.36	-	-	Error	1pkpNfBQ39sYMnjjUQjmH2w1wdJnbHYTbag21o_3OfcQgPzdL2RSSQ==	www.example.com	http	675	0.102	-	-	-	Error	HTTP/1.1	-	-	25260	0.102	OriginDnsError	text/html	507	-	-
2019-12-13	22:36:26	SEA19-C1	900	192.0.2.200	GET	d111111abcdef8.cloudfront.net	/	502	-	Mozilla/5.0%20(Windows%20NT%2010.0;%20Win64;%20x64)%20AppleWebKit/537.36%20(KHTML,%20like%20Gecko)%20Chrome/78.0.3904.108%20Safari/537.36	-	-	Error	3AqrZGCnF_g0-5KOvfA7c9XLcf4YGvMFSeFdIetR1N_2y8jSis8Zxg==	www.example.com	http	735	0.107	-	-	-	Error	HTTP/1.1	-	-	3802	0.107	OriginDnsError	text/html	507	-	-
2019-12-13	22:37:02	SEA19-C2	900	192.0.2.200	GET	d111111abcdef8.cloudfront.net	/	502	-	curl/7.55.1	-	-	Error	kBkDzGnceVtWHqSCqBUqtA_cEs2T3tFUBbnBNkB9El_uVRhHgcZfcw==	www.example.com	http	387	0.103	-	-	-	Error	HTTP/1.1	-	-	12644	0.103	OriginDnsError	text/html	507	-	-

標準日誌的費用

標準記錄是的選擇性功能 CloudFront。啟用標準記錄沒有額外的費用。不過，在 Amazon S3 上的存放和存取檔案會依一般 Amazon S3 費用計費 (您可以隨時將它們刪除)。

如需 Amazon S3 定價的詳細資訊，請參閱 Amazon S3 定價。

如需有關 CloudFront 定價的詳細資訊，請參閱CloudFront 定價。