تنزيل PostgreSQL وسجلات الترقية

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

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

توضح هذه المقالة كيفية تمكين الميزة وتعطيلها. كما يصف كيف يمكنك سرد جميع سجلات الخادم المتاحة، وكيف يمكنك تنزيل أي منها.

خطوات تمكين التقاط PostgreSQL وترقية سجلات التنزيل

Portal

استخدام المدخل الخاص بـ Microsoft Azure:

1. حدد قاعدة بيانات Azure لمثيل خادم PostgreSQL المرن.

2. في قائمة الموارد، ضمن قسم المراقبة ، حدد سجلات الخادم.

   

3. ضع علامة على خانة الاختيار سجلات الالتقاط للتنزيل .

   

4. بشكل تلقائي، يتم الاحتفاظ بملفات السجل لمدة ثلاثة أيام، ولكن يمكنك ضبط فترة الاحتفاظ بالبيانات من 1 إلى 7 أيام. استخدم مقسم طريقة عرض فترة الاحتفاظ بالسجل (بالأيام) للتكيف مع التكوين الذي تريده.

   

5. حدّد زر حفظ.

   

6. يعلمك إعلام أن الخدمة تقوم بتكوين التقاط السجلات للتنزيل.

   

7. بمجرد انتهاء العملية، يخبرك إعلام بأن الخدمة أكملت تكوين التقاط السجلات للتنزيل.

   

CLI

يمكنك تمكين التقاط سجلات خادم PostgreSQL وسجلات ترقية الإصدار الرئيسي عبر الأمر az postgres flexible-server parameter set .

لتمكين التقاط السجلات للتنزيل، استخدم هذا الأمر:

az postgres flexible-server parameter set \
  --resource-group <resource_group> \
  --server-name <server> \
  --name logfiles.download_enable \
  --value on

لضبط فترة الاستبقاء للسجلات التي تم التقاطها للتنزيل، استخدم هذا الأمر:

az postgres flexible-server parameter set \
  --resource-group <resource_group> \
  --server-name <server> \
  --name logfiles.retention_days \
  --value <retention_period_in_days>

يمكن أن تتراوح القيم المسموح بها لمعلمة logfiles.retention_days الخادم بين 1 و 7 أيام. إذا حاولت تعيينه على قيمة مختلفة، فستحصل على هذا الخطأ:

Code: ServerParameterToCMSUnAllowedParameterValue
Message: The value: [<value>] of Server Parameter: [logfiles.retention_days] is invalid, the allowed values are: [1-7]

Note

• بعد بضع دقائق من تمكين التقاط سجلات الخادم للتنزيل ، سيكون السجل الأول متاحا للتنزيل.

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

خطوات تعطيل التقاط PostgreSQL وترقية سجلات التنزيل

Portal

استخدام المدخل الخاص بـ Microsoft Azure:

1. حدد قاعدة بيانات Azure لمثيل خادم PostgreSQL المرن.

2. في قائمة الموارد، ضمن قسم المراقبة ، حدد سجلات الخادم.

   

3. قم بإلغاء تحديد خانة الاختيار تسجيل الالتقاط للتنزيل .

   

4. حدّد زر حفظ.

   

5. يعلمك إعلام أن الخدمة تقوم بتكوين التقاط السجلات للتنزيل.

   

6. بمجرد انتهاء العملية، يخبرك إعلام بأن الخدمة أكملت تكوين التقاط السجلات للتنزيل.

   

CLI

يمكنك تعطيل التقاط سجلات خادم PostgreSQL وسجلات ترقية الإصدار الرئيسي عبر الأمر az postgres flexible-server parameter set .

لتعطيل التقاط السجلات للتنزيل، استخدم هذا الأمر:

az postgres flexible-server parameter \
  --resource-group <resource_group> \
  --server-name <server> \
  --name logfiles.download_enable \
  --value off

خطوات سرد السجلات الملتقطة المتاحة للتنزيل

Portal

استخدام المدخل الخاص بـ Microsoft Azure:

