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

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

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

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

התחלה מהירה

בקטע הזה מוסבר איך להתחיל לעבוד במהירות עם apigee-monit.

אם אתם משתמשים ב-Amazon Linux או Oracle-Linux-7.X, קודם להתקין את monit דרך Fedora. אחרת, מדלגים על השלב הזה.

sudo yum install -y https://kojipkgs.fedoraproject.org/packages/monit/5.25.1/1.el6/x86_64/monit-5.25.1-1.el6.x86_64.rpm

כדי להתקין את 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

/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

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

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

מידע על apigee-monit

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

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

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

ארכיטקטורה של אפיק מוניט

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

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

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

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

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

apigee-monit בודק היבטים שונים של רכיב, בהתאם לרכיב שהוא בודק. בטבלה הבאה אפשר לראות מה בודק 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"

מתייחס לממשק המשתמש הקלאסי ולא לממשק המשתמש החדש של Edge, ששם הרכיב שלו edge-management-ui

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

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

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

התקנת apigee-monit

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

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

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

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

עצירת רכיב וביטול המעקב שלו

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

/opt/apigee/apigee-service/bin/apigee-service apigee-monit stop-component -c 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

• 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:

conf_monit_httpd_port יציאת הדימון (daemon) של httpd. האפליקציה apigee-monit משתמשת ב-httpd כמרכז הבקרה האפליקציה ולהפעיל דוחות/סיכומים. ערך ברירת המחדל הוא 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 user:

   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 reload

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

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

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

פקודה	שימוש
report	/opt/apigee/apigee-service/bin/apigee-service apigee-monit report
summary	/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary

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

דוח

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

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

בדוגמה הבאה מוצג פלט של report בפלט AIO (הכול באחד) תצורה:

/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 (הכול באחד) תצורה:

/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 שמוגדרת בקובץ. (בשורות שהגיבו אין count.)

כדי להפסיק או להשבית את 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