درحال مشاهده اسناد Apigee Edge هستید.
به
اسناد Apigee X بروید. اطلاعات
چرخش گزارش—فرایند چرخاندن چندین فایل گزارش در داخل و خارج از استفاده— مدیریت سیستم‌هایی را که تعداد زیادی فایل گزارش تولید می‌کنند ساده می‌کند. چرخش گزارشات امکان چرخش خودکار، فشرده‌سازی، برداشتن، و ارسال فایل‌های گزارش را فراهم می‌کند.
در 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 را بخوانید.
فعال کردن چرخش گزارش
این بخش برای نسخه‌های Edge for Private Cloud 4.50.00 و 4.51.00 اعمال می‌شود.
گردش گزارش سازوکاری است که برای تسهیل مدیریت سیستم‌هایی طراحی شده است که تعداد زیادی فایل گزارش تولید می‌کنند. این ویژگی امکان چرخش خودکار، فشرده‌سازی، برداشتن، و ارسال فایل‌های گزارش را فراهم می‌کند.
به‌طور پیش‌فرض، برخی‌از فایل‌های گزارش اصلی در هریک از 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 }
- تغییرات را ذخیره کنید.
- بااستفاده از فرمان زیر،
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 برنامه‌ریزی شده است تا هر روز ساعت ۰۰:۰۰ بامداد اجرا شود و فایل
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 تماس بگیرید.