Depolama Analizi günlük biçimi

Depolama Analizi günlüğe kaydetme, 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ız, kuyruklarınız ve bloblarınız üzerinde 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ızı sağlar.

Her günlük girişi, kullanımda olan Depolama Analizi günlüğü 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ş Olan Blob ve Kuyruk hizmetlerine yönelik istekler hakkındaki bilgileri günlüğe kaydetmeye yönelik alanlar ekler. Bu ek alanlar Günlük girişi biçimi 2.0'da açıklanmıştır. Blob ve Kuyruk hizmetleri için Azure AD ile kimlik doğrulaması şu anda önizleme aşamasındadı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 tüm alanlar HTML ile kodlanır ve tırnak içine alınır.

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:

Günlük girişi biçimi 1.0

Her sürüm 1.0 günlük girdisi 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ş 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 kesilirse, bu değer olarak Unknownayarlanabilir. 200
<end-to-end-latency-in-ms> süre Gelen isteği okuma ve isteği isteyene 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 yetkilendirildiğini, anonim olduğunu veya Paylaşılan Erişim İmzası (SAS) kullandığını gösterir. authenticated
<requester-account-name> string İstek yetkilendirilmişse depolama hesabı adıyla aynıdır. 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 tam URL'si, tırnak içinde. "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, Blobu Kopyala gibi birden fazla işlem gerektirir, ancak çoğu yalnızca bir işlem gerçekleştirir. 0
<requester-ip-address> string bağlantı noktası numarası da dahil olmak üzere istekte bulunanın 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 Tırnak içinde depolama hizmeti tarafından hesaplanan MD5 karması değeri. Bu alan boş olabilir. "3228b3cf1069a5489b298446321f8521"
<etag-identifier> string Döndürülen nesnenin tırnak içinde 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 noktalı virgülle ayrılmış bir liste ConditionName=value. 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 girişleri 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, Azure Active Directory(Azure AD) tarafından sağlanan OAuth 2.0 belirteci ile yetkilendirilmiş istekler hakkındaki günlük bilgilerini desteklemek için alanlar ekler. Blob ve Kuyruk hizmetleri için Azure AD kimlik doğrulaması ve yetkilendirme şu anda önizleme aşamasındadır. Daha fazla bilgi için bkz. Azure Active Directory ile kimlik doğrulama.

Her sürüm 2.0 günlük girdisi 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ş 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 girişlerine 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.com

https://storagesamples.blob.core.windows.net
Veren string Taşıyıcı yetkilendirmesinde kullanılan veren. https://sts.windows.net/72f988bf-86f1-41af-91ab-2d7cd011db47/
UserPrincipalName string Taşıyıcı yetkilendirmesinde 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&amp;comp=list&amp;prefix=&amp;delimiter=/&amp;marker=&amp;maxresults=30&amp;include=metadata&amp;_=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&amp;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