Formát protokolu Analýzy úložiště

Analýza úložiště protokolování záznamů o úspěšných i neúspěšných požadavcích na váš účet úložiště. Analýza úložiště protokoly umožňují zkontrolovat podrobnosti operací čtení, zápisu a odstranění v tabulkách, frontách a objektech blob Azure. Umožňují také prozkoumat příčiny neúspěšných požadavků, jako jsou vypršení časového limitu, omezování a chyby autorizace.

Každá položka protokolu odpovídá standardnímu formátu protokolu, který se řídí verzí používaného Analýza úložiště protokolování. Verze 1.0 obsahuje všechna pole popsaná ve formátu záznamu protokolu 1.0. Verze 2.0 přidává pole pro protokolování informací o požadavcích na služby Blob a Queue, které jsou autorizované tokenem OAuth 2.0. Tato další pole jsou popsána ve formátu záznamu protokolu 2.0. Ověřování pomocí Azure AD pro služby Blob a Queue je aktuálně ve verzi Preview.

První pole v položce protokolu vždy určuje číslo verze. Příjemci dat protokolování můžou závislosti na tomto poli a také následující aspekty položky protokolu:

  • Všechna pole, naplněná nebo prázdná, budou oddělena středníkem ";".

  • Každá položka protokolu je oddělena znakem nového řádku "\n"

  • Poslední pole v položce nebude končit středníkem ";".

Před zpracováním položky protokolu vždy zkontrolujte verzi.

Poznámka

