ב-Apigee Edge לענן הפרטי יש את apigee-monit
– כלי שמבוסס על שירות monit בקוד פתוח. מדי פעם apigee-monit
עורך סקר של שירותי Edge. אם שירות מסוים לא זמין, apigee-monit
מנסה להפעיל אותו מחדש.
כדי להשתמש באפליקציה apigee-monit
, צריך להתקין אותה באופן ידני. זה לא חלק מההתקנה הרגילה.
כברירת מחדל, האפליקציה apigee-monit
בודקת את הסטטוס של שירותי Edge כל 60 שניות.
התחלה מהירה
בקטע הזה מוסבר איך להתחיל לעבוד עם apigee-monit
במהירות.
משתמשים ב-Amazon Linux צריכים להתקין את 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
, צריך לפעול לפי השלבים הבאים:
להתקנת apigee-monit |
|
/opt/apigee/apigee-service/bin/apigee-service apigee-monit install הפעולה הזו מתקינה את |
|
הפסקת מעקב אחר רכיבים | |
/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 צמתים:
הגדרות הרכיבים
ב-apigee-monit
נעשה שימוש בהגדרות רכיב כדי לקבוע אחרי אילו רכיבים לעקוב, אילו היבטים של הרכיב צריך לבדוק ואיזו פעולה צריך לבצע במקרה של כשל.
כברירת מחדל, apigee-monit
עוקב אחרי כל רכיבי Edge בצומת באמצעות הגדרות הרכיבים שהוגדרו מראש. כדי לראות את הגדרות ברירת המחדל, אפשר לעיין בקובצי התצורה של הרכיב apigee-monit
. לא ניתן לשנות את הגדרות ברירת המחדל של הרכיבים.
apigee-monit
בודק היבטים שונים של הרכיב, בהתאם לרכיב שהוא בודק. בטבלה הבאה אפשר לראות מה apigee-monit
בודק לכל רכיב, ואיפה נמצאת ההגדרה של כל רכיב. שימו לב שחלק מהרכיבים מוגדרים בקובץ תצורה אחד, ולאחרים יש הגדרות משלהם.
רכיב | מיקום ההגדרה | מה נמצא במעקב |
---|---|---|
שרת ניהול | /opt/apigee/edge-management-server/monit/default.conf |
בדיקות 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"
הכלל הזה חל על ממשק המשתמש הקלאסי, ולא על ממשק המשתמש החדש של Edge ששם הרכיב שלו הוא edge-management-ui
.
לא ניתן לשנות את הגדרות ברירת המחדל של הרכיבים של אף רכיב של Apigee Edge לענן פרטי. עם זאת, אתם יכולים להוסיף הגדרות משלכם לרכיבים עבור שירותים חיצוניים, כמו נקודת הקצה (endpoint) של היעד או השירות httpd
. מידע נוסף זמין במאמר הגדרות של רכיבים שאינם Apigee.
כברירת מחדל, apigee-monit
עוקב אחר כל הרכיבים בצומת שבו הוא פועל. אפשר להפעיל ולהשבית אותה עבור כל הרכיבים או עבור רכיבים ספציפיים. מידע נוסף זמין בדפים הבאים:
התקנה של apigee-monit
apigee-monit
לא מותקן כברירת מחדל, ואפשר להתקין אותו ידנית אחרי שמשדרגים או מתקינים את גרסה 4.19.01 ואילך של Apigee Edge לענן פרטי.
בקטע הזה מוסבר איך להתקין את apigee-monit
.
מידע נוסף על uninstalling apigee-monit
זמין במאמר הסרת ההתקנה apigee-monit
.
התקנה של apigee-monit
בקטע הזה מוסבר איך להתקין את apigee-monit
.
כדי להתקין את apigee-monit
:
- מתקינים את
apigee-monit
באמצעות הפקודה הבאה:/opt/apigee/apigee-service/bin/apigee-service apigee-monit install
- מגדירים את
apigee-monit
באמצעות הפקודה הבאה:/opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
- מפעילים את
apigee-monit
עם הפקודה הבאה:/opt/apigee/apigee-service/bin/apigee-service apigee-monit start
- חוזרים על התהליך בכל צומת באשכול.
הפסקה והתחלה של רכיבי המעקב
כששירות מפסיק לפעול מסיבה כלשהי, 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
:
- אם מגדירים משימת
cron
למעקב אחרapigee-monit
, צריך להסיר את המשימהcron
לפני ההסרה שלapigee-monit
:sudo rm /etc/cron.d/apigee-monit.cron
- עוצרים את
apigee-monit
באמצעות הפקודה הבאה:/opt/apigee/apigee-service/bin/apigee-service apigee-monit stop
- מסירים את ההתקנה של
apigee-monit
באמצעות הפקודה הבאה:/opt/apigee/apigee-service/bin/apigee-service apigee-monit uninstall
- חוזרים על התהליך בכל צומת באשכול.
מעקב אחר רכיב שהותקן לאחרונה
אם מתקינים רכיב חדש בצומת שבו פועל apigee-monit
, אפשר להתחיל לעקוב אחריו
על ידי הרצת הפקודה restart
של apigee-monit
. הפעולה הזו יוצרת קובץ monit.conf חדש שיכלול את הרכיב החדש בהגדרות הרכיבים שלו.
הדוגמה הבאה גורמת להפעלה מחדש של apigee-monit
:
/opt/apigee/apigee-service/bin/apigee-service apigee-monit restart
התאמה אישית של apigee-monit
ניתן להתאים אישית הגדרות שונות של apigee-monit
, כולל:
הגדרות ברירת המחדל לבקרת 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
:
- עורכים את הקובץ הבא:
/opt/apigee/customer/application/monit.properties
אם הקובץ לא קיים, יוצרים אותו ומגדירים את הבעלים למשתמש "apigee":
chown apigee:apigee /opt/apigee/customer/application/monit.properties
שימו לב: אם הקובץ כבר קיים, ייתכן שיהיו בו מאפיינים נוספים של הגדרה, מעבר לאלה שמפורטים בטבלה שלמעלה. אין לשנות מאפיינים אחרים מלבד אלה שצוינו למעלה.
הגדרה או החלפה של ערכי נכסים בערכים החדשים.
לדוגמה, כדי לשנות את המיקום של קובץ היומן ל-
/tmp
, צריך להוסיף או לערוך את המאפיין הבא:conf_monit_monit_logdir=/tmp/apigee-monit.log
- שומרים את השינויים בקובץ
monit.properties
. - מגדירים מחדש את
apigee-monit
באמצעות הפקודה הבאה:/opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
- טוענים מחדש את
apigee-monit
באמצעות הפקודה הבאה:/opt/apigee/apigee-service/bin/apigee-service apigee-monit reload
אם אי אפשר להפעיל מחדש את
apigee-monit
, צריך לבדוק אם יש שגיאות בקובץ היומן, כפי שמתואר במאמר גישה לקובצי היומן שלapigee-monit
. - חוזרים על התהליך עבור כל צומת באשכול.
הגדרות תצורה גלובליות
אפשר לקבוע הגדרות גלובליות של apigee-monit
, לדוגמה, להוסיף התראות באימייל לגבי התראות. כדי לעשות את זה, יוצרים קובץ תצורה בספרייה /opt/apigee/data/apigee-monit
ומפעילים מחדש את apigee-monit
.
כדי לקבוע הגדרות אישיות גלובליות עבור apigee-monit
:
- יוצרים קובץ תצורה חדש של רכיב במיקום הבא:
/opt/apigee/data/apigee-monit/filename.conf
כאשר filename יכול להיות כל שם קובץ חוקי, מלבד "monit".
- משנים את הבעלים של קובץ התצורה החדש למשתמש "apigee", כפי שמוצג בדוגמה הבאה:
chown apigee:apigee /opt/apigee/data/apigee-monit/my-mail-config.conf
- מוסיפים את הגדרות התצורה הגלובליות לקובץ החדש. בדוגמה הבאה מגדירים שרת אימייל ומקבלים את ההתראות:
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 תוכלו למצוא רשימה מלאה של האפשרויות להגדרה גלובלית.
- שומרים את השינויים בקובץ התצורה של הרכיב.
- טוענים מחדש את
apigee-monit
באמצעות הפקודה הבאה:/opt/apigee/apigee-service/bin/apigee-service apigee-monit reload
אם לא מתבצעת הפעלה מחדש של
apigee-monit
, צריך לבדוק אם יש שגיאות בקובץ היומן, לפי ההוראות במאמר גישה לקובצי היומן שלapigee-monit
. - חוזרים על התהליך עבור כל צומת באשכול.
הגדרות אישיות של רכיבים שאינם Apigee
אפשר להוסיף הגדרות אישיות משלכם ל-apigee-monit
כדי לבדוק שירותים שלא נכללים ב-Apigee Edge לענן פרטי. לדוגמה, אתם יכולים להשתמש ב-apigee-monit
כדי לבדוק שממשקי ה-API פועלים על ידי שליחת בקשות לנקודת הקצה (endpoint) של היעד.
כדי להוסיף הגדרות אישיות של רכיב שאינו Apigee:
- יוצרים קובץ תצורה חדש של רכיב במיקום הבא:
/opt/apigee/data/apigee-monit/filename.conf
כאשר filename יכול להיות כל שם קובץ חוקי, מלבד "monit".
ניתן ליצור כמה קובצי תצורה של רכיבים לפי הצורך. לדוגמה, אפשר ליצור קובץ תצורה נפרד לכל רכיב שאינו Apigee שברצונך לעקוב אחריו בצומת.
- משנים את הבעלים של קובץ התצורה החדש למשתמש "apigee", כפי שמוצג בדוגמה הבאה:
chown apigee:apigee /opt/apigee/data/apigee-monit/my-config.conf
- מוסיפים את ההגדרות המותאמות אישית לקובץ החדש. בדוגמה הבאה בודקים את נקודת הקצה של היעד בשרת המקומי:
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 יש רשימה מלאה של הגדרות אפשריות.
- שומרים את השינויים בקובץ התצורה.
- טוענים מחדש את
apigee-monit
באמצעות הפקודה הבאה:/opt/apigee/apigee-service/bin/apigee-service apigee-monit reload
אם לא מתבצעת הפעלה מחדש של
apigee-monit
, צריך לבדוק אם יש שגיאות בקובץ היומן, לפי ההוראות במאמר גישה לקובצי היומן שלapigee-monit
. - חוזרים על התהליך עבור כל צומת באשכול.
חשוב לשים לב שהאפשרות הזו מיועדת רק לרכיבים שאינם 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
:
- מוסיפים תמיכה ב-
cron
על ידי העתקת הספרייהapigee-monit.cron
לספרייה/etc/cron.d
, כמו בדוגמה הבאה:cp /opt/apigee/apigee-monit/cron/apigee-monit.cron /etc/cron.d/
- כדי לערוך את הקובץ
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
, אפשר לעיין במסמכי התיעוד של מערכת ההפעלה של השרת או בדפי העבודה. - יש לשנות את ההגדרות של
cron
בהתאם למדיניות הארגון שלך. לדוגמה, כדי לשנות את תדירות הביצוע לכל 5 דקות, צריך להגדיר את הגדרת המשימה כך:*/5 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit
- שומרים את הקובץ
apigee-monit.cron
. - חוזרים על התהליך עבור כל צומת באשכול.
אם 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