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

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

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

ב-Edge for Private Cloud, חלק מקובצי היומן הראשיים בכל apigeeרכיב מוגדרים עם מנגנון רוטציה שמוגדר כברירת מחדל. לדוגמה, ברכיב מעבד בקשות, הקבצים הבאים מוגדרים עם מנגנון ברירת מחדל של רוטציה באמצעות 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-* יוצר גם קובץ יומן נוסף שהוא פלט מופנה של המסוף של הרכיב הרלוונטי. במקרה של רכיב מעבד בקשות, הקובץ הזה נקרא /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 מוגדרים עם מנגנון סיבוב ברירת מחדל. לדוגמה, ברכיב מעבד בקשות, הקבצים הבאים מוגדרים עם מנגנון ברירת המחדל של החלפה:

• /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 לא מוגדרים עם רוטציה כברירת מחדל. לדוגמה, החלפת יומנים לא מוגדרת כברירת מחדל בקובץ apigee Message Processor של רכיב edge-message-processor.log.

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

   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. פותחים את apigee של המשתמש crontab באמצעות הפקודה הבאה:

   sudo crontab -u apigee -e
   

5. מוסיפים את משימת ה-cron הבאה אל apigee crontab של המשתמש :

   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 המתוזמנת תפעל, קובץ היומן יוחלף. בדוגמה שלמעלה, משימת ה-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.

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