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

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

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

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

في Edge for Private Cloud، يتم ضبط بعض ملفات السجلّ الرئيسية في كل apigee مكوّن باستخدام آلية دورة تلقائية. على سبيل المثال، في ملف Message Processor، يتم ضبط الملفات التالية باستخدام آلية تناوب الافتراضية باستخدام 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-* أيضًا ملف سجلّ إضافيًا يُعاد توجيهه إلى وحدة تحكّم المكوّن المعنيّ. في حال مكوّن Message Processor (معالج الرسائل)، يُطلق على هذا الملف اسم /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 باستخدام ميزة التدوير التلقائي. على سبيل المثال، لا يتم ضبط ميزة تغيير مفاتيح السجلّ تلقائيًا في apigee ملف معالج edge-message-processor.log المكوّن Message.

يمكن تفعيل ميزة تدوير السجلّات باستخدام أدوات أو إطارات عمل مختلفة، مثل logrotate logback أو log4j. يوضّح هذا القسم كيفية ضبط عملية تدوير log لملف /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.