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

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

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

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

  • /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-* الأخرى ملفًا مشابهًا. لا يتم تدوير هذه الملفات باستخدام مكتبة logback، بل باستخدام logrotate وcrontab.

قبل البدء

  • إذا لم تكن على دراية بإعدادات logrotate، يُرجى قراءة دليل 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 باستخدام آلية تدوير تلقائية. على سبيل المثال، لا يتم ضبط ميزة تدوير السجلّات تلقائيًا في ملف edge-message-processor.log الخاص بمكوّن "معالج الرسائل" في apigee.

يمكن تفعيل ميزة تدوير السجلّات باستخدام أدوات/أُطر عمل مختلفة، مثل 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.