Format log Storage Analytics
Pengelogan Storage Analytics mencatat detail untuk permintaan yang berhasil dan gagal untuk akun penyimpanan Anda. Log Storage Analytics memungkinkan Anda meninjau detail operasi baca, tulis, dan hapus terhadap tabel, antrean, dan blob Azure Anda. Mereka juga memungkinkan Anda untuk menyelidiki alasan permintaan yang gagal seperti waktu habis, pembatasan, dan kesalahan otorisasi.
Setiap entri log sesuai dengan format log standar yang diatur oleh versi pengelogan Storage Analytics yang digunakan. Versi 1.0 menyertakan semua bidang yang dijelaskan dalam Format entri log 1.0. Versi 2.0 menambahkan bidang untuk informasi pengelogan tentang permintaan ke layanan Blob dan Antrean yang diotorisasi dengan token OAuth 2.0. Bidang tambahan ini dijelaskan dalam Format entri log 2.0.
Bidang pertama dalam entri log selalu menentukan nomor versi. Konsumen data pengelogan dapat mengambil dependensi pada bidang ini serta aspek entri log berikut:
Semua bidang, diisi atau kosong, akan dipisahkan oleh titik koma ";"
Setiap entri log dipisahkan oleh karakter baris baru "\n"
Bidang terakhir dalam entri tidak akan berakhir dengan titik koma ";"
Selalu periksa versi sebelum memproses entri log.
Catatan
Bidang apa pun yang mungkin berisi tanda kutip ("), titik koma (;), atau baris baru (\n) dikodekan dan dikutip HTML.
Mengatur versi pengelogan
Untuk mengatur versi pengelogan, panggil operasi yang sesuai untuk layanan:
- Blob service:Set Blob Service Properties (mendukung versi 1.0 dan 2.0)
- Layanan antrean:Mengatur Properti Layanan Antrean (mendukung versi 1.0 dan 2.0)
- Layanan tabel:Atur Properti Layanan Tabel (hanya mendukung versi 1.0)
Format entri log 1.0
Setiap entri log versi 1.0 mematuhi format berikut:
<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>
Bidang entri log untuk versi 1.0
Tabel berikut mencantumkan dan menentukan bidang dalam entri log versi 1.0.
| Nama Bidang | Jenis Bidang | Definisi | Contoh |
|---|---|---|---|
<version-number> |
string | Versi pengelogan Storage Analytics yang digunakan untuk merekam entri. | 1.0 |
<request-start-time> |
rentang waktu | Waktu dalam UTC saat permintaan diterima oleh Storage Analytics. | 2011-08-09T21:44:36.2481552Z |
<operation-type> |
string | Jenis operasi REST yang dilakukan. Lihat topik Operasi Log Analitik Penyimpanan dan Pesan Status untuk daftar kemungkinan operasi. | GetBlob |
<request-status> |
string | Status operasi yang diminta. Lihat topik Operasi Log Analitik Penyimpanan dan Pesan Status untuk daftar kemungkinan pesan status. Dalam versi 2017-04-17 dan yang lebih baru, ClientOtherError tidak digunakan. Sebaliknya, bidang ini berisi kode kesalahan. |
Success |
<http-status-code> |
string | Kode status HTTP untuk permintaan. Jika permintaan terganggu, nilai ini dapat diatur ke Unknown. |
200 |
<end-to-end-latency-in-ms> |
duration | Total waktu dalam milidetik untuk melakukan operasi yang diminta, termasuk waktu untuk membaca permintaan masuk dan mengirim respons kepada pemohon. | 39 |
<server-latency-in-ms> |
duration | Total waktu dalam milidetik untuk melakukan operasi yang diminta. Nilai ini tidak termasuk latensi jaringan (waktu untuk membaca permintaan masuk dan mengirim respons ke pemohon). | 22 |
<authentication-type> |
string | Menunjukkan apakah permintaan diotorisasi, anonim, atau menggunakan Tanda Tangan Akses Bersama (SAS). | authenticated |
<requester-account-name> |
string | Sama seperti nama akun penyimpanan, jika permintaan diotorisasi. Bidang ini akan kosong untuk permintaan anonim dan SAS. | myaccount |
<owner-account-name> |
string | Nama akun pemilik layanan. | myaccount |
<service-type> |
string | Layanan penyimpanan yang diminta: blob, tabel, atau antrean. | blob |
<request-url> |
string | URL lengkap permintaan, dalam tanda kutip. | "https://myaccount.blob.core.windows.net/mycontainer/2025c44c-d25e-42bf-8507-7a5ca4faa034?timeout=30000" |
<requested-object-key> |
string | Kunci objek yang diminta, dalam tanda kutip. Bidang ini akan selalu menggunakan nama akun, meskipun nama domain kustom telah dikonfigurasi. | "/myaccount/mycontainer/2025c44c-d25e-42bf-8507-7a5ca4faa034" |
<request-id-header> |
guid | ID permintaan yang ditetapkan oleh layanan penyimpanan. Ini setara dengan nilai x-ms-request-id header. |
668a4744-7eb3-4e8f-b8d3-fbfd3829715b |
<operation-count> |
int | Jumlah setiap operasi yang dicatat untuk permintaan, menggunakan indeks nol. Beberapa permintaan memerlukan lebih dari satu operasi, seperti Salin Blob, meskipun sebagian besar hanya melakukan satu operasi. | 0 |
<requester-ip-address> |
string | Alamat IP pemohon, termasuk nomor port. | 192.100.0.102:4362 |
<request-version-header> |
string | Versi layanan penyimpanan ditentukan saat permintaan dibuat. Ini setara dengan nilai x-ms-version header. |
2009-09-19 |
<request-header-size> |
long | Ukuran header permintaan, dalam byte. Jika permintaan tidak berhasil, nilai ini mungkin kosong. | 280 |
<request-packet-size> |
long | Ukuran paket permintaan yang dibaca oleh layanan penyimpanan, dalam byte. Jika permintaan tidak berhasil, nilai ini mungkin kosong. | 0 |
<response-header-size> |
long | Ukuran header respons, dalam byte. Jika permintaan tidak berhasil, nilai ini mungkin kosong. | 216 |
<response-packet-size> |
long | Ukuran paket respons yang ditulis oleh layanan penyimpanan, dalam byte. Jika permintaan tidak berhasil, nilai ini mungkin kosong. | 0 |
<request-content-length> |
long | Nilai Content-Length header untuk permintaan yang dikirim ke layanan penyimpanan. Jika permintaan berhasil, nilai ini sama dengan <request-packet-size>. Jika permintaan tidak berhasil, nilai ini mungkin tidak sama dengan <request-packet-size>, atau mungkin kosong. |
0 |
<request-md5> |
string | Nilai header Content-MD5 atau header x-ms-content-md5 dalam permintaan, dalam tanda kutip. Nilai hash MD5 yang ditentukan dalam bidang ini mewakili konten dalam permintaan. Bidang ini dapat dibiarkan kosong. | "788815fd0198be0d275ad329cafd1830" |
<server-md5> |
string | Nilai hash MD5 yang dihitung oleh layanan penyimpanan, dalam tanda kutip. Bidang ini dapat dibiarkan kosong. | "3228b3cf1069a5489b298446321f8521" |
<etag-identifier> |
string | Pengidentifikasi ETag untuk objek yang dikembalikan, dalam kuotasi. | "0x8D101F7E4B662C4" |
<last-modified-time> |
tanggalwaktu | Waktu Terakhir Diubah (LMT) untuk objek yang dikembalikan, dalam tanda kutip. Bidang ini kosong untuk operasi yang dapat mengembalikan beberapa objek. | Tuesday, 09-Aug-11 21:13:26 GMT |
<conditions-used> |
string | Daftar yang dipisahkan titik koma dalam bentuk ConditionName=value, dalam tanda kutip.
ConditionName bisa menjadi salah satu kondisi berikut:- 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> |
string | Nilai User-Agent header, dalam tanda kutip. |
"Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 6.1; WOW64; Trident/5.0)" |
<referrer-header> |
string | Nilai Referer header, dalam tanda kutip. |
"http://contoso.com/about.html" |
<client-request-id> |
string | Nilai x-ms-client-request-id header yang disertakan dalam permintaan, dalam tanda kutip. |
"8/9/2011 9:44:36 PM 45ef1c0f-8c71-4153-bc88-38589f63fbfc" |
Contoh entri log untuk versi 1.0
Get Blob
Contoh entri log berikut berlaku untuk permintaan GetBlob anonim:
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"
Masukkan Blob
Contoh entri log berikut berlaku untuk permintaan PutBlob resmi:
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"
Copy Blob
Contoh entri log berikut berlaku untuk permintaan CopyBlob resmi. Operasi Salin Blob akan mencatat 3 operasi: CopyBlob, CopyBlobSource, dan CopyBlobDestination. Perhatikan bahwa properti ID permintaan identik untuk ketiga operasi, tetapi ID operasi ditambahkan untuk setiap operasi.
Versi Layanan 2012-02-12 dan Yang Lebih Baru
Dalam versi 2012-02-12 dan yang lebih baru, <requested-object-key> adalah URL, yang menggantikan /accountname/containername/blobname format yang digunakan dalam versi sebelum 2012-02-12.
ID permintaan dan ID operasi ditahan untuk setiap entri log di bawah ini:
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"
Versi Layanan Sebelum 2012-02-12
ID permintaan dan ID operasi ditahan untuk setiap entri log di bawah ini:
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"
Format entri log 2.0
Format log Storage Analytics versi 2.0 menambahkan bidang untuk mendukung informasi pengelogan tentang permintaan yang diotorisasi dengan token OAuth 2.0 yang disediakan oleh Microsoft Entra ID. Untuk informasi selengkapnya, lihat Mengautentikasi dengan Microsoft Entra ID.
Setiap entri log versi 2.0 mematuhi format berikut:
<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>
Bidang entri log untuk versi 2.0
Tabel berikut mencantumkan dan menentukan bidang tambahan yang ditulis ke entri log versi 2.0. Semua bidang versi 1.0 disertakan dalam entri log versi 2.0.
| Nama Bidang | Jenis Bidang | Definisi | Contoh |
|---|---|---|---|
| UserObjectId | string | ID objek yang digunakan untuk autentikasi. Dapat berupa perwakilan keamanan apa pun, termasuk pengguna, identitas terkelola, atau perwakilan layanan. | 03124200-da00-4aa6-aa09-be77923d7870 |
| TenantId | string | ID penyewa yang digunakan dalam otorisasi pembawa. | 72f988bf-86f1-41af-91ab-2d7cd011db47 |
| ApplicationId | string | ID aplikasi yang digunakan dalam otorisasi pembawa. | 2cd20493-fe97-42ef-9ace-ab95b63d82c4 |
| ID sumber daya | string | ID sumber daya yang digunakan dalam otorisasi pembawa. | https://storage.azure.comhttps://storagesamples.blob.core.windows.net |
| Penerbit sertifikat | string | Pengeluar sertifikat yang digunakan dalam otorisasi pembawa. | https://sts.windows.net/72f988bf-86f1-41af-91ab-2d7cd011db47/ |
| UserPrincipalName | string | Nama utama pengguna yang digunakan dalam otorisasi pembawa. | testuser@azure.onmicrosoft.com |
| Dicadangkan | string | Disiapkan untuk penggunaan masa mendatang. Nilai adalah string kosong. | T/A |
| AuthorizationDetail | string | Informasi kebijakan terperinci yang digunakan untuk mengotorisasi permintaan. | [{"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"}] |
Contoh entri log untuk versi 2.0
Daftar 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"}]"
Letakkan Blok
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"}]"
Lihat juga
Tentang pengelogan Storage Analytics
Operasi Pencatatan dan Pesan Status Storage Analytics