התקנת לוח בקרה של מעקב בטא

Edge for Private Cloud גרסה 4.17.05

דרישות מערכת

כדי לאסוף נתונים ממרכז הבקרה, צריך להתקין את apigee-telegraf בכל צומתי Edge. לכן, דרישות המערכת של apigee-telegraf זהות לאלה של צומת Edge שבו מתקינים אותו.

אפשר להתקין את apigee-grafana בצומת נפרד, או להשתמש מחדש באחד מצומתי Edge הקיימים, כמו Management Server או צומת ממשק המשתמש של Edge.

את apigee-influxdb אפשר להתקין בצומת Edge קיים, כמו צומת Management Server או צומת Edge UI, בלי לשנות את דרישות המערכת.

אם החלטתם להתקין את apigee-influxdb בצומת משלו מסיבות שקשורות לביצועים, הצומת צריך לעמוד בדרישות הבאות:

• מעבד עם 2 ליבות
• ‫RAM בנפח 4GB
• ‫250GB מקום בכונן (נתוני המעקב נמחקים אחרי חודש)
• ‫1,000 IOPS או יותר

מידע נוסף זמין ב מסמכי התיעוד של InfluxData.

דרישות היציאה של apigee-influxdb

יציאות 8086 ו-8183 צריכות להיות פתוחות בצומתי הנתונים של apigee-influxdb כדי שהצומת שמריץ את apigee-grafana ואת apigee-telegraf יוכל לגשת אליהם.

קובצי תצורה להתקנת רכיבים של מרכז הבקרה

כדי להתקין את הרכיבים apigee-telegraf ו-apigee-grafana, צריך להעביר קובץ תצורה לכלי apigee-service. שומרים את הקבצים האלה בספרייה שנגישה למשתמש apigee, כמו /opt/apigee/customer/application, ומוודאים שהם בבעלות המשתמש apigee.

פרמטרים להגדרה של apigee-telegraf

מגדירים את המאפיינים האלה בקובץ טקסט שמעבירים לפקודה setup של apigee-telegraf. לדוגמה, אפשר להגדיר אותם בקובץ טקסט בשם sa_telegraf.txt:

http://192.168.0.1:8086

פרמטרים להגדרה של apigee-grafana

מגדירים את המאפיינים האלה בקובץ טקסט שמעבירים לפקודה apigee-grafana setup. לדוגמה, אפשר להגדיר אותם בקובץ טקסט בשם sa_grafana.txt:

192.168.0.1

הוראות התקנה

כדי להתקין את רכיבי מרכז הבקרה, פועלים לפי ההוראות הבאות לפי הסדר:

• apigee-influxdb (בצומת מרכזי)
• thought ‫apigee-telegraf (בכל צומת)
• ‫apigee-grafana (בשרת מרכזי)

התקנה של apigee-influxdb בצומת Edge יחיד או בצומת עצמאי

בצומת עצמאי או בצומת Edge שבו פועל שרת הניהול או ממשק המשתמש של Edge:

1. התקנת apigee-influxdb:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb install
2. מגדירים את מסד הנתונים apigee-influxdb:
   > ‎/opt/apigee/apigee-service/bin/apigee-service apigee-influxdb setup
3. מפעילים את apigee-influxdb:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb start

מתקינים את apigee-telegraf בכל צומת של Edge.

בכל צומת של התקנת Edge:

1. בצומת Edge הראשון, מתקינים את apigee-telegraf:
   > ‎/opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
2. יוצרים קובץ תצורה ל-apigee-telegraf בשם sa_telegraf.txt. בדרך כלל, הקובץ הזה מאוחסן בספרייה שנגישה למשתמש apigee, כמו /opt/apigee/customer/application, והוא בבעלות המשתמש apigee.
   
   מגדירים את המאפיין הבא בקובץ כדי לציין את כתובת ה-URL של צומת apigee-influxdb, כולל יציאה 8086:
   INFLUXDB_URL=http://influx_IP:8086
3. משנים את הבעלים ל-"apigee":
   > chown apigee:apigee /opt/apigee/customer/application/sa_telegraf.txt
4. מגדירים את apigee-telegraf:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f /opt/apigee/customer/application/sa_telegraf.txt
5. מפעילים מחדש את apigee-telegraf:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
6. חוזרים על התהליך הזה בכל צומתי Edge.

התקנת apigee-grafana בצומת Edge יחיד

בצומת יחיד של התקנת Edge, כמו צומת ממשק המשתמש של Edge:

1. בצומת Edge הראשון, מתקינים את apigee-grafana:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana install
2. יוצרים קובץ תצורה ל-apigee-grafana בשם sa_grafana.txt. בדרך כלל, הקובץ הזה מאוחסן בספרייה שנגישה למשתמש apigee, כמו /opt/apigee/customer/application, והוא בבעלות המשתמש apigee.
   
   מגדירים את המאפיינים הבאים בקובץ. המאפיינים האלה מתוארים למעלה:
   INFLUXDB_HOST=192.168.56.101
   INFLUXDB_PORT=8086
   GRAFANA_USERNAME=admin
   GRAFANA_PASSWORD=admin
3. משנים את הבעלים ל-"apigee":
   > chown apigee:apigee /opt/apigee/customer/application/sa_grafana.txt
4. מגדירים את apigee-grafana באמצעות קובץ התצורה:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana setup -f /opt/apigee/customer/application/sa_grafana.txt
5. מפעילים מחדש את apigee-grafana:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana restart

