تمكين وإدارة سجلات Azure Storage Analytics (الكلاسيكية)

يوفر Azure Storage Analytics سجلات للكائنات الثنائية كبيرة الحجم وقوائم الانتظار والجداول. يمكنك استخدام مدخل Microsoft Azure لتكوين سجلات مسجلة لحسابك. توضح هذه المقالة كيفية تمكين وإدارة السجلات. لمعرفة كيفية تمكين المقاييس، راجع الانتقال إلى المقاييس في Azure Monitor. بوجد تكاليف مرتبطة بفحص بيانات المراقبة وتخزينها في مدخل Microsoft Azure. لمزيد من المعلومات، راجع تحليلات التخزين.

إشعار

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

• مراقبة Azure Blob Storage
• مراقبة Azure Files
• مراقبة Azure Queue Storage
• مراقبة تخزين Azure Table

تمكين السجلات

يمكنك إرشاد Azure Storage لحفظ سجلات التشخيص للقراءة والكتابة وحذف طلبات خدمات النقطة والجدول وقائمة الانتظار. كما ينطبق نهج الاحتفاظ بالبيانات الذي قمت بتعيينه على هذه السجلات.

إشعار

يدعم Azure Files حاليًا مقاييس Storage Analytics، لكنه لا يدعم تسجيل Storage Analytics.

بوابة

1. في مدخل Microsoft Azure، حدد حسابات التخزين، ثم اسم حساب التخزين لفتح جزء حساب التخزين.

2. حدد إعدادات التشخيص (الكلاسيكية) في قسم المراقبة (الكلاسيكي) من جزء القائمة.

   

3. تأكد من تعيين الحالة إلى تشغيل، وحدد الخدمات التي تريد تمكين التسجيل لها.

   

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

   تحذير

   يتم تخزين السجلات كبيانات في حسابك. يمكن أن تتراكم بيانات السجل في حسابك مع مرور الوقت مما قد يزيد من تكلفة التخزين. إذا كنت بحاجة إلى بيانات السجل لفترة زمنية صغيرة فقط، فإنه يمكنك تقليل التكاليف عن طريق تعديل نهج الاحتفاظ بالبيانات. يتم حذف بيانات السجل التي لا معنى لها (البيانات الأقدم من نهج الاستبقاء) من قبل النظام. نوصي بتعيين نهج استبقاء استنادًا إلى المدة التي تريد الاحتفاظ بها لبيانات السجل لحسابك. راجع الفواتير على مقاييس التخزين للحصول على مزيد من المعلومات.

5. انقر فوق حفظ.

   يتم حفظ سجلات التشخيص في حاوية كائن ثنائي كبير الحجم تسمى $logs في حساب التخزين الخاص بك. يمكنك عرض بيانات السجل باستخدام مستكشف تخزين مثل Microsoft Azure Storage Explorer، أو برمجيا باستخدام مكتبة عميل التخزين أو PowerShell.

   للحصول على معلومات حول الوصول إلى حاوية $logs، راجع تسجيل تحليلات التخزين.

   إشعار

   بالنسبة لحسابات التخزين الكلاسيكية، تظهر حاوية $logs فقط في Azure Storage Explorer. حاوية $logs غير مرئية من مستعرض التخزين أو طريقة عرض الحاوية المتوفرة في مدخل Microsoft Azure.

بوويرشيل

1. افتح نافذة أوامر Windows PowerShell.

2. سجل الدخول إلى اشتراكك في Azure باستخدام الأمر Connect-AzAccount واتبع الإرشادات التي تظهر على الشاشة.

   Connect-AzAccount
   

3. إذا كانت هويتك مقترنة بأكثر من اشتراك واحد، فقم بتعيين الاشتراك النشط الخاص بك.

   $context = Get-AzSubscription -SubscriptionId <subscription-id>
   Set-AzContext $context
   

   استبدل قيمة <subscription-id>العنصر النائب بمعرف اشتراكك.

