ריפוי עצמי עם אגוז חזיר

Edge for Private Cloud גרסה 4.19.01

ב-Apigee Edge לענן הפרטי יש את apigee-monit – כלי שמבוסס על שירות monit בקוד פתוח. מדי פעם apigee-monit עורך סקר של שירותי Edge. אם שירות מסוים לא זמין, apigee-monit מנסה להפעיל אותו מחדש.

כדי להשתמש באפליקציה apigee-monit, צריך להתקין אותה באופן ידני. זה לא חלק מההתקנה הרגילה.

כברירת מחדל, האפליקציה apigee-monit בודקת את הסטטוס של שירותי Edge כל 60 שניות.

התחלה מהירה

הטבלה הבאה מראה איך להתחיל להשתמש ב-apigee-monit באופן מיידי:

  להתקנת apigee-monit
/opt/apigee/apigee-service/bin/apigee-service apigee-monit install
/opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
/opt/apigee/apigee-service/bin/apigee-service apigee-monit start

הפעולה הזו מתקינה את apigee-monit ומתחילה לעקוב אחר כל הרכיבים בצומת כברירת מחדל.

  הפסקת מעקב אחר רכיבים
/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c component_name
/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all
  הפעלת מעקב אחר רכיבים
/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c component_name
/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c all
  קבלת מידע על סטטוס סיכום
/opt/apigee/apigee-service/bin/apigee-service apigee-monit report
/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary
  עיון בקובצי היומן של apigee-monit
cat /opt/apigee/var/log/apigee-monit/apigee-monit.log

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

מידע על apigee-monit

הרכיב apigee-monit עוזר לוודא שכל הרכיבים בצומת פועלים. הוא עושה זאת באמצעות מגוון שירותים, כולל:

  • הפעלת השירותים מחדש נכשלה
  • פרטי הסיכום מוצגים
  • סטטוס המעקב אחר הרישום ביומן
  • שליחת התראות
  • מעקב אחרי שירותים מסוג non-Edge

עינת ממליץ לעקוב אחרי apigee-monit כדי לוודא שהוא פועל. למידע נוסף, קראו את המאמר מעקב אחר apigee-monit.

אדריכלות של פיג'י מוני

במהלך ההתקנה וההגדרות של Apigee Edge לענן פרטי, יש אפשרות להתקין מכונה נפרדת של apigee-monit בכל צומת באשכול. המכונות הנפרדות האלה עם apigee-monit פועלות בנפרד אחת מהשנייה: הן לא מעבירות את סטטוס הרכיבים לצמתים האחרים ולא מוסרות לאף שירות מרכזי כשלים בכלי השירות למעקב.

התמונה הבאה מציגה את הארכיטקטורה apigee-monit באשכול 5 צמתים:

איור 1: מופע נפרד של apigee-monit פועל בנפרד על כל צומת באשכול

פלטפורמות נתמכות

ב-apigee-monit יש תמיכה בפלטפורמות הבאות לאשכול הענן הפרטי שלך. (מערכת ההפעלה הנתמכת בשירות apigee-monit תלויה בגרסת הענן הפרטי).

מערכת הפעלה גרסת ענן פרטי
v4.50.00 v4.51.00 v4.52.00
CentOS 7.5, 7.6, 7.7, 7.8 7.5, 7.6, 7.7, 7.8 7.5, 7.6, 7.7, 7.8
RedHat Enterprise Linux (RHEL) 7.5, 7.6, 7.7, 7.8 7.5, 7.6, 7.7, 7.8, 7.9, 8.0 7.5, 7.6, 7.7, 7.8, 7.9, 8.0
Oracle Linux 7.5, 7.6, 7.7, 7.8 7.5, 7.6, 7.7, 7.8 7.5, 7.6, 7.7, 7.8
* ללא תמיכה טכנית, אפשר להתקין את apigee-monit ולהשתמש בו ב-CentOS/RHEL/Oracle בגרסה 6.9 עבור Apigee Edge בגרסה 4.19.01.

הגדרות הרכיבים

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

כברירת מחדל, apigee-monit עוקב אחרי כל רכיבי Edge בצומת באמצעות הגדרות הרכיבים שהוגדרו מראש. כדי לראות את הגדרות ברירת המחדל, אפשר לעיין בקובצי התצורה של הרכיב apigee-monit. לא ניתן לשנות את הגדרות ברירת המחדל של הרכיבים.

