שיטות מומלצות למעקב

Edge for Private Cloud גרסה 4.17.05

מעקב אחרי התראות

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

הגדרת סף לקבלת התראות

מגדירים סף שמעליו תיווצר התראה. הערך שתגדירו תלוי בהגדרות החומרה שלכם. צריך להגדיר את הסף בהתאם לקיבולת שלכם. לדוגמה, יכול להיות ש-Apigee Edge יהיה נמוך מדי אם יש לכם קיבולת של 6GB בלבד. אפשר להקצות סף עם קריטריון של שווה ל- (=) או גדול מ- (>). אפשר גם לציין מרווח זמן בין שני אירועים עוקבים של יצירת התראות. אתם יכולים להשתמש באפשרות של שעות/דקות/שניות.

קריטריונים להגדרת התראות ברמת המערכת

בטבלה הבאה מתוארים הקריטריונים:

בדיקת יציאות ספציפיות ל-Apigee ויציאות של צד שלישי

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

• יציאות 4526, 4527 ו-4528 בשרת הניהול, בנתב ובמעבד הבקשות
• יציאות 1099, 1100 ו-1101 בשרת הניהול, בנתב ובמעבד הבקשות
• יציאות 8081 ו-15999 בנתבים
• יציאות 8082 ו-8998 במעבדי הבקשות

יציאה 8080 בשרת הניהול. צריך לבדוק את היציאות הבאות של צד שלישי כדי לוודא שהן פעילות:

• יציאת Qpid‏ 5672
• יציאה 5432 של Postgres
• יציאות Cassandra‏ 7000, ‏ 7199, ‏ 9042, ‏ 9160
• יציאה 2181 של ZooKeeper
• יציאת OpenLDAP‏ 10389

כדי לקבוע לאיזו יציאה כל רכיב של Apigee מאזין לקריאות ל-API, צריך לשלוח את הקריאות הבאות ל-API אל שרת הניהול (בדרך כלל ביציאה 8080):

curl -v -u <username>:<password> http://<host>:<port>/v1/servers?pod=gateway&region=dc-1
curl -v -u <username>:<password> http:// <host>:<port>/v1/servers?pod=central&region=dc-1
curl -v -u <username>:<password> http:// <host>:<port>/v1/servers?pod=analytics&region=dc-1

הפלט של הפקודות האלה יכיל קטעים שדומים לאלה שמוצגים בהמשך. בקטע http.management.port מופיע מספר היציאה של הרכיב שצוין.

{
  "externalHostName" : "localhost",
  "externalIP" : "111.222.333.444",
  "internalHostName" : "localhost",
  "internalIP" : "111.222.333.444",
  "isUp" : true,
  "pod" : "gateway",
  "reachable" : true,
  "region" : "default",
  "tags" : {
    "property" : [ {
      "name" : "Profile",
      "value" : "Router"
    }, {
      "name" : "rpc.port",
      "value" : "4527"
    }, {
      "name" : "http.management.port",
      "value" : "8081"
    }, {
      "name" : "jmx.rmi.port",
      "value" : "1100"
    } ]
  },
  "type" : [ "router" ],
  "uUID" : "2d4ec885-e20a-4173-ae87-10be38b35750"
}

צפייה ביומנים

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

לדוגמה, יומן מערכת טיפוסי של רכיב מכיל את הרשומות הבאות:

TimeStamp = 25/01/13 19:25 ; NextDelay = 30
Memory
HeapMemoryUsage = {used = 29086176}{max = 64880640} ;    
NonHeapMemoryUsage = {init = 24313856}{committed = 57278464} ;
Threading
PeakThreadCount = 53 ; ThreadCount = 53 ;
OperatingSystem
SystemLoadAverage = 0.25 ;

אפשר לערוך את הקובץ ‎ /opt/apigee/conf/logback.xml כדי לשלוט במנגנון הרישום ביומן בלי להפעיל מחדש את השרת. הקובץ logback.xml מכיל את המאפיין הבא, שמגדיר את התדירות שבה מנגנון הרישום ביומן בודק אם יש שינויים בהגדרות בקובץ logback.xml:

<configuration scan="true" scanPeriod="30 seconds" >

כברירת מחדל, מנגנון הרישום ביומן בודק אם יש שינויים כל דקה. אם לא מציינים את יחידות הזמן במאפיין scanPeriod, ברירת המחדל היא אלפיות השנייה.

בטבלה הבאה מפורט המיקום של קובצי היומן של רכיבי Apigee Edge Private Cloud.

הפעלת יומני ניפוי באגים למעבד הבקשות ולממשק המשתמש של Edge

כדי להפעיל יומני ניפוי באגים למעבד הבקשות:

1. בצומת של מעבד הבקשות, עורכים את /opt/apigee/customer/application/messsage-processor.properties. אם הקובץ הזה לא קיים, יוצרים אותו.
2. מוסיפים לקובץ את המאפיין הבא:
   conf_system_log.level=DEBUG
3. מפעילים מחדש את מעבד הבקשות:
   > ‎/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

כדי להפעיל יומני ניפוי באגים בממשק המשתמש של Edge:

1. בצומת של ממשק המשתמש של Edge, עורכים את /opt/apigee/customer/application/ui.properties. אם הקובץ הזה לא קיים, יוצרים אותו.
2. מוסיפים לקובץ את המאפיין הבא:
   conf_application_logger.application=DEBUG
3. מפעילים מחדש את ממשק המשתמש של Edge:
   > ‎/opt/apigee/apigee-service/bin/apigee-service edge-ui restart

כלי מעקב

כלי מעקב כמו Nagios,‏ Collectd,‏ Graphite,‏ Splunk,‏ Sumologic ו-Monit יכולים לעזור לכם לעקוב אחרי כל הסביבה הארגונית והתהליכים העסקיים.