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

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

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

ב-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.

לפני שמתחילים

• אם אתם לא מכירים את ההגדרות של logrotate, תוכלו לקרוא את המדריך של logrotate.
• אם אתם לא מכירים את ההגדרות של crontab, תוכלו לקרוא את המדריך של crontab.

הפעלת רוטציה של יומנים

הקטע הזה רלוונטי לגרסאות 4.50.00 ו-4.51.00 של Edge for Private Cloud.

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

כברירת מחדל, חלק מקובצי היומנים הראשיים בכל אחד מהרכיבים של 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 של Message Processor של הרכיב apigee.

אפשר להפעיל רוטציה של יומנים באמצעות כלים או מסגרות שונות, כמו logrotate, ‏ logback או log4j. בקטע הזה מוסבר איך להגדיר רוטציה של יומנים בקובץ /opt/apigee/var/log/edge-message-processor/edge-message-processor.log באמצעות logrotate ו-crontab.

הפעלת החלפת יומנים עבור edge-message-processor.log במעבדי הודעות

בקטע הזה נסביר איך מפעילים רוטציה של יומנים ביומני /opt/apigee/var/log/edge-message- processor/edge-message-processor.log במעבדי ההודעות של Edge.

בשלבים הבאים מוסבר איך מפעילים רוטציה של יומנים בקובץ 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 הבאה ל-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 ב-Message Processor

1. אחרי שהמשימה המתוזמנת של cron תפעל, יתבצע רוטציה של קובץ היומן. לפי הדוגמה שלמעלה, משימת ה-cron מתוזמנת לפעול כל יום בשעה 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 ונשמרים כקובץ GZ.

3. אם לא רואים שהקבצים מסוג edge-message-processor.log עוברים רוטציה, צריך לוודא שביצעתם בצורה נכונה את כל השלבים שמפורטים במאמר הפעלת רוטציית יומנים עבור edge-message-processor.log במעבדי הודעות. אם שכחתם לבצע שלב כלשהו, עליכם לחזור על כל השלבים בצורה נכונה.
4. אם עדיין לא הצלחתם להפעיל את רוטציית היומנים, פנו אל התמיכה של Apigee Edge.