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

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

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

در Edge برای 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 را مطالعه کنید.

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

این بخش مربوط به نسخه‌های ۴.۵۰.۰۰ و ۴.۵۱.۰۰ مرورگر اج برای فضای ابری خصوصی است.

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

به طور پیش‌فرض، برخی از فایل‌های لاگ اصلی در هر یک از اجزای 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

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

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

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

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

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

1. فایل /opt/apigee/edge-message-processor/logrotate/logrotate.conf را در دستگاه پردازشگر پیام در یک ویرایشگر باز کنید. اگر فایل وجود ندارد، آن را ایجاد کنید. برای مثال:

   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 job زیر نظر داشته باشید.

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

1. پس از اجرای cron job برنامه‌ریزی‌شده، فایل لاگ تغییر می‌کند. در مثال بالا، cron job طوری برنامه‌ریزی شده است که هر روز ساعت ۰۰:۰۰ بامداد اجرا شود تا فایل 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 را مشاهده نمی‌کنید، تأیید کنید که تمام مراحل ذکر شده در فعال کردن چرخش گزارش برای edge-message-processor.log در Message Processors را به درستی دنبال کرده‌اید. اگر هر مرحله‌ای را از دست داده‌اید، تمام مراحل را دوباره به درستی تکرار کنید.
4. اگر هنوز نمی‌توانید چرخش کنده را فعال کنید، با پشتیبانی Apigee Edge تماس بگیرید.