apigee-monit בודק היבטים שונים של הרכיב, בהתאם לרכיב שהוא בודק. בטבלה הבאה אפשר לראות מה apigee-monit בודק לכל רכיב, ואיפה נמצאת ההגדרה של כל רכיב. שימו לב שחלק מהרכיבים מוגדרים בקובץ תצורה אחד, ולאחרים יש הגדרות משלהם.

רכיב מיקום ההגדרה מה נמצא במעקב
שרת ניהול /opt/apigee/edge-management-server/monit/default.conf בדיקות apigee-monit:
  • היציאות שצוינו פתוחות ומקבלות בקשות
  • יש תמיכה בפרוטוקולים שצוינו
  • סטטוס התגובה

כמו כן, לרכיבים האלה apigee-monit:

  • מחייב מספר כשלים בתוך מספר נתון של מחזורים לפני ביצוע פעולה
  • מגדיר נתיב בקשה בהתאמה אישית
מעבד הודעות /opt/apigee/edge-message-processor/monit/default.conf
שרת Postgres /opt/apigee/edge-postgres-server/monit/default.conf
שרת Qpid /opt/apigee/edge-qpid-server/monit/default.conf
נתב /opt/apigee/edge-router/monit/default.conf
Cassandra
ממשק משתמש Edge
OpenLDAP
Postgres
Qpid
גן החיות (zokeeper)
/opt/apigee/data/apigee-monit/monit.conf בדיקות apigee-monit:
  • השירות פועל

הדוגמה הבאה מראה את הגדרות ברירת המחדל של הרכיב ברכיב edge-router:

check host edge-router with address localhost
  restart program = "/opt/apigee/apigee-service/bin/apigee-service edge-router monitrestart"
  if failed host 10.1.1.0 port 8081 and protocol http
    and request "/v1/servers/self/uuid"
    with timeout 15 seconds
    for 2 times within 3 cycles
  then restart

  if failed port 15999 and protocol http
    and request "/v1/servers/self"
    and status < 600
    with timeout 15 seconds
    for 2 times within 3 cycles
  then restart

הדוגמה הבאה מראה את הגדרות ברירת המחדל של הרכיב edge-ui:

check process edge-ui
 with pidfile /opt/apigee/var/run/edge-ui/edge-ui.pid
 start program = "/opt/apigee/apigee-service/bin/apigee-service edge-ui start" with timeout 55 seconds
 stop program = "/opt/apigee/apigee-service/bin/apigee-service edge-ui stop"

לא ניתן לשנות את הגדרות ברירת המחדל של הרכיבים של אף רכיב של Apigee Edge לענן פרטי. עם זאת, אתם יכולים להוסיף הגדרות משלכם לרכיבים עבור שירותים חיצוניים, כמו נקודת הקצה (endpoint) של היעד או השירות httpd. מידע נוסף זמין במאמר הגדרות של רכיבים שאינם Apigee.

כברירת מחדל, apigee-monit עוקב אחר כל הרכיבים בצומת שבו הוא פועל. אפשר להפעיל ולהשבית אותה עבור כל הרכיבים או עבור רכיבים ספציפיים. מידע נוסף זמין בדפים הבאים:

התקנה של apigee-monit

apigee-monit לא מותקן כברירת מחדל, ואפשר להתקין אותו ידנית אחרי שמשדרגים או מתקינים את גרסה 4.19.01 ואילך של Apigee Edge לענן פרטי.

בקטע הזה מוסבר איך להתקין את apigee-monit בפלטפורמות הנתמכות ובגרסה 6.9 של CentOS/RHEL/Oracle Linux, שלא נתמכות.

מידע נוסף על uninstalling apigee-monit זמין במאמר הסרת ההתקנה apigee-monit.

התקנה של apigee-monit בפלטפורמה נתמכת

בקטע הזה מוסבר איך להתקין את apigee-monit בפלטפורמה נתמכת.

כדי להתקין את apigee-monit בפלטפורמה נתמכת:

  1. מתקינים את apigee-monit באמצעות הפקודה הבאה:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit install
  2. מגדירים את apigee-monit באמצעות הפקודה הבאה:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
  3. מפעילים את apigee-monit עם הפקודה הבאה:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit start
  4. חוזרים על התהליך בכל צומת באשכול.

