Protokolování analýz služby Azure Storage

Analýza úložiště protokoluje podrobné informace o úspěšných a neúspěšných požadavcích na službu úložiště. Tyto informace je možné použít k monitorování jednotlivých požadavků a diagnostice problémů se službou úložiště. Požadavky se protokolují s maximálním úsilím. To znamená, že většina požadavků bude mít za následek záznam protokolu, ale úplnost a včasnost Analýza úložiště protokolů nejsou zaručené.

Protokolování Analýzy úložiště ve výchozím nastavení není pro váš účet úložiště povolené. Můžete ho povolit v Azure Portal, pomocí PowerShellu nebo Azure CLI. Podrobné pokyny najdete v tématu Povolení a správa protokolů azure Analýza úložiště (classic).

Protokoly Analýza úložiště můžete povolit také programově prostřednictvím rozhraní REST API nebo klientské knihovny. K povolení Analýza úložiště pro každou službu použijte operace Získat vlastnosti služby Blob Service, Načíst vlastnosti služby Fronta a Načíst vlastnosti služby Table Service. Příklad, který umožňuje Analýza úložiště protokoly pomocí .NET, najdete v tématu Povolení protokolů.

Položky protokolu se vytvářejí pouze v případě, že jsou na koncový bod služby provedeny požadavky. Pokud má například účet úložiště aktivitu v koncovém bodu objektu blob, ale ne v koncových bodech tabulky nebo fronty, vytvoří se jenom protokoly týkající se služby Blob Service.

Protokolování požadavků přihlášených

Protokolování ověřených požadavků

Protokolují se následující typy ověřovaných požadavků:

• Úspěšné požadavky

• Neúspěšné požadavky, včetně vypršení časového limitu, omezování, chyb sítě, selhání autorizace a dalších chyb

• Požadavky používající SAS (Shared Access Signature) nebo OAuth (Open Authorization), včetně neúspěšných i úspěšných požadavků

• Žádosti o analytická data

  Požadavky provedené samotnými Analýza úložiště, jako je vytvoření nebo odstranění protokolu, se neprotokolují. Úplný seznam zaprotokolovaných dat je zdokumentovaný v tématech Analýza úložiště Protokolované operace a stavové zprávy a Analýza úložiště formát protokolu.

Protokolování anonymních požadavků

Protokolují se následující typy anonymních požadavků:

• Úspěšné požadavky

• Chyby serveru

• Chyby vypršení časového limitu pro klienta i server

• Neúspěšné požadavky GET s kódem chyby 304 (Nezměněno)

  Všechny ostatní neúspěšné anonymní požadavky se neprotokolují. Úplný seznam zaprotokolovaných dat je zdokumentovaný v tématech Analýza úložiště Protokolované operace a stavové zprávy a Analýza úložiště formát protokolu.

Jak se protokoly ukládají

Všechny protokoly se ukládají v objektech blob bloku v kontejneru s názvem $logs, který se automaticky vytvoří, když je pro účet úložiště povolená Analýza úložiště. Kontejner $logs se nachází v oboru názvů objektů blob účtu úložiště, například: http://<accountname>.blob.core.windows.net/$logs. Tento kontejner nelze po povolení Analýza úložiště odstranit, i když je možné odstranit jeho obsah. Pokud pomocí nástroje pro procházení úložiště přejdete přímo do kontejneru, zobrazí se všechny objekty blob, které obsahují data protokolování.

Jak se protokolují požadavky, Analýza úložiště nahrají mezivýsledky jako bloky. Pravidelně Analýza úložiště tyto bloky zapíše a zpřístupní je jako objekt blob. Může trvat až hodinu, než se data protokolu zobrazí v objektech blob v kontejneru $logs , protože frekvence, s jakou služba úložiště vyprázdní zapisovače protokolů. Pro protokoly vytvořené ve stejnou hodinu můžou existovat duplicitní záznamy. To, jestli je záznam duplicitní, můžete zjistit tak, že zkontrolujete Id požadavku a číslo operace .

Pokud máte velký objem dat protokolu s více soubory za každou hodinu, můžete pomocí metadat objektů blob určit, jaká data protokol obsahuje, prozkoumáním polí metadat objektů blob. To je také užitečné, protože při zápisu dat do souborů protokolu může někdy docházet ke zpoždění: metadata objektů blob poskytují přesnější informace o obsahu objektu blob než název objektu blob.

Většina nástrojů pro procházení úložiště umožňuje zobrazit metadata objektů blob. Tyto informace si můžete přečíst také pomocí PowerShellu nebo programově. Následující fragment kódu PowerShellu je příkladem filtrování seznamu objektů blob protokolu podle názvu a určení času a metadat, aby se identifikovaly pouze protokoly, které obsahují operace zápisu .

Get-AzStorageBlob -Container '$logs' |  
Where-Object {  
    $_.Name -match 'blob/2014/05/21/05' -and   
    $_.ICloudBlob.Metadata.LogType -match 'write'  
} |  
ForEach-Object {  
    "{0}  {1}  {2}  {3}" -f $_.Name,   
    $_.ICloudBlob.Metadata.StartTime,   
    $_.ICloudBlob.Metadata.EndTime,   
    $_.ICloudBlob.Metadata.LogType  
}  

