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

Edge for Private Cloud גרסה 4.16.05

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

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

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

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

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

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

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

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

• יציאות 4526, 4527 ו-4528 בשרת הניהול, בנתב ובמעבד הבקשות
• יציאות 1099, 1100 ו-1101 בשרת הניהול, בנתב ובמעבד הבקשות
• יציאה 8081 בנתבים
• יציאות 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 ;

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

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

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

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

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

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

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

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

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

כלי מעקב

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