تفعيل تدوير السجلّ لمكوّنات Edge

تدوير السجلّ: عملية تدوير عدة ملفات سجلّ داخل وخارج الاستخدام تبسط إدارة الأنظمة التي إنشاء أعداد كبيرة من ملفات السجل. يعمل تدوير السجل على تمكين التدوير التلقائي والضغط وإزالتها وإرسالها بالبريد.

في Edge for Private Cloud، تظهر بعض ملفات السجلّ الرئيسية في كل apigee. باستخدام آلية تدوير افتراضية. على سبيل المثال، في صفحة مكون معالج الرسائل، يتم ضبط الملفات التالية على تدوير تلقائي آلية باستخدام تسجيل الدخول:

  • /opt/apigee/var/log/edge-message-processor/logs/system.log
  • /opt/apigee/var/log/edge-message-processor/logs/events.log
  • /opt/apigee/var/log/edge-message-processor/logs/startupruntimeerrors.log
  • /opt/apigee/var/log/edge-message-processor/logs/configurations.log
  • /opt/apigee/var/log/edge-message-processor/logs/transactions.log

تتوفّر ملفات مشابهة لمكوّنات edge-* الأخرى (التي تكون أسماؤها) تبدأ بـ edge-)، مثل edge-management-server، edge-router وedge-postgres-server وedge-qpid-server

ينشئ كل مكوّن من مكوّنات edge-* هذه أيضًا ملف سجلّ إضافي تتم إعادة توجيهه. إخراج وحدة التحكم الخاصة بالمكون المعني. في حالة مكون معالج الرسائل، يُطلق على هذا الملف اسم /opt/apigee/var/log/edge-message-processor/edge-message-processor.log. تنشئ مكوّنات edge-* الأخرى ملفًا مشابهًا. وهذه الملفات لا يتم إجراء التناوب من خلال مكتبة تسجيل الدخول، ولكن بدلاً من ذلك، يتم استخدام logrotate وcrontab.

قبل البدء

  • إذا لم تكن على دراية بإعدادات logrotate، يُرجى الاطّلاع على دليل التسجيل.
  • إذا لم تكن على دراية بإعدادات crontab، يُرجى الاطّلاع على دليل crontab.

تفعيل عمليات تدوير السجل

بدءًا من الإصدار 4.52 من Edge for Private Cloud، عند تثبيت edge-* وهو إدخال crontab سيتم إنشاء تدوير هذا السجلّ تلقائيًا في crontab لدى مستخدم apigee. تعمل مهمة cron هذه كل ساعة تلقائيًا، وتستخدم أداة logrotate لتدوير السجلات. في حال توفّر سمة edge-* متعددة في نفس العقدة (على سبيل المثال، في تثبيت شامل، أو إذا الموجه ومعالج الرسائل مثبتان على عقدة واحدة)، فسيكون لكل مكون إدخال cron خاص به وتدوير السجلات الخاصة بها.

ملاحظات:

  • في حال عدم رغبتك أثناء تثبيت مكوّن edge-* إعداد logrotate مطلوب، اضبِط العلامة "ENABLE_LOGROTATE=n" في ملف الإعداد الصامت الذي تستخدمه. للتثبيت. إذا لم يتم ضبط مهمة cron أثناء التثبيت، يمكنك إعدادها. لاحقًا باتباع الخطوات تفعيل cron logrotate الخاص بالمكوِّن.
  • بالنسبة إلى المكوِّن edge-router، هناك مهمة cron إضافية لـ logrotate هي بشكل افتراضي أيضًا. يتولى عنصر cron هذا تدوير الوصول وسجلات الأخطاء التي تم إنشاؤها بواسطة Nginx.

توضح الأمثلة التالية التهيئات والعمليات الإدارية المختلفة التي يمكنك تنفيذها.

عرض إدخالات cron على عقدة

sudo crontab -u apigee -l

عرض إدخال cron الخاص بـ logrotate للمكوّن

$APIGEE_ROOT/apigee-service/bin/apigee-service <component-name> logrotate -s

على سبيل المثال، لعرض cron logrotate الخاص بمعالج رسائل Edge، شغِّل:

$APIGEE_ROOT/apigee-service/bin/apigee-service edge-message-processor logrotate -s

الاطّلاع على أحد المكوّنات إعداد logrotate

يمكن العثور على إعدادات logrotate الخاصة بأحد المكوّنات في الملف. $APIGEE_ROOT/<component>/logrotate/logrotate.conf على سبيل المثال، في حال استخدام Edge-message-processor ، يمكن ضبط إعدادات logrotate للعقدة تم العثور عليها في $APIGEE_ROOT/edge-message-processor/logrotate/logrotate.conf.

تفعيل logrotate cron للمكوِّن

$APIGEE_ROOT/apigee-service/bin/apigee-service <component-name> logrotate -e

على سبيل المثال، لتفعيل cron logrotate الخاص بمعالج رسائل Edge، شغِّل:

