Azure Depolama analizini günlüğe kaydetme

Depolama Analizi, bir depolama cihazına gönderilen başarılı ve başarısız isteklerle ilgili ayrıntılı bilgileri günlüğe kaydeder. Bu bilgileri kullanarak istekleri ayrı ayrı izleyebilir ve depolama hizmetiyle ilgili sorunları tanılayabilirsiniz. İstekler en iyi çaba temelinde günlüğe kaydedilir. Bu, çoğu isteğin bir günlük kaydına neden olacağı, ancak Depolama Analizi günlüklerin eksiksiz ve zamanında olması garanti edilmediği anlamına gelir.

Depolama Analizi günlüğe kaydetme özelliği depolama hesabınızda varsayılan olarak etkin değildir. Azure portalında veya PowerShell veya Azure CLI kullanarak etkinleştirebilirsiniz. Adım adım yönergeler için bkz. Azure Depolama Analizi günlüklerini (klasik) etkinleştirme ve yönetme.

Depolama Analizi günlüklerini REST API veya istemci kitaplığı aracılığıyla program aracılığıyla da etkinleştirebilirsiniz. Her hizmet için Depolama Analizi etkinleştirmek için Blob Hizmeti Özelliklerini Al, Kuyruk Hizmeti Özelliklerini Al ve Tablo Hizmeti Özelliklerini Al işlemlerini kullanın. .NET kullanarak Depolama Analizi günlüklerini etkinleştiren bir örnek görmek için bkz. Günlükleri etkinleştirme

Günlük girdileri yalnızca hizmet uç noktasına yönelik istekler olduğunda oluşturulur. Örneğin, bir depolama hesabının Blob uç noktasında etkinliği varsa ancak Tablo veya Kuyruk uç noktalarında etkinlik yoksa, yalnızca Blob hizmetiyle ilgili günlükler oluşturulur.

Günlüğe kaydedilen istekler

Kimliği doğrulanmış istekleri günlüğe kaydetme

Aşağıdaki türden kimliği doğrulanmış istekler kaydedilir:

• Başarılı istekler

• Zaman aşımı, azaltma, ağ, yetkilendirme hatalarını ve diğer hataları içeren başarısız istekler

• Başarısız ve başarılı istekler de dahil olmak üzere Paylaşılan Erişim İmzası (SAS) veya OAuth kullanan istekler

• Analiz verisi istekleri

  günlük oluşturma veya silme gibi Depolama Analizi tarafından yapılan istekler günlüğe kaydedilmez. Günlüğe kaydedilen verilerin tam listesi Depolama Analizi Günlüğe Kaydedilen İşlemler ve Durum İletileri ile Depolama Analizi Günlük Biçimi konularında belgelenmiştir.

Anonim istekleri günlüğe kaydetme

Aşağıdaki anonim istek türleri günlüğe kaydedilir:

• Başarılı istekler

• Sunucu hataları

• hem istemci hem de sunucu için zaman aşımı hataları

• 304 hata koduna sahip başarısız GET istekleri (Değiştirilmemiş)

  Diğer tüm başarısız anonim istekler günlüğe kaydedilmez. Günlüğe kaydedilen verilerin tam listesi Depolama Analizi Günlüğe Kaydedilen İşlemler ve Durum İletileri ile Depolama Analizi Günlük Biçimi konularında belgelenmiştir.

Günlükler nasıl depolanır?

Tüm günlükler, depolama hesabı için Depolama Analizi etkinleştirildiğinde otomatik olarak oluşturulan adlı $logskapsayıcıdaki blok bloblarında depolanır. Kapsayıcı $logs , depolama hesabının blob ad alanında bulunur, örneğin: http://<accountname>.blob.core.windows.net/$logs. bu kapsayıcı, Depolama Analizi etkinleştirildikten sonra silinemez, ancak içeriği silinebilir. Depolama gözatma aracınızı kullanarak doğrudan kapsayıcıya giderseniz günlük verilerinizi içeren tüm blobları görürsünüz.

