فعال کردن چرخش گزارش برای edge-router.log

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید.
اطلاعات

گردش گزارش سازوکاری است که برای تسهیل مدیریت سیستم‌هایی طراحی شده است که تعداد زیادی فایل گزارش تولید می‌کنند. این ویژگی امکان چرخش خودکار، فشرده‌سازی، برداشتن، و ارسال فایل‌های گزارش را فراهم می‌کند.

در Edge for Private Cloud، برخی‌از فایل‌های گزارش اصلی در هریک از عناصر Apigee با سازوکار چرخش پیش‌فرض پیکربندی شده‌اند.

برای مثال، در عنصر «رهیاب»، فایل‌های زیر با سازوکار چرخش پیش‌فرض پیکربندی شده‌اند:

  • /opt/apigee/var/log/edge-router/logs/system.log
  • /opt/apigee/var/log/edge-router/logs/events.log
  • /opt/apigee/var/log/edge-router/logs/startupruntimeerrors.log
  • /opt/apigee/var/log/edge-router/logs/configurations.log
  • /opt/apigee/var/log/edge-router/logs/transactions.log

بااین‌حال، فایل‌های گزارش خاصی در عناصر Apigee وجود دارد که با چرخش پیش‌فرض پیکربندی نشده‌اند. فایل edge-router.log در عنصر Apigee Router یکی از آن فایل‌هایی است که چرخش گزارش برای آن به‌طور پیش‌فرض پیکربندی نشده است.

چرخش گزارشات را می‌توان بااستفاده از ابزارها/چارچوب‌های مختلفی مثل logrotate، logback، یا log4j فعال کرد. این سند توضیح می‌دهد که چگونه چرخش گزارش را برای فایل /opt/apigee/var/log/edge-router/edge-router.log بااستفاده از logrotate و crontab پیکربندی کنید.

قبل‌از شروع

  • اگر با پیکربندی‌های logrotate آشنا نیستید، راهنمای logrotate را بخوانید.
  • اگر با پیکربندی‌های crontab آشنا نیستید، راهنمای crontab را بخوانید.

فعال کردن چرخش گزارش برای edge-router.log در «مسیریاب»

این بخش نحوه فعال کردن چرخش گزارش را برای گزارش‌های /opt/apigee/var/log/edge-router/edge-router.log در «مسیریاب‌های لبه» توضیح می‌دهد.

مراحل زیر نحوه فعال کردن چرخش گزارش برای فایل edge-router.log را شرح می‌دهد.

  1. فایل /opt/apigee/edge-router/logrotate/logrotate.conf را در ماشین «مسیریاب» در ویرایشگر باز کنید. اگر فایل وجود ندارد، آن را ایجاد کنید. برای مثال:

    vi /opt/apigee/edge-router/logrotate/logrotate.conf
    
  2. تکه‌کدی مشابه آنچه در زیر نشان داده شده است به فایل اضافه کنید:
    /opt/apigee/var/log/edge-router/edge-router.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 -f /opt/apigee/edge-router/logrotate/logrotate.conf
  6. crontab را ذخیره کنید و چرخش گزارش را در اجرای بعدی کار cron پایش کنید.

درحال درستی‌سنجی چرخش گزارش برای edge-router.log در «رهیاب»

  1. پس‌از اجرای کار زمان‌بندی‌شده cron، فایل گزارش چرخانده می‌شود. از مثال بالا، کار cron برنامه‌ریزی شده است تا هر روز ساعت ۰۰:۰۰ بامداد اجرا شود و فایل edge-router.log را بچرخاند.
  2. به فهرست راهنمای /opt/apigee/var/log/edge-router/ بروید و تأیید کنید که فایل edge-router.log چرخانده شده است.

    فهرست نمونه فایل‌های گزارش:

    ls -ltrh | grep 'edge-router'
    
    -rw-r--r--. 1 apigee apigee 6.0K Feb 16 00:00 edge-router.log.1.gz
    -rw-r--r--. 1 apigee apigee 3.0K Feb 16 01:23 edge-router.log

    برونداد بالا نشان می‌دهد که فایل‌های edge-router.log چرخانده و به‌عنوان فایل‌های GZ ذخیره شده‌اند.

  3. اگر نمی‌بینید که فایل‌های edge-router.log درحال چرخش هستند، تأیید کنید که همه مراحل ذکرشده در فعال کردن چرخش گزارش برای edge-router.log در «رهیاب» را به‌درستی دنبال کرده‌اید. اگر مرحله‌ای را ازدست داده‌اید، همه مراحل را دوباره به‌درستی تکرار کنید.
  4. اگر همچنان نمی‌توانید چرخش گزارش را فعال کنید، با پشتیبانی Apigee Edge تماس بگیرید.