Jakékoli pole, které může obsahovat uvozovku ("), středník (;) nebo nový řádek (\n) je kódovaný a citovaný kódEM HTML.

Nastavení verze protokolování

Pokud chcete nastavit verzi protokolování, zavolejte příslušnou operaci pro službu:

Formát položky protokolu 1.0

Každá položka protokolu verze 1.0 dodržuje následující formát:

<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>

Pole položky protokolu pro verzi 1.0

Následující tabulka uvádí a definuje pole v položce protokolu verze 1.0.

Název pole Typ pole Definice Příklad
<version-number> řetězec Verze protokolování Analýza úložiště sloužící k zaznamenání položky. 1.0
<request-start-time> časové razítko Čas v UTC, kdy byl požadavek přijat Analýza úložiště. 2011-08-09T21:44:36.2481552Z
<operation-type> řetězec Typ operace REST byl proveden. Seznam možných operací najdete v tématu Analýza úložiště Protokolované operace a stavové zprávy. GetBlob
<request-status> řetězec Stav požadované operace. Seznam možných stavových zpráv najdete v tématu Analýza úložiště Protokolované operace a stavové zprávy. Ve verzi 2017-04-17 a novějších ClientOtherError se nepoužívá. Místo toho toto pole obsahuje kód chyby. Success
<http-status-code> řetězec Stavový kód HTTP požadavku. Pokud je žádost přerušena, může být tato hodnota nastavena na Unknown. 200
<end-to-end-latency-in-ms> doba trvání Celkový čas v milisekundách k provedení požadované operace, včetně času čtení příchozího požadavku a odeslání odpovědi žadateli. 39
<server-latency-in-ms> doba trvání Celkový čas v milisekundách k provedení požadované operace Tato hodnota nezahrnuje latenci sítě (doba čtení příchozího požadavku a odeslání odpovědi žadateli). 22
<authentication-type> řetězec Určuje, jestli byl požadavek autorizovaný, anonymní nebo použitý sdílený přístupový podpis (SAS). authenticated
<requester-account-name> řetězec Stejný jako název účtu úložiště, pokud je požadavek autorizovaný. Toto pole bude prázdné pro anonymní žádosti a žádosti SAS. myaccount
<owner-account-name> řetězec Název účtu vlastníka služby. myaccount
<service-type> řetězec Požadovaná služba úložiště: objekt blob, tabulka nebo fronta blob
<request-url> řetězec Úplná adresa URL požadavku v uvozovkách. "https://myaccount.blob.core.windows.net/mycontainer/2025c44c-d25e-42bf-8507-7a5ca4faa034?timeout=30000"
<requested-object-key> řetězec Klíč požadovaného objektu v uvozovkách. Toto pole bude vždy používat název účtu, i když je nakonfigurovaný vlastní název domény. "/myaccount/mycontainer/2025c44c-d25e-42bf-8507-7a5ca4faa034"
<request-id-header> guid ID požadavku přiřazené službou úložiště. To odpovídá hodnotě hlavičky x-ms-request-id . 668a4744-7eb3-4e8f-b8d3-fbfd3829715b
<operation-count> int Počet každé zaprotokolované operace požadavku pomocí indexu nuly. Některé požadavky vyžadují více než jednu operaci, například kopírování objektu blob, i když většina provádí pouze jednu operaci. 0
<requester-ip-address> řetězec IP adresa žadatele, včetně čísla portu. 192.100.0.102:4362
<request-version-header> řetězec Verze služby úložiště zadaná při provedení požadavku. To odpovídá hodnotě hlavičky x-ms-version . 2009-09-19
<request-header-size> long Velikost hlavičky požadavku v bajtech Pokud požadavek není úspěšný, může být tato hodnota prázdná. 280
<request-packet-size> long Velikost paketů požadavků přečtených službou úložiště v bajtech. Pokud požadavek není úspěšný, může být tato hodnota prázdná. 0
<response-header-size> long Velikost hlavičky odpovědi v bajtech Pokud požadavek není úspěšný, může být tato hodnota prázdná. 216
<response-packet-size> long Velikost paketů odpovědí napsaných službou úložiště v bajtech. Pokud požadavek není úspěšný, může být tato hodnota prázdná. 0
<request-content-length> long Hodnota hlavičky Content-Length požadavku odeslaného do služby úložiště. Pokud byl požadavek úspěšný, je tato hodnota rovna <request-packet-size>. Pokud požadavek není úspěšný, nemusí být tato hodnota rovna <request-packet-size>nebo může být prázdná. 0
<request-md5> řetězec Hodnota hlavičky Content-MD5 nebo hlavičky x-ms-content-md5 v požadavku v uvozovkách. Hodnota hash MD5 zadaná v tomto poli představuje obsah požadavku. Toto pole může být prázdné. "788815fd0198be0d275ad329cafd1830"
<server-md5> řetězec Hodnota hodnoty hash MD5 vypočítané službou úložiště v uvozovkách. Toto pole může být prázdné. "3228b3cf1069a5489b298446321f8521"
<etag-identifier> řetězec Identifikátor značky ETag pro vrácený objekt v uvozovkách. "0x8D101F7E4B662C4"
<last-modified-time> datetime Čas poslední změny (LMT) pro vrácený objekt v uvozovkách. Toto pole je prázdné pro operace, které můžou vrátit více objektů. Tuesday, 09-Aug-11 21:13:26 GMT
<conditions-used> řetězec Středník oddělený seznam ve formě ConditionName=valueuvozovek. ConditionName může být jedna z následujících podmínek:

- 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> řetězec Hodnota User-Agent záhlaví v uvozovkách. "Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 6.1; WOW64; Trident/5.0)"
<referrer-header> řetězec Hodnota Referer záhlaví v uvozovkách. "http://contoso.com/about.html"
<client-request-id> řetězec Hodnota x-ms-client-request-id hlavičky zahrnutá v požadavku v uvozovkách. "8/9/2011 9:44:36 PM 45ef1c0f-8c71-4153-bc88-38589f63fbfc"

Ukázkové položky protokolu pro verzi 1.0

Získání objektu blob

Následující ukázková položka protokolu platí pro anonymní požadavek 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"

Vložení objektu blob

Následující ukázková položka protokolu platí pro autorizovaný požadavek 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"

Zkopírování objektu blob

Následující ukázkové položky protokolu platí pro autorizovaný požadavek CopyBlob . Operace kopírování objektu blob bude protokolovat 3 operace: CopyBlob, CopyBlobSource a CopyBlobDestination. Všimněte si, že vlastnost ID požadavku je stejná pro všechny tři operace, ale ID operace se pro každou operaci zvýší.

Verze služby 2012-02-12 a novější

Ve verzi 2012-02-12 a novější je <requested-object-key> adresa URL, která nahrazuje /accountname/containername/blobname formát použitý ve verzích před 2012-02-12.

ID požadavku a ID operace jsou tučné pro každou položku protokolu níže:

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"

Verze služeb starší než 2012-02-12

ID požadavku a ID operace jsou tučné pro každou položku protokolu níže:

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"

Formát položky protokolu 2.0

Analýza úložiště formát protokolu verze 2.0 přidává pole pro podporu protokolování informací o požadavcích autorizovaných pomocí tokenu OAuth 2.0 poskytovaného Azure Active Directory(Azure AD). Ověřování a autorizace pomocí Azure AD pro služby Blob a Queue je aktuálně ve verzi Preview. Další informace najdete v tématu Ověřování pomocí Azure Active Directory.

Každá položka protokolu verze 2.0 dodržuje následující formát:

<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>

Pole položky protokolu pro verzi 2.0

Následující tabulka uvádí a definuje další pole zapsaná do položky protokolu verze 2.0. Všechna pole verze 1.0 jsou součástí položek protokolu verze 2.0.

Název pole Typ pole Definice Příklad
UserObjectId řetězec ID objektu použité k ověřování. Může to být jakýkoli objekt zabezpečení, včetně uživatele, spravované identity nebo instančního objektu. 03124200-da00-4aa6-aa09-be77923d7870
TenantId řetězec ID tenanta použitého při autorizaci nosné verze 72f988bf-86f1-41af-91ab-2d7cd011db47
ApplicationId řetězec ID aplikace použité při autorizaci nosné aplikace. 2cd20493-fe97-42ef-9ace-ab95b63d82c4
ID prostředku řetězec ID prostředku používaného při autorizaci nosné verze https://storage.azure.com

https://storagesamples.blob.core.windows.net
Vystavitel řetězec Vystavitel používaný při autorizaci nosné https://sts.windows.net/72f988bf-86f1-41af-91ab-2d7cd011db47/
UserPrincipalName řetězec Hlavní název uživatele používaný při autorizaci nosné osoby. testuser@azure.onmicrosoft.com
Vyhrazené řetězec Vyhrazeno pro budoucí použití. Hodnota je prázdný řetězec.
AuthorizationDetail řetězec Podrobné informace o zásadách, které slouží k autorizaci žádosti. [{"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"}]

Ukázkové položky protokolu pro verzi 2.0

Výpis objektů 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&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"}]"

Vložit 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&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"}]"

Viz také

Informace o protokolování Analýza úložiště
Analýza úložiště protokolovaných operací a stavových zpráv