הפעלת סיבוב יומן עבור edge-router.log

אתם צופים במסמכי התיעוד של Apigee Edge.
כדאי לעיין במסמכי התיעוד של Apigee X. מידע

החלפת יומנים היא מנגנון שנועד להקל על הניהול של מערכות שמייצרות מספרים גדולים של קובצי יומן. היא מאפשרת סיבוב אוטומטי, דחיסה, הסרה ושליחה בדואר של קובצי יומן.

ב-Edge for 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 שלא מוגדרים עם סבב ברירת מחדל. בקובץ edge-router.log של רכיב הנתב של Apigee, קובץ זה הוא אחד מהקבצים שהחלפת יומנים לא מוגדרת עבורם כברירת מחדל.

אפשר להפעיל את החלפת היומנים באמצעות כלי עזר או מסגרות שונים, כמו logrotate,‏ logback או log4j. במסמך הזה מוסבר איך להגדיר סבב של קובצי יומן (log rotation) עבור קובץ /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.

בשלבים הבאים מוסבר איך להפעיל החלפת יומנים בקובץ 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 מתוזמנת לפעול כל יום בשעה 00:00 כדי לבצע רוטציה של הקובץ 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 files are being rotated, צריך לוודא שביצעתם את כל השלבים שמפורטים במאמר הפעלת רוטציה של קובץ היומן edge-router.log בנתב. אם פספסתם שלב כלשהו, צריך לחזור על כל השלבים בצורה נכונה.
4. אם עדיין לא הצלחתם להפעיל את החלפת היומנים, תוכלו לפנות אל התמיכה של Apigee Edge.