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
:
נכס |
תיאור |
---|---|
|
צריך לציין את כתובת ה-URL של הצומת apigee-influxdb, כולל יציאה 8086. לדוגמה: http://192.168.0.1:8086 |
פרמטרים של הגדרה ל-apigee-grafana
צריך להגדיר את המאפיינים האלה בקובץ טקסט שמעבירים לפקודה apigee-grafana setup
. לדוגמה, אפשר להגדיר אותן בקובץ טקסט בשם sa_grafana.txt
:
נכס |
תיאור |
---|---|
|
יש לציין את כתובת ה-IP או את שם ה-DNS של צומת InfluxDB. לדוגמה: 192.168.0.1 |
|
יציאת InfluxDB API שמשמשת את מקור הנתונים של Grafana. מציינים 8086. |
|
שם המשתמש ב-Grafana לצורך התחברות לממשק המשתמש של מרכז השליטה. |
|
סיסמת Grafana להתחברות לממשק המשתמש של מרכז השליטה. |
הוראות התקנה
כדי להתקין את רכיבי מרכז השליטה ברצף הבא:
apigee-influxdb
(בצומת מרכזי)apigee-telegraf
(בכל צומת)apigee-grafana
(בשרת מרכזי)
התקנה של apigee-influxdb בצומת Edge יחיד או צומת עצמאי
בצומת עצמאי או בצומת Edge שמריצים את שרת הניהול או את ממשק המשתמש של Edge:
- מתקינים את
apigee-influxdb
:> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb install
- מגדירים את מסד הנתונים
apigee-influxdb
:> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb setup
- התחלה של
apigee-influxdb
:> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb start
התקנה של apigee-telegraf בכל צומת Edge
בכל צומת של התקנת Edge:
- בצומת Edge הראשון, מתקינים את
apigee-telegraf
:> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
- יצירת קובץ תצורה בשביל
apigee-telegraf
בשםsa_telegraf.txt
. בדרך כלל, מאחסנים את הקובץ הזה בספרייה שאליה יכול לגשת המשתמש API, כמו/opt/apigee/customer/application
, והופכים אותו לבעלים של המשתמש API.מגדירים את המאפיין הבא בקובץ כדי לציין את כתובת ה-URL של צומת apigee-influxdb, כולל יציאה 8086:
INFLUXDB_URL=http://influx_IP:8086
- משנים את הבעלים ל 'apigee':
> chown apigee:apigee /opt/apigee/customer/application/sa_telegraf.txt
- הגדרה של
apigee-telegraf
:> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f /opt/apigee/customer/application/sa_telegraf.txt
- מפעילים מחדש את
apigee-telegraf
:> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
- חוזרים על התהליך הזה בכל צומתי Edge.
התקנה של apigee-grafana בצומת Edge יחיד
בצומת יחיד של התקנת Edge, למשל הצומת של ממשק המשתמש של Edge:
- בצומת Edge הראשון, מתקינים את
apigee-grafana
:> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana install
- יצירת קובץ תצורה עבור
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
- משנים את הבעלים ל 'apigee':
> chown apigee:apigee /opt/apigee/customer/application/sa_grafana.txt
- מגדירים את
apigee-grafana
באמצעות קובץ התצורה:> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana setup -f /opt/apigee/customer/application/sa_grafana.txt
- מפעילים מחדש את
apigee-grafana
:> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana restart
כדי לגשת למרכז הבקרה, פותחים את כתובת ה-URL הבאה בדפדפן:
http://grafana_IP_or_DNS:3000
מתחברים באמצעות פרטי הכניסה שציינתם בקובץ התצורה של apigee-grafana
. בדוגמה שלמעלה, שם המשתמש/הסיסמה הם admin/admin.
פתרון בעיות בהתקנה
אם לא מופיעים נתונים במרכז השליטה, בצעו את התהליך הבא כדי לפתור את הבעיות בהתקנה:
- כדי לוודא שהנתונים נאספים על ידי
apigee-telegraf
- מריצים את
apigee-service apigee-telegraf setup
, הוא אידמפונטי, בודקים אם יש שגיאות, אם יש יחסי תלות חסרים ופותרים אותם. - צריך להפעיל מחדש את
apigee-telegraf
ולבדוק אם יש שגיאות ב-/opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log
- מריצים את
- כדי לוודא ש-
apigee-influxdb
מקבל נתונים:- יש לוודא שיציאות ה-TCP הבאות פתוחות בצמתי נתונים של
apigee-influxdb
: 8086 ו-8183. - יש להשתמש בכתובת ה-URL הבאה כדי לפתוח את ממשק המשתמש של influxdb בדפדפן:
http://influxdb_IP_or_DNS:8183
- בשדה 'שאילתה', מזינים 'הצגת מסדי נתונים'. יש לוודא שמסדי הנתונים הבאים נוצרו:
system, application, events, _internal
. - בשדה 'שאילתה', מזינים 'הצגת שרתים'. חשוב לוודא שהצמתים של
apigee-influxdb
מוצגים ברשימה.
- בשדה 'שאילתה', מזינים 'הצגת מסדי נתונים'. יש לוודא שמסדי הנתונים הבאים נוצרו:
- יש לוודא שיציאות ה-TCP הבאות פתוחות בצמתי נתונים של
- בודקים את מקורות הנתונים במרכז הבקרה:
- בוחרים באפשרות מקורות נתונים בתפריט הראשי. אמורים להופיע סמלים של שלושה מקורות נתונים.
- לוחצים על הסמל של כל מקור נתונים.
- בדף הפרטים של מקור הנתונים, לוחצים על הלחצן שמירה ובדיקה.
- אם מקור הנתונים מוגדר בצורה תקינה, אמורה להופיע הודעה בטופס:
הצלחה
מקור הנתונים פועל
עדכון מרכז הבקרה למעקב אחר גרסאות בטא
יש להשתמש באחד משני התהליכים הבאים, בהתאם לגרסת Edge שממנה משדרגים:
- 4.16.09 ו-4.17.0x משתמשים באותו תהליך
- בגרסה 4.16.05 נדרשת הסרה של
apigee-collectd
כחלק מהעדכון.
עדכון מגרסה 4.16.09 או 4.17.0x
אם התקנת את גרסת הבטא של Apigee Monitoring Dashboard בגרסה 4.16.09 או בגרסה 4.17.0x, אפשר לעדכן אותה לגרסת הבטא עבור 4.18.01.
כדי לעדכן את מרכז הבקרה למעקב אחר גרסאות בטא:
- עדכון 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.00.17.14.16.
- עדכון
apigee-influxdb
בצומת שרת הניהול:> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
configFile הוא קובץ התצורה שהשתמשתם בו כדי להתקין את
apigee-influx
.אם התקנת גם את
apigee-grafana
בצומת של שרת הניהול, השלב הזה יעדכן גם אתapigee-grafana
. אחרת, צריך לעדכן אתapigee-granfana
כפי שמוצג בשלב הבא. - אם לא התקנתם את
apigee-grafana
בצומת של שרת הניהול, עדכנו אתapigee-grafana
בצומת שבו התקנתם אותה:> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
- עדכון של
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
- חוזרים על שלב 4 לכל צומת.
עדכון מגרסה 4.16.05
בגרסה 4.16.05 של מרכז הבקרה נעשה שימוש ב-apigee-collectd
במקום
ב-apigee-telegraf
. כחלק מהעדכון לגרסה 4.18.01, צריך להסיר את apigee-collectd
ולהתקין את apigee-telegraf
.
כדי לעדכן את מרכז הבקרה למעקב אחר גרסאות בטא:
- מעדכנים את Edge לגרסה 4.18.01 כמו שמתואר בעדכון Apigee Edge מ-4.16.01/4.16.05 ל-4.17.01 ובעדכון Apigee Edge 4.16.09 ל-4.17.01.
- עדכון של
apigee-influxdb
בצומת שרת הניהול:> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
configFile הוא קובץ התצורה שהשתמשתם בו כדי להתקין את
apigee-influx
.אם התקנת גם את
apigee-grafana
בצומת של שרת הניהול, השלב הזה יעדכן גם אתapigee-grafana
. אחרת, צריך לעדכן אתapigee-granfana
כפי שמוצג בשלב הבא. - אם לא התקנתם את
apigee-grafana
בצומת של שרת הניהול, עדכנו אתapigee-grafana
בצומת שבו התקנתם אותה:> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
- התקנת
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
- חוזרים על שלב 4 לכל צומת.