$APIGEE_ROOT/apigee-service/bin/apigee-service edge-message-processor logrotate -e

إيقاف logrotate cron للمكوِّن

$APIGEE_ROOT/apigee-service/bin/apigee-service <component-name> logrotate -d

على سبيل المثال، لإيقاف cron logrotate الخاص بمعالج رسائل Edge، شغِّل:

$APIGEE_ROOT/apigee-service/bin/apigee-service edge-message-processor logrotate -d

تغيير الجدول الزمني cron لأمر logrotate معيّن

في العقدة التي تريد تغيير جدول cron logrotate فيها، افتح الجدول ملف إلغاء تهيئة المكون. ملفات إلغاء إعداد المكوِّن edge-* مدرجة في الجدول أدناه:

المكوّن ملف إلغاء الإعدادات
edge-message-processor $APIGEE_ROOT/customer/application/message-processor.properties
edge-management-server $APIGEE_ROOT/customer/application/management-server.properties
edge-router $APIGEE_ROOT/customer/application/router.properties
edge-postgres-server $APIGEE_ROOT/customer/application/postgres-server.properties
edge-qpid-server $APIGEE_ROOT/customer/application/qpid-serverproperties

افتح ملف الإلغاء المناسب وحدِّد إعدادات إلغاء الضبط التالية. المثال أدناه وظيفة cron لتشغيلها في الدقيقة 0 من كل ساعة.

conf_logrotate_cron_duration=0 * * * *

لإعداد إلغاء الضبط:

  1. تأكَّد من أنّه بإمكان مستخدم apigee قراءة الملف.
  2. تطبيق جدول cron الأحدث على المكوِّن: 
    $APIGEE_ROOT/apigee-service/bin/apigee-service <component-name> logrotate -e

على سبيل المثال، لتطبيق جدول cron أحدث على logrotate لمعالج رسائل Edge، أدخِل:

$APIGEE_ROOT/apigee-service/bin/apigee-service edge-message-processor logrotate -e

للتحقق من تطبيق التغييرات، يمكنك إما التحقق من إدخالات cron أو عرض حقول إدخال cron واحد (logrotate)

إعدادات "logrotate" الإضافية

على غرار الخطوات المدرجة في القسم أعلاه لتعديل جدول cron، يمكنك أيضًا تعديل عمليات التهيئة الإضافية. يوضّح الجدول التالي عمليات الضبط هذه:

الإعداد الوصف
conf_logrotate_bin_location موقع النظام الثنائي لتدوير السجل. عناوين URL التلقائية: /usr/sbin/logrotate
conf_logrotate_status_file ملف الحالة الذي يلتقط حالة بيئة التشغيل لعملية تدوير السجل - العرض لديه أذونات بالقراءة/الكتابة لمستخدم واحد (apigee). اللغة التلقائية: $APIGEE_ROOT/var/run/<component>/logrotate.status
conf_logrotate_logs السجلّات المطلوب تدويرها. ويمكن أن يتضمن أحرف البدل. الإعداد التلقائي: $APIGEE_ROOT/var/log/<component>/<component>.log
conf_logrotate_rotate عدد مرات التدوير الإعداد التلقائي: "5"
conf_logrotate_compress ما إذا كان سيتم ضغط الملفات التي تم تدويرها. الإعداد التلقائي: "compress"
conf_logrotate_compress_type نوع الضغط: الإعداد التلقائي: "delaycompress". يتم تأجيل ضغط أحدث ملف تم تدويره إلى دورة تدوير السجل التالية.
conf_logrotate_size حد حجم السجل للتدوير. الإعداد التلقائي: "10 مليون"

استخدام آلية تدوير السجل وcron

في حال عدم استيفاء الإعدادات لمتطلبات تدوير سجلّ <المكون>. التي يوفّرها Apigee، فأنت تستخدم آليتك الخاصة لتدوير السجل باستخدام أدوات مثل تدوير السجل أو غيرهم. على سبيل المثال، تسمح لك الإعدادات التي يوفّرها Apigee بتدوير السجلات حسب الحجم ولكن وتريد تدوير السجلات بناءً على التاريخ/الوقت أو عوامل أخرى. في مثل هذه الحالات، يجب عليك يجب إيقاف زر cron logrotate المقدَّم من Apigee وإعداد مهام cron الخاصة بك حسب الحاجة.

إذا كنت بحاجة إلى الرجوع إلى إدخال cron لتدوير السجل في Apigee، يمكنك العثور عليه في الملف $APIGEE_ROOT//logrotate/logrotate.cron على سبيل المثال، في حالة edge-message-processor، هذا الملف يسمى $APIGEE_ROOT/edge-message-processor/logrotate/logrotate.cron هذا الملف يشمل إدخال cron والأمر الذي ينفذه Apigee لتدوير السجل. إذا كنت تريد استخدام logrotate ولكن لا تريد استخدام إعدادات Apigee، يمكنك إنشاء امتلاك logrotate ملف إعداد واستخدام أمر logrotate مشابه لإجراء تدوير السجل.