تفعيل تدوير السجلّ لـ Edge-router.log

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X.
info

تدوير السجلات هو آلية مصمَّمة لتسهيل إدارة الأنظمة التي تنشئ أعدادًا كبيرة من ملفات السجلّ. تتيح هذه الأداة تدوير ملفات السجل وضغطها وإزالتها وإرسالها تلقائيًا.

في Edge for Private Cloud، يتم ضبط بعض ملفات السجلّ الرئيسية على كل مكوّن من مكوّنات Apigee باستخدام آلية تدوير تلقائية.

على سبيل المثال، في مكوّن Router، يتم ضبط الملفات التالية باستخدام آلية التدوير التلقائية:

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

ومع ذلك، هناك بعض ملفات السجلّ في مكوّنات Apigee التي لم يتم ضبطها باستخدام عملية التدوير التلقائية. في ملف Apigee Router edge-router.log، يكون أحد هذه الملفات هو الملف الذي لم يتم ضبط عملية تغيير السجلّ تلقائيًا له.

يمكن تفعيل تدوير السجلّات باستخدام أدوات/أُطر مختلفة، مثل logrotate أو logback أو log4j. يوضّح هذا المستند كيفية ضبط عملية تدوير السجلّات لملف /opt/apigee/var/log/edge-router/edge-router.log باستخدام logrotate وcrontab.

قبل البدء

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

تفعيل تدوير السجلّ لملف edge-router.log على جهاز التوجيه

يوضّح هذا القسم كيفية تفعيل ميزة تدوير السجلّات /opt/apigee/var/log/edge-router/edge-router.log في أجهزة Edge Router.

توضِّح الخطوات التالية كيفية تفعيل تدوير السجلّ لملف edge-router.log.

  1. افتح ملف /opt/apigee/edge-router/logrotate/logrotate.conf على جهاز Router في محرِّر. إذا لم يكن الملف متاحًا، أنشِئه. على سبيل المثال:

    vi /opt/apigee/edge-router/logrotate/logrotate.conf
    
  2. أضِف مقتطفًا إلى الملف يشبه المقتطف الموضّح أدناه:
    /opt/apigee/var/log/edge-router/edge-router.log {
        missingok
        copytruncate
        rotate 5
        size 10M
        compress
        delaycompress
        notifempty
        nocreate
        sharedscripts
        }
  3. احفظ التغييرات.
  4. افتح crontab لمستخدم Apigee باستخدام الأمر التالي:
    sudo crontab -u apigee -e
    
  5. أضِف مهمة cron التالية إلى crontab لمستخدم Apigee:
    0 0 * * * nice -n 19 ionice -c3 /usr/sbin/logrotate -f /opt/apigee/edge-router/logrotate/logrotate.conf
  6. احفظ crontab وراقِب عملية تدوير السجلّ أثناء تشغيل مهمة cron التالية.

التحقّق من تدوير السجلّات لملف edge-router.log على جهاز التوجيه

  1. بعد تشغيل مهمة cron المُجدوَلة، سيتم تدوير ملف السجلّ. من المثال أعلاه، تمّت جدولة مهمة cron لتنفيذها كل يوم في الساعة 00:00 صباحًا من أجل تدوير الملف edge-router.log.
  2. انتقِل إلى الدليل /opt/apigee/var/log/edge-router/ وتأكَّد من تدوير الملف edge-router.log.

    نموذج لقائمة ملفات السجلّ:

    ls -ltrh | grep 'edge-router'
    
    -rw-r--r--. 1 apigee apigee 6.0K Feb 16 00:00 edge-router.log.1.gz
    -rw-r--r--. 1 apigee apigee 3.0K Feb 16 01:23 edge-router.log

    يشير الناتج أعلاه إلى أنّه يتم تدوير ملفات edge-router.log وحفظها كملفات GZ.

  3. إذا لم تلاحظ أنّ ملفات edge-router.log يتم تدويرها، تأكَّد من أنّك اتّبعت جميع الخطوات الموضّحة في تفعيل تدوير السجلّ لملف edge-router.log على جهاز التوجيه بشكل صحيح. إذا فاتتك أي خطوة، كرِّر جميع الخطوات مرة أخرى بشكل صحيح.
  4. إذا لم تتمكّن من تفعيل تدوير السجلّات، يُرجى التواصل مع فريق دعم Apigee Edge.