儲存體分析 記錄格式
儲存體分析 記錄記錄您記憶體帳戶成功和失敗要求的詳細數據。 儲存體分析 記錄可讓您檢閱 Azure 資料表、佇列和 Blob 的讀取、寫入和刪除作業詳細數據。 它們也可讓您調查失敗要求的原因，例如逾時、節流和授權錯誤。
每個記錄專案都符合標準記錄格式，其受使用中 儲存體分析 記錄版本所控管。 1.0 版包含 記錄專案格式 1.0 中所述的所有欄位。 2.0 版會新增字段，以記錄 OAuth 2.0 令牌授權之 Blob 和佇列服務的要求相關信息。 記錄 專案格式 2.0 會說明這些額外的欄位。
記錄項目中的第一個欄位一律指定版本號碼。 記錄資料的取用者可以依賴這個欄位以及記錄項目的下列層面：
填入或空白的所有欄位都會以分號 “;” 分隔
每個記錄項目都會以換行符 「\n」 分隔
項目的最後一個字段不會以分號 “;” 結尾
在處理記錄項目之前，務必先檢查版本。
注意
任何可能包含引號 (“) 、分號 (;) 或換行符 (\n) 為 HTML 編碼和引號的欄位。
設定記錄版本
若要設定記錄版本，請呼叫服務的適當作業：
- Blob 服務：設定 Blob 服務屬性 (支援 1.0 和 2.0 版)
- 佇列服務：設定佇列服務屬性 (支援 1.0 和 2.0 版)
- 數據表服務：設定數據表服務屬性 (僅支援 1.0 版)
記錄專案格式 1.0
每個 1.0 版記錄項目皆遵守下列格式：
<version-number>;<request-start-time>;<operation-type>;<request-status>;<http-status-code>;<end-to-end-latency-in-ms>;<server-latency-in-ms>;<authentication-type>;<requester-account-name>;<owner-account-name>;<service-type>;<request-url>;<requested-object-key>;<request-id-header>;<operation-count>;<requester-ip-address>;<request-version-header>;<request-header-size>;<request-packet-size>;<response-header-size>;<response-packet-size>;<request-content-length>;<request-md5>;<server-md5>;<etag-identifier>;<last-modified-time>;<conditions-used>;<user-agent-header>;<referrer-header>;<client-request-id>
1.0 版的記錄專案欄位
下表列出並定義 1.0 版記錄專案中的欄位。
| 欄位名稱 | 欄位類型 | 定義 | 範例 |
|---|---|---|---|
<version-number> |
字串 | 用來記錄專案的 儲存體分析 記錄版本。 | 1.0 |
<request-start-time> |
timestamp | 儲存體分析收到要求的 UTC 時間。 | 2011-08-09T21:44:36.2481552Z |
<operation-type> |
字串 | 執行的 REST 作業類型。 如需可能的作業清單，請參閱 儲存體分析 記錄作業和狀態消息主題。 | GetBlob |
<request-status> |
字串 | 所要求作業的狀態。 如需可能的狀態消息清單，請參閱 儲存體分析 記錄的作業和狀態消息主題。 在 2017-04-17 版和更新版本中， ClientOtherError 不會使用 。 相反地，此欄位會包含 錯誤碼。 |
Success |
<http-status-code> |
字串 | 要求的 HTTP 狀態碼。 如果要求中斷，此值可能會被設為 Unknown。 |
200 |
<end-to-end-latency-in-ms> |
持續時間 | 執行要求作業的總時間 (以毫秒為單位)，包括讀取連入要求和傳送回應給要求者的時間。 | 39 |
<server-latency-in-ms> |
持續時間 | 執行要求作業的總時間 (以毫秒為單位)。 此值不包括網路延遲 (讀取連入要求和傳送回應給要求者的時間)。 | 22 |
<authentication-type> |
字串 | 指出要求是否已獲得授權、匿名或使用共用存取簽章， (SAS) 。 | authenticated |
<requester-account-name> |
字串 | 如果要求獲得授權，則與記憶體帳戶名稱相同。 匿名和 SAS 要求的欄位為空白。 | myaccount |
<owner-account-name> |
字串 | 服務擁有者的帳戶名稱。 | myaccount |
<service-type> |
字串 | 要求的儲存體服務：Blob、資料表或佇列。 | blob |
<request-url> |
字串 | 要求的完整 URL (以引號括住)。 | "https://myaccount.blob.core.windows.net/mycontainer/2025c44c-d25e-42bf-8507-7a5ca4faa034?timeout=30000" |
<requested-object-key> |
字串 | 要求之物件的索引鍵 (以引號括住)。 即使已設定自訂網域名稱，此欄位仍一律使用帳戶名稱。 | "/myaccount/mycontainer/2025c44c-d25e-42bf-8507-7a5ca4faa034" |
<request-id-header> |
guid | 儲存體服務指派的要求識別碼。 這等同於 x-ms-request-id 標頭值。 |
668a4744-7eb3-4e8f-b8d3-fbfd3829715b |
<operation-count> |
int | 針對要求進行的每一項記錄作業號碼，使用索引零。 有些要求需要多項作業，例如複製 Blob，但大部分只需一項作業。 | 0 |
<requester-ip-address> |
字串 | 要求者的 IP 位址，包含連接埠號碼。 | 192.100.0.102:4362 |
<request-version-header> |
字串 | 提出要求時所指定的儲存體服務版本。 這等同於 x-ms-version 標頭值。 |
2009-09-19 |
<request-header-size> |
long | 要求標頭的大小 (以位元組為單位)。 如果要求不成功，這個值可能是空值。 | 280 |
<request-packet-size> |
long | 儲存體服務讀取的要求封包大小 (以位元組為單位)。 如果要求不成功，這個值可能是空值。 | 0 |
<response-header-size> |
long | 回應標頭的大小 (以位元組為單位)。 如果要求不成功，這個值可能是空值。 | 216 |
<response-packet-size> |
long | 儲存體服務寫入的回應封包大小 (以位元組為單位)。 如果要求不成功，這個值可能是空值。 | 0 |
<request-content-length> |
long | 傳送至儲存體服務之要求的 Content-Length 標頭值。 如果要求成功，則此值等於 <request-packet-size>。 如果要求不成功，則此值可能不等於 <request-packet-size>，或可能是空值。 |
0 |
<request-md5> |
字串 | 要求中 Content-MD5 標頭或 x-ms-content-md5 標頭的值 (以引號括住)。 在此欄位中指定的 MD5 雜湊值代表要求中的內容。 這個欄位可以是空白的。 | "788815fd0198be0d275ad329cafd1830" |
<server-md5> |
字串 | 儲存體服務計算的 MD5 雜湊值 (以引號括住)。 這個欄位可以是空白的。 | "3228b3cf1069a5489b298446321f8521" |
<etag-identifier> |
字串 | 所傳回物件的 ETag 識別碼 (以引號括住)。 | "0x8D101F7E4B662C4" |
<last-modified-time> |
datetime | 傳回之物件的上次修改時間 (LMT) (以引號括住)。 對於可傳回多個物件的作業而言，此欄位是空白的。 | Tuesday, 09-Aug-11 21:13:26 GMT |
<conditions-used> |
字串 | 以引號括住的 ConditionName=value分號分隔清單。 ConditionName 可以是下列其中一個條件：- If-Modified-Since- If-Unmodified-Since- If-Match- If-None-Match |
"If-Modified-Since=Friday, 05-Aug-11 19:11:54 GMT" |
<user-agent-header> |
字串 | User-Agent 標頭值 (以引號括住)。 |
"Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 6.1; WOW64; Trident/5.0)" |
<referrer-header> |
字串 | Referer 標頭值 (以引號括住)。 |
"http://contoso.com/about.html" |
<client-request-id> |
字串 | 包含在要求中的 x-ms-client-request-id 標頭值 (以引號括住)。 |
"8/9/2011 9:44:36 PM 45ef1c0f-8c71-4153-bc88-38589f63fbfc" |
1.0 版的範例記錄專案
取得 Blob
下列範例記錄專案適用於匿名 GetBlob 要求：
1.0;2014-06-19T22:59:23.1967767Z;GetBlob;AnonymousSuccess;200;17;16;anonymous;;storagesample;blob;"https://storagesample.blob.core.windows.net/sample-container1/00001.txt";"/storagesample/sample-container1/00001.txt";61d2e3f6-bcb7-4cd1-a81e-4f8f497f0da2;0;192.100.0.102:4362;2014-02-14;283;0;354;23;0;;;""0x8D15A2913C934DE"";Thursday, 19-Jun-14 22:58:10 GMT;;"WA-Storage/4.0.1 (.NET CLR 4.0.30319.34014; Win32NT 6.3.9600.0)";;"44dfd78e-7288-4898-8f70-c3478983d3b6"
放置 Blob
下列範例記錄專案適用於授權的 PutBlob 要求：
1.0;2014-06-19T01:33:54.0926521Z;PutBlob;Success;201;197;54;authenticated;storagesample;storagesample;blob;"https://storagesample.blob.core.windows.net/sample-container1/00001.txt";"/storagesample/sample-container1/00001.txt";a200be85-1c98-4dd9-918e-f13d8c0538e0;0;192.100.0.102:4362;2014-02-14;460;23;225;0;23;"DrPO6z1f00SCsomhaf+J/A==";"DrPO6z1f00SCsomhaf+J/A==";""0x8D15975AA456EA4"";Thursday, 19-Jun-14 01:33:53 GMT;;"WA-Storage/4.0.1 (.NET CLR 4.0.30319.34014; Win32NT 6.3.9600.0)";;"1fe6814a-e4cb-4195-a3cf-837dc7120f68"
複製 Blob
下列範例記錄專案適用於授權的 CopyBlob 要求。 複製 Blob 作業會記錄 3 個作業：CopyBlob、CopyBlobSource 和 CopyBlobDestination。 請注意，這三項作業的要求識別碼屬性都相同，但是作業識別碼會依每項作業而遞增。
服務版本 2012-02-12 和更新版本
在 2012-02-12 版和更新版本中，<requested-object-key> 是一個 URL，它取代了在 2012-02-12 版本之前使用的 /accountname/containername/blobname 格式。
針對下列每個記錄項目，要求識別碼和作業識別碼會以粗體顯示：
1.0;2014-06-19T23:31:36.5780954Z;CopyBlob;Success;202;13;13;authenticated;storagesample;storagesample;blob;"https://storagesample.blob.core.windows.net/sample-container/Copy-sample-blob.txt";"/storagesample/sample-container/Copy-sample-blob.txt";505fc366-688f-4622-bbb1-20e8fc26cffd;0;192.100.0.102:4362;2014-02-14;538;0;261;0;0;;;""0x8D15A2DBF11553E"";Thursday, 19-Jun-14 23:31:36 GMT;;"WA-Storage/4.0.1 (.NET CLR 4.0.30319.34014; Win32NT 6.3.9600.0)";;"dc00da87-5483-4524-b0dc-d1df025a6a9a"
1.0;2014-06-19T23:31:36.5780954Z;CopyBlobSource;Success;202;13;13;authenticated;storagesample;storagesample;blob;"https://storagesample.blob.core.windows.net/sample-container/Copy-sample-blob.txt";"https://storagesample.blob.core.windows.net/sample-container/sample-blob.txt";505fc366-688f-4622-bbb1-20e8fc26cffd;1;192.100.0.102:4362;2014-02-14;538;0;261;0;0;;;;;;"WA-Storage/4.0.1 (.NET CLR 4.0.30319.34014; Win32NT 6.3.9600.0)";;"dc00da87-5483-4524-b0dc-d1df025a6a9a"
1.0;2014-06-19T23:31:36.5780954Z;CopyBlobDestination;Success;202;13;13;authenticated;storagesample;storagesample;blob;"https://storagesample.blob.core.windows.net/sample-container/Copy-sample-blob.txt";"/storagesample/sample-container/Copy-sample-blob.txt";505fc366-688f-4622-bbb1-20e8fc26cffd;2;192.100.0.102:4362;2014-02-14;538;0;261;0;0;;;;;;"WA-Storage/4.0.1 (.NET CLR 4.0.30319.34014; Win32NT 6.3.9600.0)";;"dc00da87-5483-4524-b0dc-d1df025a6a9a"
2012-02-12 之前的服務版本
針對下列每個記錄項目，要求識別碼和作業識別碼會以粗體顯示：
1.0;2011-08-09T18:02:40.6526789Z;CopyBlob;Success;201;28;28;authenticated;account8ce1b67a9e80b35;myaccount;blob;"https://myaccount.blob.core.windows.net/thumbnails/lake.jpg?timeout=30000";"/myaccount/thumbnails/lakebck.jpg";85ba10a5-b7e2-495e-8033-588e08628c5d;0;268.20.203.21:4362;2009-09-19;505;0;188;0;0;;;"0x8CE1B67AD473BC5";Friday, 09-Aug-11 18:02:40 GMT;;;;"8/9/2011 6:02:40 PM 683803d3-538f-4ba8-bc7c-24c83aca5b1a"
1.0;2011-08-09T18:02:40.6526789Z;CopyBlobSource;Success;201;28;28;authenticated;myaccount;myaccount;blob;"https://myaccount.blob.core.windows.net/thumbnails/lake.jpg?timeout=30000";"/myaccount/thumbnails/lake.jpg";85ba10a5-b7e2-495e-8033-588e08628c5d;1;268.20.203.21:4362;2009-09-19;505;0;188;0;0;;;;;;;;"8/9/2011 6:02:40 PM 683803d3-538f-4ba8-bc7c-24c83aca5b1a"
1.0;2011-08-09T18:02:40.6526789Z;CopyBlobDestination;Success;201;28;28;authenticated;myaccount;myaccount;blob;"https://myaccount.blob.core.windows.net/thumbnails/lake.jpg?timeout=30000";"/myaccount/thumbnails/lakebck.jpg";85ba10a5-b7e2-495e-8033-588e08628c5d;2;268.20.203.21:4362;2009-09-19;505;0;188;0;0;;;;;;;;"8/9/2011 6:02:40 PM 683803d3-538f-4ba8-bc7c-24c83aca5b1a"
記錄專案格式 2.0
儲存體分析 記錄格式 2.0 版新增欄位，以支援 Microsoft Entra ID 所提供 OAuth 2.0 令牌授權的要求記錄資訊。 如需詳細資訊，請參閱使用 Microsoft Entra ID 進行驗證。
每個 2.0 版記錄專案都遵循下列格式：
<version-number>;<request-start-time>;<operation-type>;<request-status>;<http-status-code>;<end-to-end-latency-in-ms>;<server-latency-in-ms>;<authentication-type>;<requester-account-name>;<owner-account-name>;<service-type>;<request-url>;<requested-object-key>;<request-id-header>;<operation-count>;<requester-ip-address>;<request-version-header>;<request-header-size>;<request-packet-size>;<response-header-size>;<response-packet-size>;<request-content-length>;<request-md5>;<server-md5>;<etag-identifier>;<last-modified-time>;<conditions-used>;<user-agent-header>;<referrer-header>;<client-request-id>;<user-object-id>;<tenant-id>;<application-id>;<audience>;<issuer>;<user-principal-name>;<reserved-field>;<authorization-detail>
2.0 版的記錄專案欄位
下表列出並定義寫入 2.0 版記錄專案的其他欄位。 所有 1.0 版字段都包含在 2.0 版記錄專案中。
| 欄位名稱 | 欄位類型 | 定義 | 範例 |
|---|---|---|---|
| UserObjectId | 字串 | 用於驗證的物件識別碼。 可以是任何安全性主體，包括使用者、受控識別或服務主體。 | 03124200-da00-4aa6-aa09-be77923d7870 |
| TenantId | 字串 | 持有人授權中使用的租用戶標識碼。 | 72f988bf-86f1-41af-91ab-2d7cd011db47 |
| ApplicationId | 字串 | 持有人授權中使用的應用程式識別碼。 | 2cd20493-fe97-42ef-9ace-ab95b63d82c4 |
| 資源識別碼 | 字串 | 持有人授權中使用的資源標識碼。 | https://storage.azure.comhttps://storagesamples.blob.core.windows.net |
| Issuer | 字串 | 用於持有人授權的簽發者。 | https://sts.windows.net/72f988bf-86f1-41af-91ab-2d7cd011db47/ |
| UserPrincipalName | 字串 | 持有人授權中使用的用戶主體名稱。 | testuser@azure.onmicrosoft.com |
| 保留 | 字串 | 保留供未來使用。 值是空字串。 | N/A |
| AuthorizationDetail | 字串 | 用來授權要求的詳細原則資訊。 | [{"action":"Microsoft.Storage/storageAccounts/blobServices/containers/read", "roleAssignmentId":"/subscriptions/5451a164-d870-4626-a64c-c38d62da20da/providers/Microsoft.Authorization/roleAssignments/6632a082-9b6a-486c-b296-f9d785d32800", "roleDefinitionId":"/subscriptions/5451a164-d870-4626-a64c-c38d62da20da/providers/Microsoft.Authorization/roleDefinitions/ba92f5b4-2d11-453d-a403-e96b0029c9fe", "principalId":"03124200-da00-4aa6-aa09-be77923d7870", "principalType":"ServicePrincipal"}] |
2.0 版的範例記錄專案
列出 Blob
2.0;2019-02-25T20:06:55.9794046Z;ListBlobs;OAuthSuccess;200;250;46;bearer;storagesamples;storagesamples;blob;"https://storagesamples.blob.core.windows.net/sample-container?restype=container&comp=list&prefix=&delimiter=/&marker=&maxresults=30&include=metadata&_=1551125215793";"/storagesamples/sample-container";470b9e55-201e-0137-5c45-cdd293000000;0;200.59.21.176:52659;2018-03-28;2682;0;295;5184;0;;;;;;"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/64.0.3282.140 Safari/537.36 Edge/18.17763";"blob:https://ms.portal.azure.com/cf576432-66ab-4ae6-9cb3-4852b1137a21";;"e5981635-dcf0-4279-ab7b-ca1cbdf4a5c7";"72f988bf-86f1-41af-91ab-2d7cd011db47";"691458b9-1327-4635-9f55-ed83a7f1b41c";"https://storage.azure.com/";"https://sts.windows.net/72f988bf-86f1-41af-91ab-2d7cd011db47/";;;"[{"action":"Microsoft.Storage/storageAccounts/blobServices/containers/blobs/read", "roleAssignmentId":"ca8af92a-6708-4cdf-a678-bb55d0ff7b80", "roleDefinitionId":"ba92f5b4-2d11-453d-a403-e96b0029c9fe", "principalId":"e5981635-dcf0-4279-ab7b-ca1cbdf4a5c7", "principalType":"User"}]"
放置區塊
2.0;2019-02-25T20:06:55.9089848Z;PutBlock;OAuthSuccess;201;95;95;bearer;storagesamples;storagesamples;blob;"https://storagesamples.blob.core.windows.net/sample-container/blob1.txt?comp=block&blockid=YmxvY2stMDAwMDAwMDA=";"/storagesamples/sample-container/blob1.txt";5569fa10-e01e-00c0-2745-cdb22d000000;0;200.59.21.176:52665;2017-11-09;2581;9;365;0;9;;"tdzGO9AaJte/e2HJZLtXig==";;;;"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/64.0.3282.140 Safari/537.36 Edge/18.17763";"https://ms.portal.azure.com/";"c808142e-0393-4942-9001-af4833061026";"e5981635-dcf0-4279-ab7b-ca1cbdf4a5c7";"72f988bf-86f1-41af-91ab-2d7cd011db47";"691458b9-1327-4635-9f55-ed83a7f1b41c";"https://storage.azure.com/";"https://sts.windows.net/72f988bf-86f1-41af-91ab-2d7cd011db47/";;;"[{"action":"Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write", "roleAssignmentId":"ca8af92a-6708-4cdf-a678-bb55d0ff7b80", "roleDefinitionId":"ba92f5b4-2d11-453d-a403-e96b0029c9fe", "principalId":"e5981635-dcf0-4279-ab7b-ca1cbdf4a5c7", "principalType":"User"}]"