أنت الآن بصدد الاطّلاع على مستندات 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:
- افتح الملف
/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 }
- احفظ التغييرات.
- افتح
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
- احفظ
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.