מוצג המסמך של 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, אפשר לקרוא את המאמר logהשבתה ידנית. - אם לא מכירים את ההגדרות של
crontab, אפשר לקרוא את המאמר crontab manual.
הפעלה של רוטציית יומנים
הקטע הזה רלוונטי ל-Edge for Private Cloud בגרסאות 4.50.00 ו-4.51.00.
רוטציית יומנים היא מנגנון שנועד להקל על הניהול של מערכות שיוצרות מספר רב של קובצי יומן. הוא מאפשר סיבוב, דחיסה, הסרה ודיוור באופן אוטומטי קובצי יומן.
כברירת מחדל, חלק מקובצי היומן הראשיים בכל אחד מרכיבי 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
קובץ מעבד (edge-message-processor.log).
אפשר להפעיל רוטציית יומנים באמצעות כלי עזר או מסגרות שונים, כמו logrotate,
logback או log4j. בקטע הזה מוסבר איך להגדיר יומן
סבב עבור /opt/apigee/var/log/edge-message-processor/edge-message-processor.log
קובץ באמצעות logrotate ו-crontab.
הפעלת סבב יומנים עבור dge-message-processor.log במעבדי הודעות
בקטע הזה מוסבר איך להפעיל סבב יומנים עבור /opt/apigee/var/log/edge-message-
processor/edge-message-processor.log יומנים במעבדי ההודעות של Edge.
השלבים הבאים מתארים כיצד להפעיל סבב יומנים עבור
קובץ edge-message-processor.log:
- פתיחת הקובץ
/opt/apigee/edge-message-processor/logrotate/logrotate.confבמחשב של מעבד ההודעות בכלי עריכה. אם הקובץ לא קיים, יוצרים אותו. לדוגמה:vi /opt/apigee/edge-message-processor/logrotate/logrotate.conf
- מוסיפים לקובץ קטע קוד שדומה לקטע הבא:
/opt/apigee/var/log/edge-message-processor/edge-message-processor.log { missingok copytruncate rotate 5 size 10M compress delaycompress notifempty nocreate sharedscripts }
- שומרים את השינויים.
- פותחים את
crontabשל המשתמשapigeeבאמצעות הפקודה הבאה:sudo crontab -u apigee -e
- צריך להוסיף את משימת ה-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
- שומרים את
crontabועוקבים אחרי הרוטציה ביומן במהלך ההרצה הבאה של משימת cron.
אימות סבב יומנים עבור edge-message-processor.log במעבד ההודעות
- אחרי שמשימת ה-cron המתוזמנת תופעל, קובץ היומן יוחלף. מהדוגמה שלמעלה,
משימת cron מתוזמנת לרוץ מדי יום בשעה 00:00 כדי לבצע רוטציה של הקובץ
edge-message- processor.log. -
מנווטים לספרייה
/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. - אם לא רואים שמתבצע סיבוב של
edge-message-processor.logהקבצים, לאחר מכן צריך לוודא שביצעתם את כל השלבים המפורטים הפעלה תקינה של סבב יומנים עבור dge-message-processor.log במעבדי הודעות. אם פספסתם שלב כלשהו, יש לחזור על השלבים האלה שוב בצורה נכונה. - אם הרוטציה של היומנים עדיין לא מופיעה, פנו אל התמיכה של Apigee Edge.