این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

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

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

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

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

برای مثال، در کامپوننت Router، فایل‌های زیر با مکانیزم چرخش پیش‌فرض پیکربندی شده‌اند:

/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 وجود دارند که با چرخش پیش‌فرض پیکربندی نشده‌اند. در کامپوننت Apigee، فایل Router edge-router.log یکی از آن فایل‌هایی است که چرخش لاگ برای آن به طور پیش‌فرض پیکربندی نشده است.

چرخش لاگ را می‌توان با استفاده از ابزارها/چارچوب‌های مختلفی مانند 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 Routers) را توضیح می‌دهد.

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

فایل /opt/apigee/edge-router/logrotate/logrotate.conf را در دستگاه روتر در یک ویرایشگر باز کنید. اگر فایل وجود ندارد، آن را ایجاد کنید. به عنوان مثال:
```
vi /opt/apigee/edge-router/logrotate/logrotate.conf
```
قطعه کدی مشابه آنچه در زیر نشان داده شده است را به فایل اضافه کنید:
```
/opt/apigee/var/log/edge-router/edge-router.log {
    missingok
    copytruncate
    rotate 5
    size 10M
    compress
    delaycompress
    notifempty
    nocreate
    sharedscripts
    }
```
توجه: پیکربندی نمونه نشان داده شده در بالا، فایل را پس از ۱۰ مگابایت می‌چرخاند و فایل‌های لاگ قبل از حذف، پنج بار چرخانده می‌شوند. می‌توانید پیکربندی فوق را بسته به نیازهای چرخش لاگ خود تغییر دهید.
تغییرات خود را ذخیره کنید.
crontab کاربر apigee را با استفاده از دستور زیر باز کنید:
```
sudo crontab -u apigee -e
```
کرون جاب زیر را به crontab کاربر Apigee اضافه کنید:
```
0 0 * * * nice -n 19 ionice -c3 /usr/sbin/logrotate -f /opt/apigee/edge-router/logrotate/logrotate.conf
```
نکته: کرون جاب نمونه‌ای که در بالا نشان داده شده است، طوری برنامه‌ریزی شده است که هر روز ساعت ۰۰:۰۰ بامداد اجرا شود. اگر می‌خواهید این کرون جاب در زمان‌های مختلف اجرا شود، باید زمان را در صورت نیاز تغییر دهید.
crontab را ذخیره کنید و چرخش گزارش را در طول اجرای بعدی cron job زیر نظر داشته باشید.

تأیید چرخش گزارش برای edge-router.log در روتر

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