4. ثم، احصل على سياق حساب التخزين الذي يحدد حساب التخزين الذي تريد استخدامه.

   $storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
   $ctx = $storageAccount.Context
   

   • استبدل <resource-group-name> قيمة العنصر النائب باسم مجموعة الموارد.

   • استبدل <storage-account-name> قيمة العنصر النائب باسم حساب التخزين الخاص بك.

5. استخدم Set-AzStorageServiceLoggingProperty لتغيير إعدادات السجل الحالية. تستخدم أوامر cmdlets التي تتحكم في تسجيل التخزين معلمة LoggingOperations وهي سلسلة تحتوي على قائمة مفصولة بفواصل بأنواع الطلبات لتسجيلها. أنواع الطلبات الثلاثة المحتملة هي القراءة والكتابة والحذف. لإيقاف تشغيل التسجيل، استخدم القيمة none للمعلمة LoggingOperations.

   الأمر التالي تبديل تسجيل القراءة والكتابة وحذف الطلبات في خدمة قائمة الانتظار في حساب التخزين الافتراضي الخاص بك مع تعيين الاحتفاظ إلى خمسة أيام:

   Set-AzStorageServiceLoggingProperty -ServiceType Queue -LoggingOperations read,write,delete -RetentionDays 5 -Context $ctx
   

   تحذير

   يتم تخزين السجلات كبيانات في حسابك. يمكن أن تتراكم بيانات السجل في حسابك مع مرور الوقت، مما قد يزيد من تكلفة التخزين. إذا كنت بحاجة إلى بيانات السجل لفترة زمنية صغيرة فقط، فإنه يمكنك تقليل التكاليف عن طريق تعديل نهج الاحتفاظ بالبيانات. يتم حذف بيانات السجل التي لا معنى لها (البيانات الأقدم من نهج الاستبقاء) من قبل النظام. نوصي بتعيين نهج استبقاء استنادًا إلى المدة التي تريد الاحتفاظ بها لبيانات السجل لحسابك. راجع الفواتير على مقاييس التخزين للحصول على مزيد من المعلومات.

   الأمر التالي إيقاف تسجيل خدمة الجدول في حساب التخزين الافتراضي:

   Set-AzStorageServiceLoggingProperty -ServiceType Table -LoggingOperations none -Context $ctx 
   

   للحصول على معلومات حول كيفية تكوين أوامر Cmdlets Azure PowerShell للعمل مع اشتراك Azure وكيفية تحديد حساب التخزين الافتراضي لاستخدامه، راجع: كيفية تثبيت Azure PowerShell وتكوينه.

NET.

QueueServiceClient queueServiceClient = new QueueServiceClient(connectionString);

QueueServiceProperties serviceProperties = queueServiceClient.GetProperties().Value;

serviceProperties.Logging.Delete = true;

QueueRetentionPolicy retentionPolicy = new QueueRetentionPolicy();
retentionPolicy.Enabled = true;
retentionPolicy.Days = 2;
serviceProperties.Logging.RetentionPolicy = retentionPolicy;

serviceProperties.HourMetrics = null;
serviceProperties.MinuteMetrics = null;
serviceProperties.Cors = null;

queueServiceClient.SetProperties(serviceProperties);

تعديل فترة استبقاء بيانات السجل

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

بوابة

1. في مدخل Microsoft Azure، حدد حسابات التخزين، ثم اسم حساب التخزين لفتح جزء حساب التخزين.

2. حدد إعدادات التشخيص (الكلاسيكية) في قسم المراقبة (الكلاسيكي) من جزء القائمة.

   

3. تأكد من تحديد خانة الاختيار حذف البيانات . ثم عيّن عدد الأيام التي تريد الاحتفاظ ببيانات السجل عن طريق تحريك عنصر تحكم شريط التمرير أسفل خانة الاختيار، أو عن طريق تعديل القيمة التي تظهر مباشرة في مربع النص بجوار عنصر تحكم شريط التمرير.

   

   العدد الافتراضي للأيام لحسابات التخزين الجديدة هو سبعة أيام. إذا كنت لا تريد تعيين نهج استبقاء، فاترك خانة الاختيار حذف البيانات غير محددة. إذا لم يكن هناك نهج الاحتفاظ، فالأمر متروك لك لحذف بيانات المراقبة.