כדי לגשת למרכז הבקרה, פותחים את כתובת ה-URL הבאה בדפדפן:

http://grafana_IP_or_DNS:3000

מתחברים באמצעות פרטי הכניסה שציינתם בקובץ התצורה של apigee-grafana. בדוגמה שלמעלה, שם המשתמש והסיסמה הם admin/admin.

פתרון בעיות בהתקנה

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

1. כדי לוודא ש-apigee-telegraf אוסף את הנתונים:
   1. מריצים את apigee-service apigee-telegraf setup, הוא אידמפוטנטי, בודקים אם יש שגיאות, יחסי תלות חסרים ופותרים אותם.
   2. מפעילים מחדש את apigee-telegraf ובודקים אם יש שגיאות ב-/opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log.
2. כדי לוודא ש-apigee-influxdb מקבל נתונים:
   1. מוודאים שיציאות ה-TCP הבאות פתוחות בצומתי הנתונים של apigee-influxdb: ‏ 8086 ו-8183.
   2. כדי לפתוח את ממשק המשתמש של influxdb בדפדפן, משתמשים בכתובת ה-URL הבאה:
      http://influxdb_IP_or_DNS:8183
      1. בשדה Query, מזינים "show databases".
         מוודאים שנוצרו מסדי הנתונים הבאים: system, application, events, _internal.
      2. בשדה Query, מזינים "show servers".
         מוודאים שהצמתים של apigee-influxdb מופיעים ברשימה.
3. בודקים את מקורות הנתונים של מרכז הבקרה:
   1. בתפריט הראשי, לוחצים על מקורות נתונים. אמורים להופיע סמלים של שלושה מקורות נתונים.
   2. לוחצים על הסמל של כל מקור נתונים.
   3. בדף הפרטים של מקור הנתונים, לוחצים על הכפתור שמירה ובדיקה.
   4. אם מקור הנתונים מוגדר בצורה נכונה, תופיע הודעה בפורמט הבא:
      הפעולה בוצעה בהצלחה
      מקור הנתונים פועל

עדכון לוח הבקרה למעקב בגרסת בטא

צריך להשתמש באחד משני התהליכים הבאים, בהתאם לגרסת Edge שמשדרגים ממנה:

• בגרסאות 4.16.09 ו-4.17.01 משתמשים באותו הליך
• בגרסה 4.16.05 צריך להסיר את apigee-collectd כחלק מהעדכון.

עדכון מגרסה 4.16.09 או 4.17.01

אם התקנתם את גרסת הבטא של לוח הבקרה של Apigee Monitoring בגרסה 4.16.09 או 4.17.01, אתם יכולים לעדכן אותה לגרסת הבטא של 4.17.05.

כדי לעדכן את לוח הבקרה של גרסת הבטא:

1. מעדכנים את Edge לגרסה 4.17.05, כמו שמתואר במאמרים עדכון Apigee Edge מגרסה 4.17.01 לגרסה 4.17.05, עדכון Apigee Edge מגרסה 4.16.09 לגרסה 4.17.05 ועדכון Apigee Edge מגרסה 4.16.01 או 4.16.05 לגרסה 4.17.05.
2. מעדכנים את apigee-influxdb בצומת של שרת הניהול:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
   
   כאשר configFile הוא קובץ התצורה שבו השתמשתם כדי להתקין את apigee-influx.
   
   אם התקנתם גם את apigee-grafana בצומת של שרת הניהול, השלב הזה מעדכן גם את apigee-grafana. אחרת, מעדכנים את apigee-granfana כמו שמוסבר בשלב הבא.
3. אם לא התקנתם את apigee-grafana בצומת של שרת הניהול, צריך לעדכן את apigee-grafana בצומת שבו התקנתם אותו:
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
4. מעדכנים את apigee-telegraf בצומת 1:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf update
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f configFile
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
5. חוזרים על שלב 4 לכל צומת.

עדכון מגרסה 4.16.05

בגרסה 4.16.05 של לוח הבקרה נעשה שימוש ב-apigee-collectd במקום ב-apigee-telegraf. כחלק מהעדכון לגרסה 4.17.05, מסירים את apigee-collectd ומתקינים את apigee-telegraf.

כדי לעדכן את לוח הבקרה של גרסת הבטא:

1. מעדכנים את Edge לגרסה 4.17.05, כמו שמתואר במאמרים Update Apigee Edge 4.17.01 to 4.17.05, ‏ Update Apigee Edge 4.16.09 to 4.17.05 ו-Update Apigee Edge 4.16.01/4.16.05 to 4.17.05.
2. מעדכנים את apigee-influxdb בצומת של שרת הניהול:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
   
   כאשר configFile הוא קובץ התצורה שבו השתמשתם כדי להתקין את apigee-influx.
   
   אם התקנתם גם את apigee-grafana בצומת של שרת הניהול, השלב הזה מעדכן גם את apigee-grafana. אחרת, מעדכנים את apigee-granfana כמו שמוסבר בשלב הבא.
3. אם לא התקנתם את apigee-grafana בצומת של שרת הניהול, צריך לעדכן את apigee-grafana בצומת שבו התקנתם אותו:
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
4. מתקינים את apigee-telegraf בצומת 1:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-collectd stop
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f configFile
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
   > /opt/apigee/apigee-service/bin/apigee-service apigee-collectd uninstall
5. חוזרים על שלב 4 לכל צומת.