Informace o programovém výpisu objektů blob najdete v tématech Výčet prostředků objektů blob a Nastavení a Načítání vlastností a metadat pro prostředky objektů blob.

Zásady vytváření názvů protokolů

Každý protokol bude zapsán v následujícím formátu:

<service-name>/YYYY/MM/DD/hhmm/<counter>.log

Následující tabulka popisuje jednotlivé atributy v názvu protokolu:

Následuje úplný název ukázkového protokolu, který kombinuje výše uvedené příklady:

blob/2011/07/31/1800/000001.log

Následuje ukázkový identifikátor URI, který je možné použít pro přístup k výše uvedenému protokolu:

https://<accountname>.blob.core.windows.net/$logs/blob/2011/07/31/1800/000001.log

Když se zaprotokoluje požadavek na úložiště, výsledný název protokolu odpovídá hodině, kdy se požadovaná operace dokončila. Pokud se například žádost GetBlob dokončila 31. 7. 2011 v 18:30, protokol se zapíše s následující předponou: blob/2011/07/31/1800/

Metadata protokolu

Všechny objekty blob protokolu se ukládají s metadaty, která se dají použít k identifikaci dat protokolování, která objekt blob obsahuje. Následující tabulka popisuje jednotlivé atributy metadat:

Následující seznam zobrazuje kompletní ukázková metadata s využitím výše uvedených příkladů:

• LogType=write
• StartTime=2011-07-31T18:21:46Z
• EndTime=2011-07-31T18:22:09Z
• LogVersion=1.0

Položky protokolu

Následující části ukazují ukázkovou položku protokolu pro každou podporovanou službu Azure Storage.

Příklad položky protokolu pro Blob Storage

2.0;2022-01-03T20:34:54.4617505Z;PutBlob;SASSuccess;201;7;7;sas;;logsamples;blob;https://logsamples.blob.core.windows.net/container1/1.txt?se=2022-02-02T20:34:54Z&sig=XXXXX&sp=rwl&sr=c&sv=2020-04-08&timeout=901;"/logsamples/container1/1.txt";xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx;0;71.197.193.44:53371;2019-12-12;654;13;337;0;13;"xxxxxxxxxxxxxxxxxxxxx==";"xxxxxxxxxxxxxxxxxxxxx==";""0x8D9CEF88004E296"";Monday, 03-Jan-22 20:34:54 GMT;;"Microsoft Azure Storage Explorer, 1.20.1, win32, azcopy-node, 2.0.0, win32, AzCopy/10.11.0 Azure-Storage/0.13 (go1.15; Windows_NT)";;"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx";;;;;;;;

Příklad položky protokolu pro Blob Storage (Data Lake Storage Gen2 povoleno)

2.0;2022-01-04T22:50:56.0000775Z;RenamePathFile;Success;201;49;49;authenticated;logsamples;logsamples;blob;"https://logsamples.dfs.core.windows.net/my-container/myfileorig.png?mode=legacy";"/logsamples/my-container/myfilerenamed.png";xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx;0;73.157.16.8;2020-04-08;591;0;224;0;0;;;;Friday, 11-Jun-21 17:58:15 GMT;;"Microsoft Azure Storage Explorer, 1.19.1, win32 azsdk-js-storagedatalake/12.3.1 (NODE-VERSION v12.16.3; Windows_NT 10.0.22000)";;"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx";;;;;;;;

Příklad položky protokolu pro Queue Storage

2.0;2022-01-03T20:35:04.6097590Z;PeekMessages;Success;200;5;5;authenticated;logsamples;logsamples;queue;https://logsamples.queue.core.windows.net/queue1/messages?numofmessages=32&peekonly=true&timeout=30;"/logsamples/queue1";xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx;0;71.197.193.44:53385;2020-04-08;536;0;232;62;0;;;;;;"Microsoft Azure Storage Explorer, 1.20.1, win32 azsdk-js-storagequeue/12.3.1 (NODE-VERSION v12.16.3; Windows_NT 10.0.22000)";;"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx";;;;;;;;

Příklad položky protokolu pro Table Storage

1.0;2022-01-03T20:35:13.0719766Z;CreateTable;Success;204;30;30;authenticated;logsamples;logsamples;table;https://logsamples.table.core.windows.net/Tables;"/logsamples/Table1";xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx;0;71.197.193.44:53389;2018-03-28;601;22;339;0;22;;;;;;"Microsoft Azure Storage Explorer, 1.20.1, win32, Azure-Storage/2.10.3 (NODE-VERSION v12.16.3; Windows_NT 10.0.22000)";;"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx"

Další kroky

• Povolení a správa Analýzy úložiště Azure (klasické)
• formát protokolu Analýza úložiště
• Analýza úložiště protokolovaných operací a stavových zpráv
• Analýza úložiště Metriky (klasické)