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

Edge for Private Cloud גרסה 4.18.01

דרישות מערכת

צריך להתקין את 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 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 בדוגמה שמוצגת למעלה שם המשתמש/הסיסמה הם אדמין/אדמין.

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

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

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. כדי לפתוח את ממשק המשתמש של Inuxdb בדפדפן, משתמשים בכתובת ה-URL הבאה:

      http://influxdb_IP_or_DNS:8183

      1. בשדה 'שאילתה', מזינים "הצגת מסדי נתונים". צריך לוודא שמסדי הנתונים הבאים נוצרו: system, application, events, _internal.
      2. בשדה 'שאילתה', מזינים "הצגת השרתים". חשוב לוודא שאתם רואים ברשימה apigee-influxdb צמתים מפורטים.
3. בודקים את מקורות הנתונים במרכז הבקרה:
   1. בוחרים מקורות נתונים בתפריט הראשי. אמורים לראות סמלים עבור 3 מקורות נתונים מוצגים.
   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 לכל צומת.