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

يوفر ⁧⁩Azure Storage Analytics⁧⁩ سجلات للنقط وقوائم الانتظار والجداول. يمكنك استخدام مدخل Microsoft Azure لتكوين السجلات المسجلة لحسابك. توضح هذه المقالة كيفية تمكين وإدارة السجلات. لمعرفة كيفية تمكين المقاييس ، راجع تمكين وإدارة مقاييس Azure Storage Analytics (الكلاسيكية) . بوجد تكاليف مرتبطة بفحص بيانات المراقبة وتخزينها في مدخل 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. في ⁧⁩مدخل Azure⁧⁩، حدد ⁧⁩حسابات التخزين⁧⁩، ثم اسم حساب التخزين لفتح شفرة حساب التخزين.

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

   

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

   

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

   تحذير

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

5. انقر فوق Save.

   يتم حفظ سجلات التشخيص في حاوية نقطية تسمى ⁧⁩$السجلات⁧⁩ في حساب التخزين الخاص بك. يمكنك عرض بيانات السجل باستخدام مستكشف تخزين مثل ⁧⁩مستكشف تخزين Microsoft Azure⁧⁩، أو برمجيًا باستخدام مكتبة عميل التخزين أو PowerShell.

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

   ملاحظة

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

PowerShell

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. استخدم ⁧⁩تعيين-AzStorageServiceLoggingProperty⁧⁩ لتغيير إعدادات السجل الحالي. تستخدم أوامر cmdlets التي تتحكم في "تسجيل التخزين" معلمة LoggingOperations وهي عبارة عن سلسلة تحتوي على قائمة مفصولة بفواصل لأنواع الطلبات للتسجيل. أنواع الطلبات الثلاثة المحتملة هي قراءة و كتابة و حذف . لإيقاف التسجيل، استخدم القيمة لا شيء للمعلمة LoggingOperations .

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

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

   تحذير

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

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

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

   للحصول على معلومات حول كيفية تكوين cmdlets PowerShell Azure للعمل مع اشتراك 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. في ⁧⁩مدخل Azure⁧⁩، حدد ⁧⁩حسابات التخزين⁧⁩، ثم اسم حساب التخزين لفتح شفرة حساب التخزين.

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

   

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

   

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

4. انقر فوق Save.

   يتم حفظ سجلات التشخيص في حاوية نقطية تسمى ⁧⁩$السجلات⁧⁩ في حساب التخزين الخاص بك. يمكنك عرض بيانات السجل باستخدام مستكشف تخزين مثل ⁧⁩مستكشف تخزين Microsoft Azure⁧⁩، أو برمجيًا باستخدام مكتبة عميل التخزين أو PowerShell.

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

PowerShell

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. استخدم ⁧⁩مجموعة AzStorageServiceLoggingProperty⁧⁩ لتغيير فترة الاستبقاء. يغير المثال التالي فترة الاستبقاء إلى 4 أيام.

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

   للحصول على معلومات حول كيفية تكوين cmdlets PowerShell Azure للعمل مع اشتراك 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 المقدمة سطر الأوامر Azure نسخ ⁧⁩أداة AzCopy⁧⁩ لتحميل بيانات السجل الخاص بك.

ملاحظة

⁧$logs⁩الحاوية غير متكاملة مع شبكة الأحداث، لذلك لن تتلقى إعلامات عند كتابة ملفات السجل.

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

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

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

للبدء باستخدام 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 كائن ثنائي كبير الحجم باستخدام AzCopy v10⁧⁩.

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

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

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