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

‫Apigee Edge for Private Cloud כולל את 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, פועלים לפי השלבים הבאים:

/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-monit כדי לוודא שהיא פועלת. מידע נוסף זמין במאמר מעקב אחרי apigee-monit.

ארכיטקטורת apigee-monit

במהלך ההתקנה וההגדרה של Apigee Edge for Private Cloud, אתם יכולים להתקין מופע נפרד של 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

בדוגמה הבאה מוצגת הגדרת ברירת המחדל של הרכיב Classic UI (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 for Private Cloud. עם זאת, אתם יכולים להוסיף הגדרות רכיבים משלכם לשירותים חיצוניים, כמו נקודת הקצה (endpoint) המטורגטת או שירות httpd. מידע נוסף זמין במאמר הגדרות של רכיבים שאינם של Apigee.

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

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

התקנת apigee-monit

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

בקטע הזה מוסבר איך להתקין את 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 (ממשק משתמש קלאסי)

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

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

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

שימו לב שהאפשרות "all" לא חוקית עבור 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:

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 שיכלול את הרכיב החדש בהגדרות הרכיבים שלו.

בדוגמה הבאה מופעל מחדש 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. כדי לעשות את זה, עורכים קובץ מאפיינים באמצעות השיטה קוד עם הגדרות. קובצי המאפיינים יישארו גם אחרי שתשדרגו את Apigee Edge for Private Cloud.

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

conf_monit_httpd_allow=allow username:"password"\nallow 127.0.0.1

כדי להתאים אישית את הגדרות ברירת המחדל של 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 for Private Cloud. לדוגמה, אתם יכולים להשתמש ב-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. מוסיפים את ההגדרות האישיות לקובץ החדש. בדוגמה הבאה נבדקת נקודת הקצה (endpoint) לטירגוט בשרת המקומי:

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

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

/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

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

יכול להיות שתופיע השגיאה 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-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, אפשר לעיין במסמכי התיעוד או בדפי ה-man של מערכת ההפעלה של השרת.

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