התקנת לוח בקרה של Monitoring (בטא)

Edge for Private Cloud v4.18.01

דרישות מערכת

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

אפשר להתקין את apigee-grafana בצומת נפרד, או להשתמש מחדש באחד מהצמתים הקיימים של Edge, כמו שרת הניהול או צומת ממשק המשתמש של 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

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

http://192.168.0.1:8086

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

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

192.168.0.1

הוראות התקנה

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

• apigee-influxdb (בצומת מרכזי)
• ‫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.0x
• כדי לעדכן לגרסה 4.16.05, צריך להסיר את apigee-collectd.

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

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

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

1. מעדכנים את Edge לגרסה 4.18.01, כמו שמתואר במאמרים עדכון Apigee Edge מגרסה 4.17.01 או 4.17.05 לגרסה 4.17.09, עדכון Apigee Edge מגרסה 4.16.09 לגרסה 4.17.09 ועדכון Apigee Edge מגרסה 4.16.01 או 4.16.05 לגרסה 4.17.09.
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.18.01, מסירים את apigee-collectd ומתקינים את apigee-telegraf.

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

1. מעדכנים את Edge לגרסה 4.18.01, כמו שמתואר במאמרים עדכון Apigee Edge מגרסה 4.16.01/4.16.05 לגרסה 4.17.01 ועדכון Apigee Edge מגרסה 4.16.09 לגרסה 4.17.01.
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 לכל צומת.