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

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X.
المعلومات

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

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

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

  • /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 لم يتم ضبطها على عملية التدوير التلقائية. في ملف edge-router.log في جهاز توجيه مكوّن Apigee، يكون أحد هذه الملفات التي لم يتم ضبط ميزة تدوير السجلّ لها تلقائيًا.

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

قبل البدء

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

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

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

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

  1. افتح ملف /opt/apigee/edge-router/logrotate/logrotate.conf على جهاز التوجيه في أداة تعديل. إذا لم يكن الملف موجودًا، فأنشئه. مثال:

    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، تأكَّد من أنّك اتّبعت جميع الخطوات الموضّحة في تفعيل تدوير السجلّ لأداة توجيه الحافة على جهاز التوجيه بشكل صحيح. إذا فاتتك أي خطوة، كرِّر جميع الخطوات مرّة أخرى بشكل صحيح.
  4. في حال استمرار عدم تمكّنك من تفعيل ميزة تدوير السجلّ، يُرجى التواصل مع فريق دعم Apigee Edge.