1. حدد قاعدة بيانات Azure لمثيل خادم PostgreSQL المرن.

2. في قائمة الموارد، ضمن قسم المراقبة ، حدد سجلات الخادم.

   

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

   • الاسم: اسم ملف السجل. تقوم الخدمة بتعيين اسم لكل ملف سجل بهذا النمط postgresql_yyyy_mm_dd_hh_00_00.log.
   • وقت آخر تحديث: الطابع الزمني لآخر مرة تم فيها تحميل كل ملف سجل. يتم تحميل ملفات السجل ، تقريبا ، كل 10 دقائق.
   • الحجم: الحجم بالبايت الذي يشغله ملف السجل.
   • نوع السجل: يشير سجل الخادم إلى أن الملف يتوافق مع سجل خادم PostgreSQL. يشير سجل الترقية إلى أن الملف يتوافق مع سجل ترقية الإصدار الرئيسي.

   

4. لا يتم تحديث محتوى الجدول تلقائيا. للاطلاع على أحدث المعلومات، يمكنك تحديد تحديث.

   

CLI

يمكنك سرد سجلات خادم PostgreSQL التي تم التقاطها وسجلات ترقية الإصدار الرئيسي عبر الأمر az postgres flexible-server server-logs list .

لسرد جميع السجلات الملتقطة المتوفرة للتنزيل، والتي تم تحديثها في آخر 72 ساعة (القيمة الافتراضية)، استخدم هذا الأمر:

az postgres flexible-server server-logs list \
  --resource-group <resource_group> \
  --server-name <server>

لسرد جميع السجلات الملتقطة المتاحة للتنزيل، والتي تم تحديثها في آخر 10 ساعات، استخدم هذا الأمر:

az postgres flexible-server server-logs list \
  --resource-group <resource_group> \
  --server-name <server> \
  --file-last-written 10

لسرد جميع السجلات الملتقطة المتاحة للتنزيل، والتي يقل حجمها عن 30 كيلوبايت، استخدم هذا الأمر:

az postgres flexible-server server-logs list \
  --resource-group <resource_group> \
  --server-name <server> \
  --max-file-size 30

لسرد جميع السجلات الملتقطة المتاحة للتنزيل ، والتي يحتوي 01_07اسمها ، استخدم هذا الأمر:

az postgres flexible-server server-logs list \
  --resource-group <resource_group> \
  --server-name <server> \
  --filename-contains 01_07

خطوات تنزيل السجلات الملتقطة

Portal

استخدام المدخل الخاص بـ Microsoft Azure:

1. حدد قاعدة بيانات Azure لمثيل خادم PostgreSQL المرن.

2. في قائمة الموارد، ضمن قسم المراقبة ، حدد سجلات الخادم.

   

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

   

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

   

5. لا يتم تحديث محتوى الجدول تلقائيا. للاطلاع على أحدث المعلومات، يمكنك تحديد تحديث.

   

CLI

يمكنك تنزيل سجلات خادم PostgreSQL التي تم التقاطها وسجلات ترقية الإصدار الرئيسي عبر الأمر az postgres flexible-server server-logs download .

لتنزيل سجل واحد محدد، استخدم هذا الأمر:

az postgres flexible-server server-logs download \
  --resource-group <resource_group> \
  --server-name <server> \
  --name <log_name>

لتنزيل سجل واحد محدد، استخدم هذا الأمر:

az postgres flexible-server server-logs download \
  --resource-group <resource_group> \
  --server-name <server> \
  --name <log1_name log2_name ...logn_name>

Note

• بالنسبة لأسماء الملفات المتوفرة التي توجد لها ملفات سجل بأسماء مطابقة متاحة للتنزيل، يتم إنشاء ملف محلي بنفس الاسم والمحتويات.

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

المحتويات ذات الصلة

• تكوين قابلية وصول عالية.
• تكوين الصيانة المجدولة.
• قم بإنشاء تنبيهات على المقاييس باستخدام المدخل.