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

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

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

في 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.50.00 و4.51.00 من 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

ومع ذلك، لم يتم ضبط ملفات السجلّات الأخرى في مكوّنات apigee على التدوير التلقائي. على سبيل المثال، لا يتم ضبط ميزة تدوير السجلّ تلقائيًا في رسالة مكوِّن apigee. ملف المعالج edge-message-processor.log

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

تفعيل تدوير السجل لـ Edge-message-processor.log في معالِجات الرسائل

يوضح هذا القسم كيفية تفعيل تدوير السجلات /opt/apigee/var/log/edge-message- processor/edge-message-processor.log على معالِجات الرسائل في Edge.

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

  1. فتح ملف /opt/apigee/edge-message-processor/logrotate/logrotate.conf في جهاز معالج الرسائل في أحد المحررين. إذا لم يكن الملف متوفّرًا، أنشئه. على سبيل المثال:
    vi /opt/apigee/edge-message-processor/logrotate/logrotate.conf
    
  2. أضِف مقتطفًا إلى الملف مشابهًا للمقتطف الموضّح أدناه:
    /opt/apigee/var/log/edge-message-processor/edge-message-processor.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 -s /opt/apigee/var/run/edge-message-processor/logrotate.status -f /opt/apigee/edge-message-processor/logrotate/logrotate.conf
    
  6. احفظ crontab وراقب تدوير السجلّ أثناء التشغيل التالي لمهمة cron.

التحقق من تدوير السجل لـ Edge-message-processor.log على معالج الرسائل

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

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

    ls -ltrh | grep 'edge-message-processor'
    
    -rw-r--r--. 1 apigee apigee  17K Feb  7 00:00 edge-message-processor.log.1.gz
    -rw-r--r--. 1 apigee apigee 5.3K Feb  7 09:12 edge-message-processor.log
    

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

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