התקנה של apigee-monit בפלטפורמה שאינה נתמכת

הפקודה apigee-monit לא נתמכת בגרסה 6.9 של CentOS/RHEL/Oracle Linux, אבל בקטע הזה מוסבר איך להתקין אותה.

כדי להתקין את apigee-monit בגרסה 6.9 של CentOS/RHEL/Oracle Linux:

  1. מתקינים את מאגר החבילות הנוספות של Enterprise Linux (או בקיצור EPEL):
    sudo yum install epel-release
  2. השבתת EPEL:
    yum-config-manager --disable epel
  3. באופן זמני, מפעילים את EPEL ומתקינים את monit:
    yum --enablerepo=epel install monit

    חשוב לזכור שצריך להשבית את מאגר ה-EPEL אחרי שמתקינים את monit. האפשרות enablerepo מפעילה רק את המאגר שצוין בפקודה הנוכחית.

  4. מתקינים את apigee-monit:
    apigee-service apigee-monit install
    apigee-service apigee-monit configure
    apigee-service apigee-monit start
  5. אחרי שמתקינים את apigee-monit, צריך לוודא ש-EPEL מושבת:
    yum repolist all | grep epel/x86_64
    !epel/x86_64                  Extra Packages for Enterprise Linu disabled

    בדוגמה הזו רואים שמאגר EPEL מושבת. עם זאת, אם היא לא מושבתת, צריך להשבית אותה:

    sudo yum-config-manager --disable epel

הפסקה והתחלה של רכיבי המעקב

כששירות מפסיק לפעול מסיבה כלשהי, apigee-monit מנסה להפעיל מחדש את השירות.

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

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

הפסקת רכיב כלשהו וביטול המעקב אחריו

כדי להפסיק רכיב מסוים ולבטל את המעקב אחריו, מריצים את הפקודה הבאה:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit stop-component -c component_name
המאפיין component_name יכול להיות אחת מהאפשרויות הבאות:
  • apigee-cassandra (קסנדרה)
  • apigee-openldap (OpenLDAP)
  • apigee-postgresql (מסד נתונים של PostgreSQL)
  • apigee-qpidd (קיפוד)
  • apigee-sso (כניסה יחידה (SSO))
  • apigee-zookeeper (ZooKeeper)
  • edge-management-server (שרת ניהול)
  • edge-management-ui (ממשק קצה חדש של Edge)
  • edge-message-processor (מעבד הודעות)
  • edge-postgres-server (שרת Postgres)
  • edge-qpid-server (שרת Qpid)
  • edge-router (נתב קצה)
  • edge-ui (ממשק משתמש קלאסי)

לתשומת ליבך: האפשרות 'הכול' אינה אפשרות חוקית עבור stop-component. באמצעות stop-component אפשר להפסיק את המעקב אחרי רכיב אחד בלבד בכל פעם.

כדי להפעיל מחדש את הרכיב ולהמשיך את המעקב, מריצים את הפקודה הבאה:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit start-component -c component_name

לתשומת ליבך: האפשרות 'הכול' אינה אפשרות חוקית עבור start-component.

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

ביטול מעקב אחר רכיב (ללא הפסקה)

כדי לבטל מעקב אחר רכיב (בלי להפסיק אותו), מריצים את הפקודה הבאה:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c component_name
המאפיין component_name יכול להיות אחת מהאפשרויות הבאות:
  • apigee-cassandra (קסנדרה)
  • apigee-openldap (OpenLDAP)
  • apigee-postgresql (מסד נתונים של PostgreSQL)
  • apigee-qpidd (קיפוד)
  • apigee-sso (כניסה יחידה (SSO))
  • apigee-zookeeper (ZooKeeper)
  • edge-management-server (שרת ניהול)
  • edge-management-ui (ממשק קצה חדש של Edge)
  • edge-message-processor (מעבד הודעות)
  • edge-postgres-server (שרת Postgres)
  • edge-qpid-server (שרת Qpid)
  • edge-router (נתב קצה)
  • edge-ui (ממשק משתמש קלאסי)

כדי להמשיך לעקוב אחרי הרכיב, מריצים את הפקודה הבאה:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c component_name

ביטול המעקב אחר כל הרכיבים (בלי לעצור אותם)

כדי לבטל את המעקב אחר כל הרכיבים (בלי להפסיק אותם), מריצים את הפקודה הבאה:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all