4. انقر فوق حفظ.

   يتم حفظ سجلات التشخيص في حاوية كائن ثنائي كبير الحجم تسمى $logs في حساب التخزين الخاص بك. يمكنك عرض بيانات السجل باستخدام مستكشف تخزين مثل Microsoft Azure Storage Explorer، أو برمجيا باستخدام مكتبة عميل التخزين أو PowerShell.

   للحصول على معلومات حول الوصول إلى حاوية $logs، راجع تسجيل تحليلات التخزين.

بوويرشيل

1. افتح نافذة أوامر Windows PowerShell.

2. سجل الدخول إلى اشتراكك في Azure باستخدام الأمر Connect-AzAccount واتبع الإرشادات التي تظهر على الشاشة.

   Connect-AzAccount
   

3. إذا كانت هويتك مقترنة بأكثر من اشتراك واحد، فقم بتعيين الاشتراك النشط الخاص بك.

   $context = Get-AzSubscription -SubscriptionId <subscription-id>
   Set-AzContext $context
   

   استبدل قيمة <subscription-id>العنصر النائب بمعرف اشتراكك.

4. الحصول على سياق حساب التخزين الذي يعرف حساب التخزين.

   $storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
   $ctx = $storageAccount.Context
   

   • استبدل <resource-group-name> قيمة العنصر النائب باسم مجموعة الموارد.

   • استبدل <storage-account-name> قيمة العنصر النائب باسم حساب التخزين الخاص بك.

5. استخدم Get-AzStorageServiceLoggingProperty لعرض نهج استبقاء السجل الحالي. يطبع المثال التالي إلى وحدة التحكم فترة الاستبقاء لخدمات تخزين للكائنات ثنائية كبيرة الحجم وقائمة الانتظار.

   Get-AzStorageServiceLoggingProperty -ServiceType Blob, Queue -Context $ctx
   

   في إخراج وحدة التحكم، تظهر فترة الاستبقاء أسفل RetentionDays عنوان العمود.

   

6. استخدم Set-AzStorageServiceLoggingProperty لتغيير فترة الاستبقاء. يغير المثال التالي فترة الاستبقاء إلى 4 أيام.

   Set-AzStorageServiceLoggingProperty -ServiceType Blob, Queue -RetentionDays 4 -Context $ctx
   

   للحصول على معلومات حول كيفية تكوين أوامر Cmdlets Azure PowerShell للعمل مع اشتراك Azure وكيفية تحديد حساب التخزين الافتراضي لاستخدامه، راجع: كيفية تثبيت Azure PowerShell وتكوينه.

NET.

يطبع المثال التالي إلى وحدة التحكم فترة الاستبقاء لخدمات تخزين للكائنات ثنائية كبيرة الحجم وقائمة الانتظار.

BlobServiceClient blobServiceClient = new BlobServiceClient(connectionString);
QueueServiceClient queueServiceClient = new QueueServiceClient(connectionString);

BlobServiceProperties blobServiceProperties = blobServiceClient.GetProperties().Value;
QueueServiceProperties queueServiceProperties = queueServiceClient.GetProperties().Value;

Console.WriteLine("Retention period for logs from the blob service is: " +
    blobServiceProperties.Logging.RetentionPolicy.Days.ToString());

Console.WriteLine("Retention period for logs from the queue service is: " +
    queueServiceProperties.Logging.RetentionPolicy.Days.ToString());

يغير المثال التالي فترة الاستبقاء إلى 4 أيام.

BlobRetentionPolicy blobRetentionPolicy = new BlobRetentionPolicy();

