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

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

چرخش گزارش -فرایند چرخش چندین فایل log در داخل و خارج از استفاده- مدیریت سیستم هایی را که تعداد زیادی فایل گزارش تولید می کنند، ساده می کند. چرخش گزارش چرخش، فشرده‌سازی، حذف و ارسال خودکار فایل‌های گزارش را قادر می‌سازد.

در 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 انجام می شود.

قبل از شروع

چرخش گزارش را فعال کنید

این بخش برای Edge برای Private Cloud نسخه‌های 4.50.00 و 4.51.00 اعمال می‌شود.

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

به‌طور پیش‌فرض، برخی از فایل‌های گزارش اصلی روی هر یک از اجزای apigee با مکانیزم چرخش پیش‌فرض پیکربندی شده‌اند. برای مثال، در مولفه Message Processor، فایل‌های زیر با مکانیزم چرخش پیش‌فرض پیکربندی شده‌اند:

  • /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

با این حال، سایر فایل‌های log در اجزای apigee با چرخش پیش‌فرض پیکربندی نشده‌اند. به عنوان مثال، چرخش گزارش به طور پیش‌فرض در فایل کامپوننت apigee Message Processor edge-message-processor.log پیکربندی نشده است.

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

فعال کردن چرخش گزارش برای edge-message-processor.log در پردازشگرهای پیام

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

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

  1. فایل /opt/apigee/edge-message-processor/logrotate/logrotate.conf را در دستگاه Message Processor در یک ویرایشگر باز کنید. اگر فایل وجود ندارد، آن را ایجاد کنید. به عنوان مثال:
    vi /opt/apigee/edge-message-processor/logrotate/logrotate.conf
    
  2. یک قطعه شبیه به تصویر زیر به فایل اضافه کنید:
    /opt/apigee/var/log/edge-message-processor/edge-message-processor.log {
        missingok
        copytruncate
        rotate 5
        size 10M
        compress
        delaycompress
        notifempty
        nocreate
        sharedscripts
        }
  3. تغییرات خود را ذخیره کنید
  4. با استفاده از دستور زیر، crontab کاربر apigee را باز کنید:
    sudo crontab -u apigee -e
    
  5. cron job زیر را به 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
  6. چرخش crontab و مانیتور را در طول اجرای بعدی کار cron ذخیره کنید.

تأیید چرخش گزارش برای edge-message-processor.log در پردازشگر پیام

  1. هنگامی که کار برنامه ریزی شده cron اجرا می شود، فایل log چرخانده می شود. از مثال بالا، cron job قرار است هر روز در ساعت 00:00 صبح اجرا شود تا فایل edge-message- processor.log بچرخد.
  2. به دایرکتوری /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 ذخیره می شوند.

  3. اگر نمی‌بینید که فایل‌های edge-message-processor.log در حال چرخش هستند، بررسی کنید که تمام مراحل ذکر شده در Enabling rotation log for edge-message-processor.log در پردازشگرهای پیام را به درستی دنبال کرده‌اید. اگر هر مرحله ای را از دست داده اید، تمام مراحل را دوباره به درستی تکرار کنید.
  4. اگر هنوز نمی‌توانید چرخش گزارش کار کند، با پشتیبانی Apigee Edge تماس بگیرید.