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

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

ב-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
• יציאה 10389 של SymasLDAP

כדי לקבוע באיזו יציאה כל רכיב של 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.

הפעלת יומני ניפוי באגים עבור מעבד ההודעות

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

1. בצומת של מעבד הבקשות, עורכים את הקובץ /opt/apigee/customer/application/message-processor.properties. אם הקובץ הזה לא קיים, צריך ליצור אותו.
2. מוסיפים את המאפיין הבא לקובץ:

   conf_system_log.level=DEBUG

3. מפעילים מחדש את מעבד הבקשות:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

שיטות מומלצות לשימוש ב-apigee-monit

כשמשתמשים ב-apigee-monit, מומלץ:

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

כלי מעקב

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