تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

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

في شبكة Edge الخاصة بالسحابة الإلكترونية الخاصة، يتم ضبط بعض ملفات السجلّ الرئيسية على كل مكوِّن 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 الخاص بـ 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:

افتح الملف /opt/apigee/edge-message-processor/logrotate/logrotate.conf على جهاز "معالج الرسائل" في أحد أدوات التعديل. إذا لم يكن الملف موجودًا، فأنشئه. مثلاً:
```
vi /opt/apigee/edge-message-processor/logrotate/logrotate.conf
```
أضِف مقتطفًا إلى الملف مشابهًا للملف الموضّح أدناه:
```
/opt/apigee/var/log/edge-message-processor/edge-message-processor.log {
    missingok
    copytruncate
    rotate 5
    size 10M
    compress
    delaycompress
    notifempty
    nocreate
    sharedscripts
    }
```
ملاحظة: يؤدي نموذج الإعدادات الموضّح أعلاه إلى تدوير الملف بعد حجمه 10 ميغابايت، ويتم تدوير ملفات السجلّ خمس مرات قبل أن تتم إزالتها. يمكنك تعديل التهيئة أعلاه بناءً على متطلبات تدوير السجل .
احفظ التغييرات.
افتح crontab في حساب مستخدم apigee باستخدام الأمر التالي:
```
sudo crontab -u apigee -e
```
إضافة مهمة 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
```
ملاحظة: من المقرر تنفيذ نموذج مهمة cron المعروضة أعلاه في الساعة 00:00 صباحًا كل يوم. وإذا كنت تريد تنفيذ مهمة cron هذه في أوقات مختلفة، ستحتاج إلى تعديل الوقت حسب الحاجة.
احفظ crontab وراقب دوران السجلّ أثناء التشغيل التالي لمهمة cron.

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

بعد تشغيل مهمة cron المجدولة، سيتم تدوير ملف السجلّ. بناءً على المثال أعلاه، تمت جدولة مهمة cron يوميًا عند الساعة 00:00 صباحًا لتدوير ملف edge-message- processor.log.
انتقِل إلى الدليل /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.
إذا لم يظهر لك أنّه يجري تدوير ملفات edge-message-processor.log، تأكَّد من أنّك اتّبعت جميع الخطوات الموضّحة في تفعيل تدوير السجلّ لميزة Edge-message-processor.log على "معالجات الرسائل" بشكلٍ صحيح. إذا فاتتك أي خطوة، كرِّر جميع الخطوات مرة أخرى بشكلٍ صحيح.
في حال استمرار عدم تمكّنك من تفعيل ميزة تدوير السجلّ، يُرجى التواصل مع فريق دعم Apigee Edge.