Depolama Analizi günlük biçimi
Depolama Analizi günlüğe kaydetme işlemi, depolama hesabınız için hem başarılı hem de başarısız isteklerin ayrıntılarını kaydeder. Depolama Analizi günlükleri, Azure tablolarınıza, kuyruklarınıza ve bloblarınıza yönelik okuma, yazma ve silme işlemlerinin ayrıntılarını gözden geçirmenize olanak tanır. Ayrıca zaman aşımları, azaltma ve yetkilendirme hataları gibi başarısız isteklerin nedenlerini araştırmanıza da olanak tanır.
Her günlük girişi, kullanımda olan Depolama Analizi oturum açma sürümü tarafından yönetilen standart bir günlük biçimine uygundur. Sürüm 1.0, Günlük giriş biçimi 1.0'da açıklanan tüm alanları içerir. Sürüm 2.0, OAuth 2.0 belirteci ile yetkilendirilmiş Blob ve Kuyruk hizmetlerine yönelik istekler hakkındaki günlük bilgileri için alanlar ekler. Bu ek alanlar Günlük girişi biçimi 2.0'da açıklanmıştır.
Günlük girdisindeki ilk alan her zaman sürüm numarasını belirtir. Günlük verilerinin tüketicileri hem bu alana hem de bir günlük girişinin aşağıdaki yönlerine bağımlı olabilir:
Doldurulan veya boş olan tüm alanlar noktalı virgülle ";" ayrılır
Her günlük girdisi yeni satır karakteri "\n" ile ayrılır
Girdideki son alan noktalı virgülle bitmeyecek ";"
Günlük girdisini işlemeden önce her zaman sürümü denetleyin.
Not
Tırnak ("), noktalı virgül (;) veya yeni satır (\n) içerebilen herhangi bir alan HTML kodlamalı ve tırnak içine alınmış olur.
Günlük sürümünü ayarlama
Günlük sürümünü ayarlamak için hizmet için uygun işlemi çağırın:
- Blob hizmeti:Blob Hizmeti Özelliklerini Ayarlama (hem 1.0 hem de 2.0 sürümlerini destekler)
- Kuyruk hizmeti:Kuyruk Hizmeti Özelliklerini Ayarlama (hem 1.0 hem de 2.0 sürümlerini destekler)
- Tablo hizmeti:Tablo Hizmeti Özelliklerini Ayarla (yalnızca sürüm 1.0'ı destekler)
Günlük girişi biçimi 1.0
Her sürüm 1.0 günlük girişi aşağıdaki biçime uyar:
<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>
Sürüm 1.0 için günlük girişi alanları
Aşağıdaki tabloda sürüm 1.0 günlük girdisindeki alanlar listelenip tanımlandı.
| Alan Adı | Alan Türü | Tanım | Örnek |
|---|---|---|---|
<version-number> |
string | Girişi kaydetmek için kullanılan Depolama Analizi günlüğü sürümü. | 1.0 |
<request-start-time> |
timestamp | İsteğin Depolama Analizi tarafından alındığı UTC saati. | 2011-08-09T21:44:36.2481552Z |
<operation-type> |
string | Gerçekleştirilen REST işleminin türü. Olası işlemlerin listesi için Depolama Analizi Günlüğe Kaydedilen İşlemler ve Durum İletileri konusuna bakın. | GetBlob |
<request-status> |
string | İstenen işlemin durumu. Olası durum iletilerinin listesi için Depolama Analizi Günlüğe Kaydedilen İşlemler ve Durum İletileri konusuna bakın. Sürüm 2017-04-17 ve sonraki ClientOtherError sürümlerde kullanılmaz. Bunun yerine, bu alan hata kodunu içerir. |
Success |
<http-status-code> |
string | İsteğin HTTP durum kodu. İstek kesintiye uğrarsa, bu değer olarak Unknownayarlanabilir. |
200 |
<end-to-end-latency-in-ms> |
süre | Gelen isteği okuma ve isteği gönderene yanıt gönderme süresi de dahil olmak üzere istenen işlemi gerçekleştirmek için milisaniye cinsinden toplam süre. | 39 |
<server-latency-in-ms> |
süre | İstenen işlemi gerçekleştirmek için milisaniye cinsinden toplam süre. Bu değer ağ gecikme süresini (gelen isteği okuma ve yanıtı istekte bulunana gönderme süresi) içermez. | 22 |
<authentication-type> |
string | İsteğin yetkilendirilmiş, anonim veya kullanılmış Paylaşılan Erişim İmzası (SAS) olup olmadığını gösterir. | authenticated |
<requester-account-name> |
string | İstek yetkilendirilmişse depolama hesabı adıyla aynı. Bu alan anonim ve SAS istekleri için boş olacaktır. | myaccount |
<owner-account-name> |
string | Hizmet sahibinin hesap adı. | myaccount |
<service-type> |
string | İstenen depolama hizmeti: blob, tablo veya kuyruk. | blob |
<request-url> |
string | İsteğin tırnak içinde tam URL'si. | "https://myaccount.blob.core.windows.net/mycontainer/2025c44c-d25e-42bf-8507-7a5ca4faa034?timeout=30000" |
<requested-object-key> |
string | tırnak içinde istenen nesnenin anahtarı. Özel bir etki alanı adı yapılandırılmış olsa bile bu alan her zaman hesap adını kullanır. | "/myaccount/mycontainer/2025c44c-d25e-42bf-8507-7a5ca4faa034" |
<request-id-header> |
guid | Depolama hizmeti tarafından atanan istek kimliği. Bu, üst bilginin değerine x-ms-request-id eşdeğerdir. |
668a4744-7eb3-4e8f-b8d3-fbfd3829715b |
<operation-count> |
int | Sıfır dizini kullanılarak bir istek için günlüğe kaydedilen her işlemin sayısı. Bazı istekler birden fazla işlem gerektirir, örneğin Blobu Kopyala, ancak çoğu tek bir işlem gerçekleştirir. | 0 |
<requester-ip-address> |
string | bağlantı noktası numarası dahil olmak üzere istek sahibinin IP adresi. | 192.100.0.102:4362 |
<request-version-header> |
string | İstek yapıldığında belirtilen depolama hizmeti sürümü. Bu, üst bilginin değerine x-ms-version eşdeğerdir. |
2009-09-19 |
<request-header-size> |
long | İstek üst bilgisinin bayt cinsinden boyutu. İstek başarısız olursa, bu değer boş olabilir. | 280 |
<request-packet-size> |
long | Depolama hizmeti tarafından okunan istek paketlerinin bayt cinsinden boyutu. İstek başarısız olursa, bu değer boş olabilir. | 0 |
<response-header-size> |
long | Yanıt üst bilgisinin bayt cinsinden boyutu. İstek başarısız olursa, bu değer boş olabilir. | 216 |
<response-packet-size> |
long | Depolama hizmeti tarafından yazılan yanıt paketlerinin bayt cinsinden boyutu. İstek başarısız olursa, bu değer boş olabilir. | 0 |
<request-content-length> |
long | Depolama hizmetine gönderilen isteğin üst bilgisinin değeri Content-Length . İstek başarılı olursa, bu değer değerine <request-packet-size>eşittir. İstek başarısız olursa, bu değer değerine eşit <request-packet-size>olmayabilir veya boş olabilir. |
0 |
<request-md5> |
string | İstekteki Content-MD5 üst bilgisinin veya x-ms-content-md5 üst bilgisinin tırnak içinde değeri. Bu alanda belirtilen MD5 karma değeri, istekteki içeriği temsil eder. Bu alan boş olabilir. | "788815fd0198be0d275ad329cafd1830" |
<server-md5> |
string | MD5 karması değeri, tırnak içinde depolama hizmeti tarafından hesaplanır. Bu alan boş olabilir. | "3228b3cf1069a5489b298446321f8521" |
<etag-identifier> |
string | Tırnak içinde döndürülen nesnenin ETag tanımlayıcısı. | "0x8D101F7E4B662C4" |
<last-modified-time> |
datetime | Tırnak içinde döndürülen nesne için Son Değiştirme Zamanı (LMT). Bu alan, birden çok nesne döndürebilen işlemler için boş. | Tuesday, 09-Aug-11 21:13:26 GMT |
<conditions-used> |
string | biçiminde, tırnak içinde ConditionName=valuenoktalı virgülle ayrılmış bir liste.
ConditionName aşağıdaki koşullardan biri olabilir:- 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 |
User-Agent Tırnak içinde üst bilgi değeri. |
"Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 6.1; WOW64; Trident/5.0)" |
<referrer-header> |
string |
Referer Tırnak içinde üst bilgi değeri. |
"http://contoso.com/about.html" |
<client-request-id> |
string |
x-ms-client-request-id İstekte tırnak içinde yer alan üst bilgi değeri. |
"8/9/2011 9:44:36 PM 45ef1c0f-8c71-4153-bc88-38589f63fbfc" |
Sürüm 1.0 için örnek günlük girdileri
Blob Alma
Aşağıdaki örnek günlük girişi anonim bir GetBlob isteği için geçerlidir:
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"
İkili Büyük Nesne Koyma
Aşağıdaki örnek günlük girişi yetkili bir PutBlob isteği için geçerlidir:
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"
İkili Büyük Nesneyi Kopyalama
Aşağıdaki örnek günlük girdileri yetkili bir CopyBlob isteği için geçerlidir. Blobu Kopyala işlemi 3 işlemi günlüğe kaydeder: CopyBlob, CopyBlobSource ve CopyBlobDestination. İstek kimliği özelliğinin üç işlem için de aynı olduğunu, ancak her işlem için işlem kimliğinin artırıldığını unutmayın.
Hizmet Sürümü 2012-02-12 ve Daha Yeni
2012-02-12 ve daha yeni sürümlerde , <requested-object-key> 2012-02-12 öncesi sürümlerde kullanılan biçimin yerini /accountname/containername/blobname alan bir URL'dir.
İstek kimliği ve işlem kimliği aşağıdaki her günlük girdisi için kalın yazı tipindedir:
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 Öncesi Hizmet Sürümleri
İstek kimliği ve işlem kimliği aşağıdaki her günlük girdisi için kalın yazı tipindedir:
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"
Günlük girişi biçimi 2.0
Depolama Analizi günlük biçimi sürüm 2.0, Microsoft Entra ID tarafından sağlanan OAuth 2.0 belirteciyle yetkilendirilmiş istekler hakkındaki günlük bilgilerini desteklemek için alanlar ekler. Daha fazla bilgi için bkz. Microsoft Entra ID ile kimlik doğrulama.
Her sürüm 2.0 günlük girişi aşağıdaki biçime uyar:
<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>
Sürüm 2.0 için günlük girişi alanları
Aşağıdaki tabloda sürüm 2.0 günlük girdisine yazılan ek alanlar listelenip tanımlandı. Tüm sürüm 1.0 alanları sürüm 2.0 günlük girdilerine dahil edilir.
| Alan Adı | Alan Türü | Tanım | Örnek |
|---|---|---|---|
| UserObjectId | string | Kimlik doğrulaması için kullanılan nesne kimliği. Kullanıcı, yönetilen kimlik veya hizmet sorumlusu dahil olmak üzere herhangi bir güvenlik sorumlusu olabilir. | 03124200-da00-4aa6-aa09-be77923d7870 |
| TenantId | string | Taşıyıcı yetkilendirmede kullanılan kiracı kimliği. | 72f988bf-86f1-41af-91ab-2d7cd011db47 |
| ApplicationID | string | Taşıyıcı yetkilendirmede kullanılan uygulama kimliği. | 2cd20493-fe97-42ef-9ace-ab95b63d82c4 |
| Kaynak kimliği | string | Taşıyıcı yetkilendirmede kullanılan kaynak kimliği. | https://storage.azure.comhttps://storagesamples.blob.core.windows.net |
| Veren | string | Taşıyıcı yetkilendirmede kullanılan veren. | https://sts.windows.net/72f988bf-86f1-41af-91ab-2d7cd011db47/ |
| UserPrincipalName | string | Taşıyıcı yetkilendirmede kullanılan kullanıcı asıl adı. | testuser@azure.onmicrosoft.com |
| Ayrılmıştır | string | Daha sonraki kullanımlar için ayrılmıştır. Değer boş bir dizedir. | Yok |
| AuthorizationDetail | string | İsteği yetkilendirmek için kullanılan ayrıntılı ilke bilgileri. | [{"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"}] |
Sürüm 2.0 için örnek günlük girdileri
Blobları Listeleme
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"}]"
Blok Koy
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"}]"
Ayrıca bkz.
Depolama Analizi günlüğü hakkında
Günlüğe Kaydedilen İşlemleri ve Durum İletilerini Depolama Analizi