

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

# Amazon S3 伺服器存取日誌格式
<a name="LogFormat"></a>

伺服器存取記錄，針對向 Amazon S3 儲存貯體提出的請求，提供詳細的記錄。您可以將伺服器存取日誌用於下列目的：
+ 執行安全與存取稽核
+ 了解您的客戶群
+ 了解您的 Amazon S3 計費

本節說明 Amazon S3 伺服器存取日誌檔案的格式和其他詳細資訊。

伺服器存取記錄檔，是由一連串換行分隔日誌記錄所組成。每筆日誌記錄都代表一項要求，且由多個空格分隔欄位所組成。

以下為五筆日誌記錄所組成的日誌範例。

**注意**  
任何欄位都可以設成 `-`，指出資料為未知或不可用，或欄位不適用於此要求。

```
79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be amzn-s3-demo-bucket1 [06/Feb/2019:00:00:38 +0000] 192.0.2.3 79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be 3E57427F3EXAMPLE REST.GET.VERSIONING - "GET /amzn-s3-demo-bucket1?versioning HTTP/1.1" 200 - 113 - 7 - "-" "S3Console/0.4" - s9lzHYrFp76ZVxRcpX9+5cjAnEH2ROuNkd2BHfIa6UkFVdtjf5mKR3/eTPFvsiP/XV/VLi31234= SigV4 ECDHE-RSA-AES128-GCM-SHA256 AuthHeader amzn-s3-demo-bucket1.s3.us-west-1.amazonaws.com TLSV1.2 arn:aws:s3:us-west-1:123456789012:accesspoint/example-AP Yes us-east-1
79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be amzn-s3-demo-bucket1 [06/Feb/2019:00:00:38 +0000] 192.0.2.3 79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be 891CE47D2EXAMPLE REST.GET.LOGGING_STATUS - "GET /amzn-s3-demo-bucket1?logging HTTP/1.1" 200 - 242 - 11 - "-" "S3Console/0.4" - 9vKBE6vMhrNiWHZmb2L0mXOcqPGzQOI5XLnCtZNPxev+Hf+7tpT6sxDwDty4LHBUOZJG96N1234= SigV4 ECDHE-RSA-AES128-GCM-SHA256 AuthHeader amzn-s3-demo-bucket1.s3.us-west-1.amazonaws.com TLSV1.2 - - us-east-1
79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be amzn-s3-demo-bucket1 [06/Feb/2019:00:00:38 +0000] 192.0.2.3 79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be A1206F460EXAMPLE REST.GET.BUCKETPOLICY - "GET /amzn-s3-demo-bucket1?policy HTTP/1.1" 404 NoSuchBucketPolicy 297 - 38 - "-" "S3Console/0.4" - BNaBsXZQQDbssi6xMBdBU2sLt+Yf5kZDmeBUP35sFoKa3sLLeMC78iwEIWxs99CRUrbS4n11234= SigV4 ECDHE-RSA-AES128-GCM-SHA256 AuthHeader amzn-s3-demo-bucket1.s3.us-west-1.amazonaws.com TLSV1.2 - Yes us-east-1
79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be amzn-s3-demo-bucket1 [06/Feb/2019:00:01:00 +0000] 192.0.2.3 79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be 7B4A0FABBEXAMPLE REST.GET.VERSIONING - "GET /amzn-s3-demo-bucket1?versioning HTTP/1.1" 200 - 113 - 33 - "-" "S3Console/0.4" - Ke1bUcazaN1jWuUlPJaxF64cQVpUEhoZKEG/hmy/gijN/I1DeWqDfFvnpybfEseEME/u7ME1234= SigV4 ECDHE-RSA-AES128-GCM-SHA256 AuthHeader amzn-s3-demo-bucket1.s3.us-west-1.amazonaws.com TLSV1.2 - - us-east-1
79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be amzn-s3-demo-bucket1 [06/Feb/2019:00:01:57 +0000] 192.0.2.3 79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be DD6CC733AEXAMPLE REST.PUT.OBJECT s3-dg.pdf "PUT /amzn-s3-demo-bucket1/s3-dg.pdf HTTP/1.1" 200 - - 4406583 41754 28 "-" "S3Console/0.4" - 10S62Zv81kBW7BB6SX4XJ48o6kpcl6LPwEoizZQQxJd5qDSCTLX0TgS37kYUBKQW3+bPdrg1234= SigV4 ECDHE-RSA-AES128-SHA AuthHeader amzn-s3-demo-bucket1.s3.us-west-1.amazonaws.com TLSV1.2 - Yes us-east-1
```