כדי להמשיך לעקוב אחרי כל הרכיבים, מריצים את הפקודה הבאה:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c all

הפסקת כל הרכיבים וביטול המעקב אחריהם

כדי להפסיק את כל הרכיבים ולבטל את המעקב אחריהם, מריצים את הפקודות הבאות:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all
/opt/apigee/apigee-service/bin/apigee-all stop

כדי להפעיל מחדש את כל הרכיבים ולהמשיך את המעקב, מריצים את הפקודות הבאות:

/opt/apigee/apigee-service/bin/apigee-all start
/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c all

כדי להפסיק את המעקב אחרי כל הרכיבים, אפשר גם להשבית את apigee-monit, כפי שמתואר במאמר עצירה, הפעלה והשבתה של apigee-monit.

הפסקה, הפעלה והשבתה של apigee-monit

כמו בכל שירות, אפשר להפסיק ולהפעיל את apigee-monit באמצעות הפקודה apigee-service. בנוסף, ב-apigee-monit יש תמיכה בפקודה unmonitor, שמאפשרת להפסיק את המעקב אחרי רכיבים באופן זמני.

הפסקת apigee-monit

כדי להפסיק את apigee-monit, משתמשים בפקודה הבאה:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit stop

התחלת השימוש ב-apigee-monit

כדי להפעיל את apigee-monit, משתמשים בפקודה הבאה:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit start

השבתת apigee-monit

ניתן להשעות את המעקב אחר כל הרכיבים בצומת באמצעות הפקודה הבאה:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all

לחלופין, אפשר להשבית את apigee-monit באופן סופי על ידי הסרתו מהצומת, כפי שמתואר בהסרת ההתקנה של apigee-monit.

הסרה של apigee-monit

כדי להסיר את apigee-monit:

  1. אם מגדירים משימת cron למעקב אחר apigee-monit, צריך להסיר את המשימה cron לפני ההסרה של apigee-monit:
    sudo rm /etc/cron.d/apigee-monit.cron
  2. עוצרים את apigee-monit באמצעות הפקודה הבאה:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit stop
  3. מסירים את ההתקנה של apigee-monit באמצעות הפקודה הבאה:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit uninstall
  4. חוזרים על התהליך בכל צומת באשכול.

מעקב אחר רכיב שהותקן לאחרונה

אם מתקינים רכיב חדש בצומת שבו פועל apigee-monit, אפשר להתחיל לעקוב אחריו על ידי הרצת הפקודה restart של apigee-monit. הפעולה הזו יוצרת קובץ monit.conf חדש שיכלול את הרכיב החדש בהגדרות הרכיבים שלו.

הדוגמה הבאה גורמת להפעלה מחדש של apigee-monit:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit restart

התאמה אישית של apigee-monit

ניתן להתאים אישית הגדרות שונות של apigee-monit, כולל:

  1. הגדרות ברירת מחדל של בקרת apigee-monit
  2. הגדרות גלובליות
  3. הגדרות של רכיבים שאינם Apigee

הגדרות ברירת המחדל לבקרת apigee-monit

אפשר להתאים אישית את הגדרות ברירת המחדל של בקרת apigee-monit, כמו תדירות בדיקות הסטטוס והמיקומים של קובצי apigee-monit. כדי לעשות זאת, אפשר לערוך קובץ מאפיינים באמצעות השיטה קוד עם config. קובצי המאפיינים יישמרו גם אחרי שתשדרגו את Apigee Edge לענן פרטי.

בטבלה הבאה מפורטות הגדרות ברירת המחדל של אמצעי הבקרה של apigee-monit שניתן להתאים אישית:

נכס התיאור
conf_monit_httpd_port נמל הדימון (daemon) של httpd. httpd משמש את apigee-monit לאפליקציית מרכז הבקרה וכדי להפעיל דוחות/סיכומים. ערך ברירת המחדל הוא 2812.
conf_monit_httpd_allow מגבלות על הבקשות לדימון (daemon) של httpd. apigee-monit משתמש ב-httpd כדי להריץ את אפליקציית מרכז הבקרה שלו ולהפעיל דוחות/סיכומים. הערך הזה צריך להפנות אל localhost (המארח שעליו מופעל httpd.

כדי לדרוש שהבקשות יכללו שם משתמש וסיסמה, יש להשתמש בתחביר הבא:

conf_monit_httpd_allow=allow username:"password"\nallow 127.0.0.1

כשמוסיפים שם משתמש וסיסמה, מוסיפים "\n" בין כל אילוץ. אין להוסיף בערך שורות חדשות או החזרות לתחילת השורה בפועל.

conf_monit_monit_datadir הספרייה שבה שמורים פרטי האירועים.
conf_monit_monit_delay_time משך הזמן שapigee-monit ממתינה לאחר הטעינה הראשונה לזיכרון לפני הפעלתו. הפעולה הזו משפיעה על apigee-monit רק על בדיקת התהליך הראשונה.
conf_monit_monit_logdir המיקום של קובץ היומן apigee-monit.
conf_monit_monit_retry_time התדירות שבה apigee-monit מנסה לבדוק כל תהליך. ברירת המחדל היא 60 שניות.
conf_monit_monit_rundir המיקום של קובצי ה-PID והמצב, שמשמשים את apigee-monit לבדיקת תהליכים.

כדי להתאים אישית את הגדרות ברירת המחדל של אמצעי הבקרה של apigee-monit:

  1. עורכים את הקובץ הבא:
    /opt/apigee/customer/application/monit.properties

    אם הקובץ לא קיים, יוצרים אותו ומגדירים את הבעלים למשתמש "apigee":

    chown apigee:apigee /opt/apigee/customer/application/monit.properties

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

  2. הגדרה או החלפה של ערכי נכסים בערכים החדשים.

    לדוגמה, כדי לשנות את המיקום של קובץ היומן ל-/tmp, צריך להוסיף או לערוך את המאפיין הבא:

    conf_monit_monit_logdir=/tmp/apigee-monit.log

  3. שומרים את השינויים בקובץ monit.properties.
  4. מגדירים מחדש את apigee-monit באמצעות הפקודה הבאה:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
  5. טוענים מחדש את apigee-monit באמצעות הפקודה הבאה:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit reload

    אם אי אפשר להפעיל מחדש את apigee-monit, צריך לבדוק אם יש שגיאות בקובץ היומן, כפי שמתואר במאמר גישה לקובצי היומן של apigee-monit.

  6. חוזרים על התהליך עבור כל צומת באשכול.

הגדרות תצורה גלובליות

אפשר לקבוע הגדרות גלובליות של apigee-monit, לדוגמה, להוסיף התראות באימייל לגבי התראות. כדי לעשות את זה, יוצרים קובץ תצורה בספרייה /opt/apigee/data/apigee-monit ומפעילים מחדש את apigee-monit.

כדי לקבוע הגדרות אישיות גלובליות עבור apigee-monit:

  1. יוצרים קובץ תצורה חדש של רכיב במיקום הבא:
    /opt/apigee/data/apigee-monit/filename.conf

    כאשר filename יכול להיות כל שם קובץ חוקי, מלבד "monit".

  2. משנים את הבעלים של קובץ התצורה החדש למשתמש "apigee", כפי שמוצג בדוגמה הבאה:
    chown apigee:apigee /opt/apigee/data/apigee-monit/my-mail-config.conf
  3. מוסיפים את הגדרות התצורה הגלובליות לקובץ החדש. בדוגמה הבאה מגדירים שרת אימייל ומקבלים את ההתראות:
    SET MAILSERVER smtp.gmail.com PORT 465
      USERNAME "example-admin@gmail.com" PASSWORD "PASSWORD"
      USING SSL, WITH TIMEOUT 15 SECONDS
    
    SET MAIL-FORMAT {
      from: edge-alerts@example.com
      subject: Monit Alert -- Service: $SERVICE $EVENT on $HOST
    }
    SET ALERT fred@example.com
    SET ALERT nancy@example.com

    במסמכי התיעוד של monit תוכלו למצוא רשימה מלאה של האפשרויות להגדרה גלובלית.

  4. שומרים את השינויים בקובץ התצורה של הרכיב.
  5. טוענים מחדש את apigee-monit באמצעות הפקודה הבאה:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit reload

    אם לא מתבצעת הפעלה מחדש של apigee-monit, צריך לבדוק אם יש שגיאות בקובץ היומן, לפי ההוראות במאמר גישה לקובצי היומן של apigee-monit.

  6. חוזרים על התהליך עבור כל צומת באשכול.

הגדרות אישיות של רכיבים שאינם Apigee

אפשר להוסיף הגדרות אישיות משלכם ל-apigee-monit כדי לבדוק שירותים שלא נכללים ב-Apigee Edge לענן פרטי. לדוגמה, אתם יכולים להשתמש ב-apigee-monit כדי לבדוק שממשקי ה-API פועלים על ידי שליחת בקשות לנקודת הקצה (endpoint) של היעד.

כדי להוסיף הגדרות אישיות של רכיב שאינו Apigee:

  1. יוצרים קובץ תצורה חדש של רכיב במיקום הבא:
    /opt/apigee/data/apigee-monit/filename.conf

    כאשר filename יכול להיות כל שם קובץ חוקי, מלבד "monit".

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

  2. משנים את הבעלים של קובץ התצורה החדש למשתמש "apigee", כפי שמוצג בדוגמה הבאה:
    chown apigee:apigee /opt/apigee/data/apigee-monit/my-config.conf
  3. מוסיפים את ההגדרות המותאמות אישית לקובץ החדש. בדוגמה הבאה בודקים את נקודת הקצה של היעד בשרת המקומי:
    CHECK HOST localhost_validate_test WITH ADDRESS localhost
      IF FAILED
        PORT 15999
        PROTOCOL http
        REQUEST "/validate__test"
        CONTENT = "Server Ready"
        FOR 2 times WITHIN 3 cycles
      THEN alert

    במסמכי התיעוד של monit יש רשימה מלאה של הגדרות אפשריות.

  4. שומרים את השינויים בקובץ התצורה.
  5. טוענים מחדש את apigee-monit באמצעות הפקודה הבאה:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit reload

    אם לא מתבצעת הפעלה מחדש של apigee-monit, צריך לבדוק אם יש שגיאות בקובץ היומן, לפי ההוראות במאמר גישה לקובצי היומן של apigee-monit.

  6. חוזרים על התהליך עבור כל צומת באשכול.

חשוב לשים לב שהאפשרות הזו מיועדת רק לרכיבים שאינם Edge. אי אפשר להתאים אישית את הגדרות הרכיבים של רכיבי Edge.

גישה לקובצי יומן apigee-monit

apigee-monit מתעד את כל הפעילות, כולל אירועים, הפעלות מחדש, שינויים בהגדרות והתראות בקובץ יומן.

מיקום ברירת המחדל של קובץ היומן הוא:

/opt/apigee/var/log/apigee-monit/apigee-monit.log

אפשר לשנות את מיקום ברירת המחדל באמצעות התאמה אישית של הגדרות הבקרה של apigee-monit.

רשומות של קובצי יומן רישום הן בפורמט הבא:

'edge-message-processor' trying to restart
[UTC Dec 14 16:20:42] info     : 'edge-message-processor' trying to restart
'edge-message-processor' restart: '/opt/apigee/apigee-service/bin/apigee-service edge-message-processor monitrestart'

לא ניתן להתאים אישית את הפורמט של הרשומות בקובץ היומן apigee-monit.

הצגת הסטטוס המצטבר באמצעות apigee-monit

apigee-monit כולל את הפקודות הבאות עם פרטי סטטוס מרוכזים של הרכיבים בצומת:

פקודה Usage
report
/opt/apigee/apigee-service/bin/apigee-service apigee-monit report
summary
/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary

כל אחת מהפקודות האלה מוסברת בפירוט בקטעים הבאים.

report

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

/opt/apigee/apigee-service/bin/apigee-service apigee-monit report

בדוגמה הבאה מוצג פלט report בתצורת AIO (all-in-one):

/opt/apigee/apigee-service/bin/apigee-service apigee-monit report
up:            11 (100.0%)
down:           0 (0.0%)
initialising:   0 (0.0%)
unmonitored:    1 (8.3%)
total:         12 services

בדוגמה הזו, 11 מתוך 12 השירותים מדווחים על ידי apigee-monit כפעילים. אחד השירותים לא נמצא כרגע במעקב.

יכול להיות שתופיע הודעת שגיאה Connection refused במהלך ההרצה הראשונה של הפקודה report. במקרה כזה, צריך להמתין עד לסיום המאפיין conf_monit_monit_delay_time ולנסות שוב.

סיכום

הפקודה summary מפרטת כל רכיב ומספקת את הסטטוס שלו. בדוגמה הבאה מפעילים את הפקודה summary:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary

בדוגמה הבאה מוצג פלט summary בתצורת AIO (all-in-one):

/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary
Monit 5.25.1 uptime: 4h 20m
 Service Name                     Status                      Type
 host_name                        OK                          System
 apigee-zookeeper                 OK                          Process
 apigee-cassandra                 OK                          Process
 apigee-openldap                  OK                          Process
 apigee-qpidd                     OK                          Process
 apigee-postgresql                OK                          Process
 edge-ui                          OK                          Process
 edge-qpid-server                 OK                          Remote Host
 edge-postgres-server             OK                          Remote Host
 edge-management-server           OK                          Remote Host
 edge-router                      OK                          Remote Host
 edge-message-processor           OK                          Remote Host

אם הופיעה השגיאה Connection refused בפעם הראשונה שמריצים את הפקודה summary, כדאי להמתין עד לסיום המאפיין conf_monit_monit_delay_time ואז לנסות שוב.

מעקב אחר apigee-monit

מומלץ לבדוק באופן קבוע ש-apigee-monit פועל בכל צומת.

כדי לבדוק אם apigee-monit פועל, משתמשים בפקודה הבאה:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit

Apigee ממליצה לבצע את הפקודה הזו באופן תקופתי בכל צומת שבו פועל apigee-monit. אחת הדרכים לעשות זאת היא באמצעות כלי כמו cron, שמבצע משימות מתוזמנות במרווחי זמן מוגדרים מראש.

כדי להשתמש בcron למעקב אחר apigee-monit:

  1. מוסיפים תמיכה ב-cron על ידי העתקת הספרייה apigee-monit.cron לספרייה /etc/cron.d, כמו בדוגמה הבאה:
    cp /opt/apigee/apigee-monit/cron/apigee-monit.cron /etc/cron.d/
  2. כדי לערוך את הקובץ apigee-monit.cron, צריך לפתוח אותו.

    הקובץ apigee-monit.cron מגדיר את המשימה cron שצריך לבצע, וגם את התדירות שבה המשימה תופעל. בדוגמה הבאה מוצגים ערכי ברירת המחדל:

    # Cron entry to check if monit process is running. If not start it
    */2 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit

    בקובץ הזה נעשה שימוש בתחביר הבא, שלפיו חמשת השדות הראשונים מגדירים את השעה שבה תתבצע פעולת apigee-monit:

    min hour day_of_month month day_of_week task_to_execute

    לדוגמה, זמן הביצוע המוגדר כברירת מחדל הוא */2 * * * *, וזה מורה ל-cron לבדוק את התהליך apigee-monit כל 2 דקות.

    לא ניתן לבצע משימה של cron בתדירות גבוהה מפעם לדקה.

    למידע נוסף על השימוש ב-cron, אפשר לעיין במסמכי התיעוד של מערכת ההפעלה של השרת או בדפי העבודה.

  3. יש לשנות את ההגדרות של cron בהתאם למדיניות הארגון שלך. לדוגמה, כדי לשנות את תדירות הביצוע לכל 5 דקות, צריך להגדיר את הגדרת המשימה כך:
    */5 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit
  4. שומרים את הקובץ apigee-monit.cron.
  5. חוזרים על התהליך עבור כל צומת באשכול.

אם cron לא יתחיל לצפות ב-apigee-monit, עליך לבדוק את הדברים הבאים:

  • אחרי הגדרת המשרה cron יש שורה ריקה.
  • בקובץ הוגדרה רק משימת cron אחת. (שורות עם תגובות לא נספרות).

אם רוצים להפסיק או להשבית את apigee-monit באופן זמני, צריך להשבית גם את משימת cron הזו, אחרת cron יופעל מחדש על apigee-monit.

כדי להשבית את cron צריך לבצע אחת מהפעולות הבאות:

  • מוחקים את הקובץ /etc/cron.d/apigee-monit.cron:
    sudo rm /etc/cron.d/apigee-monit.cron

    כדי להפעיל מחדש את cron לצפייה ב-apigee-monit, יהיה עליך להעתיק אותו מחדש.

    OR

  • עורכים את הקובץ /etc/cron.d/apigee-monit.cron ומגיבים להגדרת המשימה על ידי הוספה של "#" בתחילת השורה. לדוגמה:
    # 10 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit