تسجيل Azure Storage Analytics

  • مقالة

تقوم سجلات Storage Analytics بتقديم معلومات مفصلة حول الطلبات الناجحة والفاشلة لأي خدمة تخزين. يمكن استخدام هذه المعلومات لمراقبة الطلبات الفردية وتشخيص المشكلات المتعلقة بخدمة التخزين. يتم تسجيل الطلبات على أساس أفضل جهد. وهذا يعني أن معظم الطلبات ستؤدي إلى تسجيل سجل، ولكن اكتمال سجلات Storage Analytics وحسن توقيتها غير مضمونين.

ملاحظة

نوصي باستخدام سجلات Azure Storage في Azure Monitor بدلاً من سجلات Storage Analytics. لمعرفة المزيد، راجع أي من المقالات التالية:

لا يتم تمكين تسجيل Storage Analytics بشكل افتراضي لحساب التخزين الخاص بك. يمكنك تمكينه في مدخل Microsoft Azure أو باستخدام PowerShell أو Azure CLI. للحصول على إرشادات خطوة بخطوة، راجع تمكين سجلات Azure Storage Analytics وإدارتها (كلاسيكية).

يمكنك أيضاً تمكين سجلات Storage Analytics برمجياً عبر واجهة برمجة تطبيقات REST أو مكتبة العميل. استخدم عمليات الحصول على خصائص خدمة Blob، و الحصول على خصائص خدمة قائمة الانتظار و الحصول على خصائص خدمة الجدول لتمكين Storage Analytics لكل خدمة. للاطلاع على مثال يمكن سجلات Storage Analytics باستخدام .NET، راجع تمكين السجلات

يتم إنشاء إدخالات السجل فقط إذا كانت هناك طلبات تم إجراؤها على نقطة نهاية الخدمة. على سبيل المثال، إذا كان لحساب تخزين نشاط في نقطة نهاية Blob الخاصة به ولكن ليس في نقاط نهاية الجدول أو قائمة الانتظار الخاصة به، سيتم إنشاء السجلات المتعلقة بخدمة Blob فقط.

ملاحظة

تتوفر خدمة تسجيل Storage Analytics حالياً فقط لخدمات Blob وقائمة الانتظار والجدول. يتوفر تسجيل Storage Analytics أيضاً لحسابات BlockBlobStorage عالية الأداء. ومع ذلك، فهو غير متوفر لحسابات v2 للأغراض العامة ذات الأداء المتميز.

الطلبات المسجلة في التسجيل

تسجيل الطلبات المصادق عليها

تُسجل الأنواع التالية من طلبات التخويل:

  • طلبات ناجحة

  • الطلبات الفاشلة، بما في ذلك أخطاء المهلة، والتقييد، والشبكة، والتخويل، والأخطاء الأخرى

  • طلبات باستخدام توقيع الوصول المشترك (SAS) أو OAuth، بما في ذلك الطلبات الفاشلة والناجحة

  • طلبات إلى بيانات التحليل

    لا يتم تسجيل الطلبات المقدمة من Storage Analytics نفسها، مثل إنشاء السجل أو حذفه. يتم توثيق قائمة كاملة بالبيانات المسجلة في موضوعات العمليات المسجلة لـ Storage Analytics ورسائل الحالة و تنسيق سجل Storage Analytics.

تسجيل طلبات مجهولة المصدر

يتم تسجيل الأنواع التالية من الطلبات المجهولة:

ملاحظة

يسجل Storage Analytics جميع المكالمات الداخلية إلى مستوى البيانات. يتم أيضاً تسجيل المكالمات الواردة من موفر موارد Azure Storage. لتحديد هذه الطلبات، ابحث عن سلسلة الاستعلام <sk=system-1> في عنوان URL للطلب.

كيفية تخزين السجلات

يتم تخزين جميع السجلات في كتلة الكائنات الثنائية كبيرة الحجم في حاوية تسمى $logs، والتي يتم إنشاؤها تلقائياً عند تمكين Storage Analytics لحساب تخزين. توجد الحاوية $logs في مساحة اسم الكائن الثنائي كبير الحجم لحساب التخزين، على سبيل المثال: http://<accountname>.blob.core.windows.net/$logs. لا يمكن حذف هذه الحاوية بمجرد تمكين Storage Analytics، على الرغم من إمكانية حذف محتوياتها. إذا كنت تستخدم أداة تصفح التخزين للانتقال إلى الحاوية مباشرة، فسترى جميع الكائنات الثنائية كبيرة الحجم التي تحتوي على بيانات التسجيل الخاصة بك.

ملاحظة

لا يتم عرض الحاوية $logs عند تنفيذ أي عملية لسرد حاويات، مثل عملية سرد الحاويات. يجب الوصول إليها مباشرة. على سبيل المثال، يمكنك استخدام عملية سرد الكائنات الثنائية كبيرة الحجم للوصول إلى الكائنات الثنائية كبيرة الحجم في الحاوية $logs.

بينما يتم تسجيل الطلبات، سيقوم Storage Analytics بتحميل نتائج وسيطة ككائنات ثنائية كبيرة الحجم. بشكل دوري، ستقوم Storage Analytics بتثبيت هذه الكتل وإتاحتها ككائنات ثنائية كبيرة الحجم. قد يستغرق الأمر ما يصل إلى ساعة حتى تظهر بيانات السجل في الكائنات الثنائية كبيرة الحجم في حاوية $logs بسبب التردد الذي تقوم به خدمة التخزين بمسح كتاب السجلات. قد توجد سجلات مكررة للسجلات التي تم إنشاؤها في نفس الساعة. يمكنك تحديد ما إذا كان السجل مكرراً عن طريق التحقق من معرف الطلب ورقم العملية.

إذا كان لديك حجم كبير من بيانات السجل مع ملفات متعددة لكل ساعة، فيمكنك استخدام بيانات تعريف الكائنات الثنائية كبيرة الحجم لتحديد البيانات التي يحتوي عليها السجل من خلال فحص حقول بيانات تعريف الكائنات الثنائية كبيرة الحجم. هذا مفيد أيضاً لأنه قد يكون هناك تأخير في بعض الأحيان أثناء كتابة البيانات إلى ملفات السجل: تعطي بيانات تعريف الكائنات الثنائية كبيرة الحجم مؤشراً أكثر دقة لمحتوى الكائنات الثنائية كبيرة الحجم من اسم الكائنات.

تمكنك معظم أدوات تصفح التخزين من عرض بيانات تعريف الكائنات الثنائية كبيرة الحجم؛ يمكنك أيضاً قراءة هذه المعلومات باستخدام PowerShell أو برمجياً. تعد القصاصة البرمجية PowerShell التالية مثالاً على تصفية قائمة الكائنات الثنائية كبيرة الحجم للسجل حسب الاسم لتحديد وقت، وحسب بيانات التعريف لتحديد تلك السجلات التي تحتوي على عمليات كتابة فقط.

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  
}

للحصول على معلومات حول إدراج الكائنات الثنائية كبيرة الحجم برمجياً، راجع ترقيم موارد الكائنات الثنائية كبيرة الحجم و إعداد واسترداد الخصائص وبيانات التعريف لموارد الكائنات الثنائية كبيرة الحجم.

اصطلاحات تسمية السجل

سيتم كتابة كل سجل بالتنسيق التالي:

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

يصف الجدول التالي كل سمة في اسم السجل:

السمة الوصف
<service-name> اسم خدمة التخزين. على سبيل المثال: blob أو table أو queue
YYYY السنة المكونة من أربعة أرقام للسجل. على سبيل المثال:2011
MM الشهر المكون من رقمين للسجل. على سبيل المثال:07
DD اليوم المكون من رقمين للسجل. على سبيل المثال:31
hh الساعة المكونة من رقمين والتي تشير إلى ساعة البدء للسجلات، بتنسيق 24 ساعة بتوقيت UTC. على سبيل المثال:18
mm الرقم المكون من رقمين الذي يشير إلى دقيقة البداية للسجلات. ملاحظه: هذه القيمة غير مدعومة في الإصدار الحالي من Storage Analytics، وستكون قيمتها دائماً 00.
<counter> عداد يستند إلى الصفر يحتوي على ستة أرقام يشير إلى عدد الكائنات الثنائية كبيرة الحجم للسجل التي تم إنشاؤها لخدمة التخزين في فترة زمنية مدتها ساعة. يبدأ هذا العداد من 000000. على سبيل المثال:000001

فيما يلي نموذج اسم سجل كامل يجمع بين الأمثلة المذكورة أعلاه:

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

فيما يلي نموذج URI يمكن استخدامه للوصول إلى السجل أعلاه:

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

عند تسجيل طلب تخزين، يرتبط اسم السجل الناتج بالساعة التي اكتملت فيها العملية المطلوبة. على سبيل المثال، إذا تم إكمال طلب GetBlob في الساعة 6:30 مساء في 7/31/2011، فستتم كتابة السجل بالبادئة التالية: blob/2011/07/31/1800/

بيانات تعريف السجل

يتم تخزين الكائنات الثنائية كبيرة الحجم للسجل مع بيانات التعريف التي يمكن استخدامها لتحديد بيانات التسجيل التي تحتوي عليها الكائنات. يصف الجدول التالي كل سمة من سمات بيانات التعريف:

السمة الوصف
LogType توضح ما إذا كان السجل يحتوي على معلومات تتعلق بعمليات القراءة أو الكتابة أو الحذف. يمكن أن تتضمن هذه القيمة نوعاً واحداً أو مزيجاً من الثلاثة كلها، مفصولة بفواصل.

مثال 1: write

مثال 2: read,write

مثال 3: read,write,delete
StartTime أبكر وقت لإدخال في السجل، في شكل YYYY-MM-DDThh:mm:ssZ. على سبيل المثال:2011-07-31T18:21:46Z
EndTime آخر وقت لإدخال في السجل، في شكل YYYY-MM-DDThh:mm:ssZ. على سبيل المثال:2011-07-31T18:22:09Z
LogVersion إصدار تنسيق السجل.

تعرض القائمة التالية عينة كاملة من بيانات التعريف باستخدام الأمثلة المذكورة أعلاه:

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

إدخالات السجل

تعرض الأقسام التالية مثالاً على إدخال السجل لكل خدمة Azure 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&amp;sig=XXXXX&amp;sp=rwl&amp;sr=c&amp;sv=2020-04-08&amp;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==";"&quot;0x8D9CEF88004E296&quot;";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";;;;;;;;

مثال على إدخال السجل لتخزين الكائنات الثنائية كبيرة الحجم (تم تمكين Azure Data Lake Storage Gen2)

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

مثال على إدخال السجل لتخزين قائمة الانتظار

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&amp;peekonly=true&amp;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";;;;;;;;

مثال على إدخال السجل لتخزين الجدول

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"

الخطوات التالية