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

כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של Apigee X.
מידע

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

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

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

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

הפעלת הסיבוב של היומנים

הקטע הזה רלוונטי ל-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.

הפעלת סבב יומנים עבור 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. פותחים את 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.

אימות של סיבוב היומן עבור 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.