blobRetentionPolicy.Enabled = true;
blobRetentionPolicy.Days = 4;

QueueRetentionPolicy queueRetentionPolicy = new QueueRetentionPolicy();

queueRetentionPolicy.Enabled = true;
queueRetentionPolicy.Days = 4;

blobServiceProperties.Logging.RetentionPolicy = blobRetentionPolicy;
blobServiceProperties.Cors = null;

queueServiceProperties.Logging.RetentionPolicy = queueRetentionPolicy;
queueServiceProperties.Cors = null;

blobServiceClient.SetProperties(blobServiceProperties);
queueServiceClient.SetProperties(queueServiceProperties);

Console.WriteLine("Retention policy for blobs and queues is updated");

تحقق من حذف بيانات السجل

يمكنك التحقق من حذف السجلات عن طريق عرض محتويات $logs حاوية حساب التخزين الخاص بك. تعرض الصورة التالية محتويات مجلد في الحاوية $logs . يتوافق المجلد مع يناير 2021 ويحتوي كل مجلد على سجلات ليوم واحد. إذا كان اليوم هو 29 يناير 2021، وتم تعيين نهج الاستبقاء الخاص بك إلى يوم واحد فقط، ثم يجب أن يحتوي هذا المجلد على سجلات ليوم واحد فقط.

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

لعرض بيانات السجل وتحليلها، يجب تنزيل النقط التي تحتوي على بيانات السجل التي تهتم بها إلى جهاز محلي. تمكنك العديد من أدوات استعراض التخزين من تنزيل الكائنات الثنائية كبيرة الحجم من حساب التخزين الخاص بك؛ يمكنك أيضا استخدام فريق Azure Storage المقدم من سطر الأوامر Azure Copy Tool AzCopy لتنزيل بيانات السجل الخاصة بك.

إشعار

$logs الحاوية غير متكاملة مع Event Grid، لذلك لن تتلقى إعلامات عند كتابة ملفات السجل.

للتأكد من تنزيل بيانات السجل التي تهتم بها وتجنب تنزيل بيانات السجل نفسها أكثر من مرة:

• استخدم اصطلاح تسمية التاريخ والوقت للنقط التي تحتوي على بيانات السجل لتعقب النقط التي قمت بتنزيلها بالفعل للتحليل لتجنب إعادة تنزيل نفس البيانات أكثر من مرة.

• استخدم بيانات التعريف على النقط التي تحتوي على بيانات السجل لتحديد الفترة المحددة التي تحتفظ الكائنات الثنائية كبيرة الحجم ببيانات السجل لتحديد كائن ثنائي كبير الحجم الدقيقة التي تحتاج إلى تنزيلها.

لبدء استخدام AzCopy، راجع بدء استخدام AzCopy

يوضح المثال التالي كيف يمكنك تحميل بيانات السجل لخدمة قائمة الانتظار للساعات التي تبدأ في 09 صباحًا و10 صباحًا و11 صباحًا في 20 مايو 2014.

azcopy copy 'https://mystorageaccount.blob.core.windows.net/$logs/queue' 'C:\Logs\Storage' --include-path '2014/05/20/09;2014/05/20/10;2014/05/20/11' --recursive

لمعرفة المزيد حول كيفية تنزيل ملفات معينة، راجع تنزيل الكائنات الثنائية كبيرة الحجم من تخزين Azure Blob باستخدام AzCopy v10.

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

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

• لمعرفة المزيد حول تحليلات التخزين، راجع تحليلات التخزين لتحليلات التخزين.
• لمزيد من المعلومات حول استخدام لغة .NET لتكوين تسجيل التخزين، راجع مرجع مكتبة عميل التخزين.
• للحصول على معلومات عامة حول تكوين تسجيل التخزين باستخدام واجهة برمجة تطبيقات REST، راجع تمكين Storage Analytics وتكوينها.
• تعرف على المزيد حول تنسيق سجلات "تحليلات التخزين". راجع تنسيق سجل تحليلات التخزين.