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

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 חייבות להיות פתוחות בצומתי הנתונים igee-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 (ב- צומת מרכזי)
• apigee-telegraf (בכל אחד צומת)
• apigee-grafana (ב שרת מרכזי)

התקנה apigee-influxdb בצומת Edge יחיד או בצומת נפרד

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

1. התקנה של apigee-influxdb:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb רגיל
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

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

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

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

1. כדי לוודא ש-apigee-telegraf אוסף את הנתונים
   1. הפעלת שירות APIgee הגדרה של apigee-telegraf, אידמפוטנטית, בדיקת שגיאות, יחסי תלות חסרים ולפתור אותן.
   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. בשדה 'שאילתה', מזינים "הצגת מסדי נתונים".
         ודא שמסדי הנתונים הבאים נוצרו: מערכת, אפליקציה, אירועים, _internal.
      2. בשדה השאילתה, מזינים "show server" (הצגת שרתים).
         מוודאים שהצמתים apigee-influxdb רשום.
3. בודקים את מקורות הנתונים במרכז הבקרה:
   1. בוחרים מקורות נתונים בתפריט הראשי. אמורים לראות סמלים עבור 3 מקורות נתונים מוצגים.
   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 בגרסאות 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 ו-Update 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 מחדש
5. חוזרים על שלב 4 לכל צומת.

עדכון מגרסה 4.16.05

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

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

1. מעדכנים את Edge לגרסה 4.17.09 כפי שמתואר במאמר עדכון Apigee Edge 4.17.01/4.17.05 עד 4.17.09, מעדכנים את Apigee Edge 4.16.09 ל- 4.17.09 ו-Update 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-collectd stop
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf התקנה
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f configFile
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf מחדש
   > /opt/apigee/apigee-service/bin/apigee-service apigee-collectdתודה
5. חוזרים על שלב 4 לכל צומת.