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

Edge for Private Cloud גרסה 4.17.09

דרישות מערכת

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

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

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

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

• מעבד (CPU) עם 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 העובדים
2. יוצרים קובץ תצורה עבור apigee-telegraf בשם sa_telegraf.txt. בדרך כלל, מאחסנים את הקובץ הזה בספרייה שאליה יכול לגשת המשתמש API, כמו /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 הפעלה מחדש
6. חוזרים על התהליך הזה בכל צומתי Edge.

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

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

1. בצומת Edge הראשון, מתקינים את apigee-grafana:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana התקנה
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 מחדש

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

http://grafana_IP_or_DNS:3000

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

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

אם לא מופיעים נתונים במרכז השליטה, בצעו את התהליך הבא כדי לפתור את הבעיות בהתקנה:

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

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

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

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

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

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

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

1. עדכון Edge לגרסה 4.17.09 כמתואר בעדכון Apigee Edge 4.17.01/4.17.05 ל-4.17.09, בעדכון Apigee Edge 4.16.09 ל-4.17.09 וב-עדכון Apigee Edge 4.16.00.15.14.16.
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
   
5. חוזרים על שלב 4 לכל צומת.

עדכון מגרסה 4.16.05

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

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

1. עדכון Edge לגרסה 4.17.09 כמתואר בעדכון Apigee Edge 4.17.01/4.17.05 ל-4.17.09, בעדכון Apigee Edge 4.16.09 ל-4.17.09 וב-עדכון Apigee Edge 4.16.00.15.14.16.
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/apigeapigeapigeapigeapigeapigeapigeapige
   
   configFile
5. חוזרים על שלב 4 לכל צומת.