İstekler günlüğe kaydedilirken Depolama Analizi ara sonuçları blok olarak karşıya yükler. Depolama Analizi düzenli aralıklarla bu blokları işler ve blob olarak kullanılabilir hale getirir. Depolama hizmetinin günlük yazıcılarını temizleme sıklığı nedeniyle günlük verilerinin $logs kapsayıcıdaki bloblarda görünmesi bir saate kadar sürebilir. Aynı saatte oluşturulan günlükler için yinelenen kayıtlar bulunabilir. RequestId ve İşlem numarasını denetleyerek kaydın yinelenen bir kayıt olup olmadığını belirleyebilirsiniz.

Her saat için birden çok dosya içeren yüksek hacimli günlük verileriniz varsa blob meta verilerini kullanarak blob meta verileri alanlarını inceleyerek günlüğün hangi verileri içerdiğini belirleyebilirsiniz. Veriler günlük dosyalarına yazılırken bazen bir gecikme olabileceğinden bu da yararlıdır: blob meta verileri blob içeriği hakkında blob adından daha doğru bir gösterge sağlar.

Çoğu depolama gözatma aracı blobların meta verilerini görüntülemenizi sağlar; Bu bilgileri PowerShell kullanarak veya program aracılığıyla da okuyabilirsiniz. Aşağıdaki PowerShell kod parçacığı, günlük blobları listesini ada göre filtreleyerek bir saat ve meta verilere göre yalnızca yazma işlemleri içeren günlükleri tanımlamaya yönelik bir örnektir.

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  
}  

Blobları program aracılığıyla listeleme hakkında bilgi için bkz. Blob Kaynaklarını Numaralandırma ve Blob Kaynakları için Özellikleri ve Meta Verileri Ayarlama ve Alma.

Günlük adlandırma kuralları

Her günlük aşağıdaki biçimde yazılır:

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

Aşağıdaki tabloda günlük adındaki her öznitelik açıklanmaktadır:

Aşağıda, yukarıdaki örnekleri birleştiren eksiksiz bir örnek günlük adı verilmiştir:

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

Yukarıdaki günlüğe erişmek için kullanılabilecek örnek bir URI aşağıda verilmiştir:

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

Depolama isteği günlüğe kaydedildiğinde, sonuçta elde edilen günlük adı istenen işlemin tamamlandığı saatle ilişkilendirilir. Örneğin, bir GetBlob isteği 31.07.2011 saat 18:30'da tamamlandıysa, günlük aşağıdaki ön ek ile yazılır: blob/2011/07/31/1800/

Günlük meta verileri

Tüm günlük blobları, blobda hangi günlük verilerinin bulunduğunu belirlemek için kullanılabilecek meta verilerle depolanır. Aşağıdaki tabloda her meta veri özniteliği açıklanmaktadır:

Aşağıdaki liste, yukarıdaki örnekleri kullanarak tam örnek meta verileri görüntüler:

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

Günlük girdileri

Aşağıdaki bölümlerde desteklenen her Azure Depolama hizmeti için örnek bir günlük girdisi gösterilmektedir.

Blob Depolama için örnek günlük girdisi

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;172.16.0.0: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";;;;;;;;

Blob Depolama için örnek günlük girdisi (Data Lake Storage etkin)

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;172.16.0.0;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";;;;;;;;

Kuyruk Depolama için örnek günlük girdisi

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;172.16.0.0: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";;;;;;;;

Tablo Depolama için örnek günlük girdisi

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;172.16.0.0: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"

Sonraki adımlar

• Azure Depolama Analizi günlüklerini (klasik) etkinleştirme ve yönetme
• Depolama Analizi Günlük Biçimi
• Günlüğe Kaydedilen İşlemleri ve Durum İletilerini Depolama Analizi
• Depolama Analizi Ölçümleri (klasik)