以下是**運算檢查總和**操作的範例日誌記錄：

```
7cd47ef2be amzn-s3-demo-bucket [06/Feb/2019:00:00:38 +0000] - 79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be e5042925-b524-4b3b-a869-f3881e78ff3a S3.COMPUTE.OBJECT.CHECKSUM example-object - - - - 1048576 - - - - - bPf7qjG4XwYdPgDQTl72GW/uotRhdPz2UryEyAFLDSRmKrakUkJCYLtAw6fdANcrsUYc1M/kIulXM1u5vZQT5g== - - - - - - - -
```

**Topics**
+ [日誌記錄欄位](#log-record-fields)
+ [複製操作的其他記錄](#AdditionalLoggingforCopyOperations)
+ [客戶存取日誌資訊](#LogFormatCustom)
+ [可擴展伺服器存取日誌格式的程式設計考量](#LogFormatExtensible)

## 日誌記錄欄位
<a name="log-record-fields"></a>

下列清單說明日誌記錄欄位。

**儲存貯體擁有者**  
來源儲存貯體擁有者的正式使用者 ID。正式使用者 ID 是 AWS 帳戶 ID 的另一種形式。如需正式使用者 ID 的詳細資訊，請參閱《AWS 一般參考》**中的 [AWS 帳戶 識別符](https://docs.aws.amazon.com/general/latest/gr/acct-identifiers.html)。如需如何尋找帳戶正式使用者 ID 的資訊，請參閱[尋找您的 AWS 帳戶的正式使用者 ID](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-identifiers.html#FindCanonicalId)。  
**範例項目**  

```
79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be
```

**儲存貯體**  
要求處理對象的儲存貯體名稱。如果系統收到格式錯誤的要求且無法判斷儲存貯體，則儲存貯體要求就不會出現在任何伺服器存取記錄中。  
**範例項目**  

```
amzn-s3-demo-bucket1
```

**時間**  
收到請求的時間；這些日期和時間都使用國際標準時間 (UTC)。使用 `strftime()` 術語的格式如下：`[%d/%b/%Y:%H:%M:%S %z]`  
**範例項目**  

```
[06/Feb/2019:00:00:38 +0000]
```

**遠端 IP**  
申請者清楚的 IP 位址。中間代理伺服器與防火牆可能會模糊提出請求之電腦的實際 IP 位址。  
**範例項目**  

```
192.0.2.3
```

**要求者**  
要求者的正式使用者 ID，或未經驗證要求者的 `-`。如果申請者是 IAM 使用者，此欄位會傳回申請者的 IAM 使用者名稱，以及 AWS 帳戶 IAM 使用者所屬的 。此識別符與用於存取控制目的的識別符相同。  
**範例項目**  

```
79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be
```
如果請求者使用擔任的角色，此欄位會傳回擔任的 IAM 角色。  
**範例項目**  

```
arn:aws:sts::123456789012:assumed-role/roleName/test-role
```

**要求 ID**  
是由 Amazon S3 產生的字串，是可唯一識別每項請求。對於**運算檢查總和**任務請求，**請求 ID** 欄位會顯示相關聯的任務 ID。如需詳細資訊，請參閱[運算檢查總和](batch-ops-compute-checksums.md)。  
**範例項目**  

```
3E57427F33A59F07
```

**操作**  
這裡列出的操作會宣告為 [S3 生命週期與記錄](lifecycle-and-other-bucket-config.md#lifecycle-general-considerations-logging) 的 `SOAP.operation`、`REST.HTTP_method.resource_type`、`WEBSITE.HTTP_method.resource_type` 或 `BATCH.DELETE.OBJECT` 或 `S3.action.resource_type`。對於 [https://docs.aws.amazon.com/AmazonS3/latest/userguide/batch-ops-compute-checksums.html](https://docs.aws.amazon.com/AmazonS3/latest/userguide/batch-ops-compute-checksums.html) 任務請求，操作會列為 `S3.COMPUTE.OBJECT.CHECKSUM`。  
**範例項目**  

```
REST.PUT.OBJECT
S3.COMPUTE.OBJECT.CHECKSUM
```

**金錀**  
請求的索引鍵 (物件名稱) 部分。  
**範例項目**  

```
/photos/2019/08/puppy.jpg
```

**Request-URI**  
HTTP 請求訊息的 `Request-URI` 部分。此欄位可能包含來自使用者輸入的未逸出引號。  
**項目範例**  

```
"GET /amzn-s3-demo-bucket1/photos/2019/08/puppy.jpg?x-foo=bar HTTP/1.1"
```

**HTTP 狀態**  
回應的數字 HTTP 狀態碼。  
**範例項目**  

```
200
```

**錯誤代碼**  
Amazon S3 [錯誤回應](https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html)；如未發生任何錯誤，則為 `-`。  
**範例項目**  

```
NoSuchBucket
```

**已傳送的位元組**  
已傳送的回應位元組數目 (排除 HTTP 通訊協定額外負荷) 或 `-` (若為零)。  
**範例項目**  

```
2662992
```

**物件大小**  
所提及之物件的總大小。  
**範例項目**  

```
3462992
```

**總時間**  
從伺服器角度計算的請求所經過的毫秒數。此值是從收到您要求的時間開始，計算到回應傳送出最後一組位元組的時間。由於網路延遲，從用戶端角度進行的測量可能較長。  
**範例項目**  

```
70
```

**周轉時間**  
Amazon S3 處理您請求所花費的毫秒數。此值是從收到您要求的最後位元組的時間開始，計算到回應傳送出第一組位元組的時間。  
**範例項目**  

```
10
```

**Referer**  
HTTP `Referer` 標頭的值，如果存在的話。提出要求時，HTTP 使用者代理程式 (例如：瀏覽器) 一般會將此標頭設為連結或嵌入頁面的 URL。此欄位可能包含來自使用者輸入的未逸出引號。  
**範例項目**  

```
"http://www.example.com/webservices"
```

**User-Agent**  
HTTP `User-Agent` 標頭的值。此欄位可能包含來自使用者輸入的未逸出引號。  
**範例項目**  

```
"curl/7.15.1"
```

**版本 Id**  
請求的版本 ID，或 `-` （如果操作未採用 `versionId` 參數）。  
**範例項目**  

```
3HL4kqtJvjVBH40Nrjfkd
```

**主機 Id**  
`x-amz-id-2` 或 Amazon S3 延伸請求 ID。  
**範例項目**  

```
s9lzHYrFp76ZVxRcpX9+5cjAnEH2ROuNkd2BHfIa6UkFVdtjf5mKR3/eTPFvsiP/XV/VLi31234=
```

**簽章版本**  
簽章版本 (`SigV2` 或 `SigV4`)，用來驗證請求或未驗證請求的 `-`。  
**範例項目**  

```
SigV2
```

**密碼套件**  
針對 HTTPS 請求或 HTTP 的 `-` 交涉的 Transport Layer Security (TLS) 密文。  
**範例項目**  

```
ECDHE-RSA-AES128-GCM-SHA256
```

**身分驗證類型**  
使用的請求身分驗證類型：`AuthHeader` 代表身分驗證標頭，`QueryString` 代表查詢字串 (預先簽章的 URL)，或 `-` 代表未身分驗證的請求。  
**範例項目**  

```
AuthHeader
```

**主機標頭**  
用來連線到 Amazon S3 的端點。  
**範例項目**  

```
s3.us-west-2.amazonaws.com
```
某些早期區域支援舊版端點。您可能會在伺服器存取日誌或 AWS CloudTrail 日誌中看到這些端點。如需詳細資訊，請參閱[舊版端點](VirtualHosting.md#s3-legacy-endpoints)。如需 Amazon S3 區域和端點的完整清單，請參閱《Amazon Web Services 一般參考》**中的 [Amazon S3 端點和配額](https://docs.aws.amazon.com/general/latest/gr/s3.html)。

**TLS 版本控制**  
用戶端交涉的 Transport Layer Security (TLS) 版本。值為下列其中一個：`TLSv1.1`、`TLSv1.2`、`TLSv1.3` 或 `-` (如果未使用 TLS)。  
**範例項目**  

```
TLSv1.2
```

**存取點 ARN**  
請求存取點的 Amazon Resource Name (ARN)。如果存取點 ARN 格式錯誤或未使用，該欄位將包含 `-`。如需存取點的詳細資訊，請參閱 [將 Amazon S3 Access Points 用於一般用途儲存貯體](using-access-points.md)。如需 ARN 的詳細資訊，請參閱《AWS 參考指南》**中的 [Amazon Resource Name (ARN)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html)。  
**範例項目**  

```
arn:aws:s3:us-east-1:123456789012:accesspoint/example-AP
```

**aclRequired**  
字串，指出請求是否需要存取控制清單 (ACL) 進行授權。如果請求需要 ACL 進行授權，則字串為 `Yes`。如果不需要 ACL，則字串為 `-`。如需 ACL 的詳細資訊，請參閱「[存取控制清單 (ACL) 概觀](acl-overview.md)」。如需使用 `aclRequired` 欄位停用 ACL 的詳細資訊，請參閱 [控制物件的擁有權並停用儲存貯體的 ACL](about-object-ownership.md)。  
**範例項目**  

```
Yes
```

**來源區域**  
發出請求 AWS 的區域。當無法判斷原始伺服器區域`-`時 （例如 PrivateLink 連線、Direct Connect 連線、使用您自己的 IP 地址 (BYOIP) 或非AWS IP 地址），或者當日誌是由根據客戶設定政策或動作觸發的操作產生時，例如生命週期和檢查總和。  
**範例項目**  

```
us-east-1
```

## 複製操作的其他記錄
<a name="AdditionalLoggingforCopyOperations"></a>

複製操作包括 `GET` 與 `PUT`。因此，執行複製操作時，我們會記錄兩筆記錄。上節說明與操作的 `PUT` 部分有關的欄位。下列清單說明記錄中與複製操作的 `GET` 部分有關的欄位。

**儲存貯體擁有者**  
存放要複製物件之儲存貯體的正式使用者 ID。正式使用者 ID 是 AWS 帳戶 ID 的另一種形式。如需正式使用者 ID 的詳細資訊，請參閱《AWS 一般參考》**中的 [AWS 帳戶 識別符](https://docs.aws.amazon.com/general/latest/gr/acct-identifiers.html)。如需如何尋找帳戶正式使用者 ID 的資訊，請參閱[尋找您的 AWS 帳戶的正式使用者 ID](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-identifiers.html#FindCanonicalId)。  
**範例項目**  

```
79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be
```

**儲存貯體**  
存放所複製物件的儲存貯體名稱。  
**範例項目**  

```
amzn-s3-demo-bucket1
```

**時間**  
收到請求的時間；這些日期和時間都使用國際標準時間 (UTC)。使用 `strftime()` 術語的格式如下：`[%d/%B/%Y:%H:%M:%S %z]`  
**範例項目**  

```
[06/Feb/2019:00:00:38 +0000]
```

**遠端 IP**  
申請者清楚的 IP 位址。中間代理伺服器與防火牆可能會模糊提出請求之電腦的實際 IP 位址。  
**範例項目**  

```
192.0.2.3
```

**要求者**  
要求者的正式使用者 ID，或未經驗證要求者的 `-`。如果申請者是 IAM 使用者，此欄位會傳回申請者的 IAM 使用者名稱，以及 AWS 帳戶根使用者 IAM 使用者所屬的 。此識別符與用於存取控制目的的識別符相同。  
**範例項目**  

```
79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be
```
如果請求者使用擔任的角色，此欄位會傳回擔任的 IAM 角色。  
**範例項目**  

```
arn:aws:sts::123456789012:assumed-role/roleName/test-role
```

**要求 ID**  
是由 Amazon S3 產生的字串，是可唯一識別每項請求。對於**運算檢查總和**任務請求，**請求 ID** 欄位會顯示相關聯的任務 ID。如需詳細資訊，請參閱[運算檢查總和](batch-ops-compute-checksums.md)。  
**範例項目**  

```
3E57427F33A59F07
```

**操作**  
這裡列出的操作會宣告為 `SOAP.operation`、`REST.HTTP_method.resource_type`、`WEBSITE.HTTP_method.resource_type` 或 `BATCH.DELETE.OBJECT`。  
**範例項目**  

```
REST.COPY.OBJECT_GET
```

**金錀**  
要複製之物件的金鑰 (物件名稱)；或 `-` (如果操作未採用金鑰參數)。  
**範例項目**  

```
/photos/2019/08/puppy.jpg
```

**Request-URI**  
HTTP 請求訊息的 `Request-URI` 部分。此欄位可能包含來自使用者輸入的未逸出引號。  
**範例項目**  

```
"GET /amzn-s3-demo-bucket1/photos/2019/08/puppy.jpg?x-foo=bar"
```

**HTTP 狀態**  
複製操作之 `GET` 部分的數字 HTTP 狀態碼。  
**範例項目**  

```
200
```

**錯誤代碼**  
複製操作之 `GET` 部分的 Amazon S3 [錯誤回應](https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html)；如未發生任何錯誤，則為 `-`。  
**範例項目**  

```
NoSuchBucket
```

**已傳送的位元組**  
已傳送的回應位元組數目 (排除 HTTP 通訊協定額外負荷) 或 `-` (若為零)。  
**範例項目**  

```
2662992
```

**物件大小**  
所提及之物件的總大小。  
**範例項目**  

```
3462992
```

**總時間**  
從伺服器角度計算的請求所經過的毫秒數。此值是從收到您要求的時間開始，計算到回應傳送出最後一組位元組的時間。由於網路延遲，從用戶端角度進行的測量可能較長。  
**範例項目**  

```
70
```

**周轉時間**  
Amazon S3 處理您請求所花費的毫秒數。此值是從收到您要求的最後位元組的時間開始，計算到回應傳送出第一組位元組的時間。  
**範例項目**  

```
10
```

**Referer**  
HTTP `Referer` 標頭的值，如果存在的話。提出要求時，HTTP 使用者代理程式 (例如：瀏覽器) 一般會將此標頭設為連結或嵌入頁面的 URL。此欄位可能包含來自使用者輸入的未逸出引號。  
**範例項目**  

```
"http://www.example.com/webservices"
```

**User-Agent**  
HTTP `User-Agent` 標頭的值。此欄位可能包含來自使用者輸入的未逸出引號。  
**範例項目**  

```
"curl/7.15.1"
```

**版本 Id**  
要複製之物件的版本 ID，或 `-` (如果 `x-amz-copy-source` 標頭並未將 `versionId` 參數指定為複製來源的一部分)。  
**項目範例**  

```
3HL4kqtJvjVBH40Nrjfkd
```

**主機 Id**  
`x-amz-id-2` 或 Amazon S3 延伸請求 ID。  
**範例項目**  

```
s9lzHYrFp76ZVxRcpX9+5cjAnEH2ROuNkd2BHfIa6UkFVdtjf5mKR3/eTPFvsiP/XV/VLi31234=
```

**簽章版本**  
簽章版本 (`SigV2` 或 `SigV4`)，用來驗證請求或未驗證請求的 `-`。  
**範例項目**  

```
SigV4
```

**密碼套件**  
針對 HTTPS 請求或 HTTP 的 `-` 交涉的 Transport Layer Security (TLS) 密文。  
**範例項目**  

```
ECDHE-RSA-AES128-GCM-SHA256
```

**身分驗證類型**  
使用的請求身分驗證類型：`AuthHeader` 代表身分驗證標頭、`QueryString` 代表查詢字串 (預先簽章的 URL)，或 `-` 代表未驗證的請求。  
**範例項目**  

```
AuthHeader
```

**主機標頭**  
用來連線到 Amazon S3 的端點。  
**範例項目**  

```
s3.us-west-2.amazonaws.com
```
某些早期區域支援舊版端點。您可能會在伺服器存取日誌或 AWS CloudTrail 日誌中看到這些端點。如需詳細資訊，請參閱[舊版端點](VirtualHosting.md#s3-legacy-endpoints)。如需 Amazon S3 區域和端點的完整清單，請參閱《Amazon Web Services 一般參考》**中的 [Amazon S3 端點和配額](https://docs.aws.amazon.com/general/latest/gr/s3.html)。

**TLS 版本控制**  
用戶端交涉的 Transport Layer Security (TLS) 版本。值為下列其中一個：`TLSv1.1`、`TLSv1.2`、`TLSv1.3` 或 `-` (如果未使用 TLS)。  
**範例項目**  

```
TLSv1.2
```

**存取點 ARN**  
請求存取點的 Amazon Resource Name (ARN)。如果存取點 ARN 格式錯誤或未使用，該欄位將包含 `-`。如需存取點的詳細資訊，請參閱 [將 Amazon S3 Access Points 用於一般用途儲存貯體](using-access-points.md)。如需 ARN 的詳細資訊，請參閱《AWS 參考指南》**中的 [Amazon Resource Name (ARN)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html)。  
**範例項目**  

```
arn:aws:s3:us-east-1:123456789012:accesspoint/example-AP
```

**aclRequired**  
字串，指出請求是否需要存取控制清單 (ACL) 進行授權。如果請求需要 ACL 進行授權，則字串為 `Yes`。如果不需要 ACL，則字串為 `-`。如需 ACL 的詳細資訊，請參閱「[存取控制清單 (ACL) 概觀](acl-overview.md)」。如需使用 `aclRequired` 欄位停用 ACL 的詳細資訊，請參閱 [控制物件的擁有權並停用儲存貯體的 ACL](about-object-ownership.md)。  
**範例項目**  

```
Yes
```

**來源區域**  
發出請求 AWS 的區域。當無法判斷原始伺服器區域`-`時 （例如 PrivateLink 連線、Direct Connect 連線、使用您自己的 IP 地址 (BYOIP) 或非AWS IP 地址），或者當日誌是由根據客戶設定政策或動作觸發的操作產生時，例如生命週期和檢查總和。  
**範例項目**  

```
us-east-1
```

## 客戶存取日誌資訊
<a name="LogFormatCustom"></a>

您可以包含要存放在請求存取日誌記錄中的自訂資訊。若要執行這項操作，請將自訂的查詢字串參數新增至請求的 URL。Amazon S3 忽略開頭為 `x-` 的查詢字串參數，但會將這些參數包含在請求的存取日誌日誌中，當成日誌記錄 `Request-URI` 欄位的一部分。

例如，`GET` 請求的 `"s3.amazonaws.com/amzn-s3-demo-bucket1/photos/2019/08/puppy.jpg?x-user=johndoe"` 運作方式與 `"s3.amazonaws.com/amzn-s3-demo-bucket1/photos/2019/08/puppy.jpg"` 請求相同，不同之處在於該 `"x-user=johndoe"` 字串包含在關聯日誌記錄的 `Request-URI` 欄位中。此功能僅有 REST 介面提供。

## 可擴展伺服器存取日誌格式的程式設計考量
<a name="LogFormatExtensible"></a>

有時候，我們可能要在每行結尾新增欄位，擴展存取日誌記錄的格式。因此，確定任何解析伺服器存取日誌的程式碼，可以處理其可能不理解的結尾欄位。