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

Edge for Private Cloud גרסה 4.17.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 חייבות להיות פתוחות בצומתי הנתונים 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:

נכס

תיאור

INFLUXDB_URL

יש לציין את כתובת ה-URL של צומת apigee-influxdb, כולל יציאה 8086.

לדוגמה:

http://192.168.0.1:8086

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

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

נכס

תיאור

INFLUXDB_HOST

מציינים את כתובת ה-IP או את שם ה-DNS של צומת InfluxDB.

לדוגמה: 

192.168.0.1

INFLUXDB_PORT

יציאת ממשק ה-API של InfluxDB, שמשמשת את מקור הנתונים של Grafana. מציינים 8086.

GRAFANA_USERNAME

שם המשתמש של Grafana להתחברות לממשק המשתמש של מרכז הבקרה.

GRAFANA_PASSWORD

סיסמת Grafana להתחברות לממשק המשתמש של מרכז השליטה.

הוראות התקנה

כדי להתקין את רכיבי מרכז הבקרה ברצף הזה, צריך לבצע את ההוראות הבאות:

  • 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 start

התקנה של apigee-telegraf ב- כל צומת Edge

בכל צומת בהתקנת Edge:

  1. בצומת Edge הראשון, מתקינים את apigee-telegraf:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
  2. יוצרים קובץ תצורה עבור apigee-telegraf. בדרך כלל אתם מאחסנים את להגיש ספרייה שניתן לגשת אליה דרך '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. בדרך כלל אתם מאחסנים את את הקובץ בספרייה שאליה אפשר לגשת באמצעות '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. כדי לפתוח את ממשק המשתמש של Inuxdb בדפדפן, משתמשים בכתובת ה-URL הבאה:
      http://influxdb_IP_or_DNS:8183
      1. בשדה 'שאילתה', מזינים "הצגת מסדי נתונים".
        ודא שמסדי הנתונים הבאים נוצרו: מערכת, אפליקציה, אירועים, _internal.
      2. בשדה 'שאילתה', מזינים "show server" (הצגת שרתים).
        מוודאים שהצמתים apigee-influxdb רשום.
  3. בודקים את מקורות הנתונים במרכז הבקרה:
    1. בוחרים מקורות נתונים בתפריט הראשי. אמורים לראות סמלים עבור 3 מקורות נתונים מוצגים.
    2. בוחרים בסמל של כל מקור נתונים.
    3. בדף הפרטים של מקור הנתונים, לוחצים על הלחצן שמירה ו- בדיקה לחצן.
    4. אם מקור הנתונים מוגדר כראוי, אמורה להופיע הודעה בפורמט:
      הצלחה
      מקור הנתונים פועל

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

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

צריך לעדכן את רכיבי מרכז הבקרה לפי הסדר הבא:

  • apigee-influxdb
  • apigee-telegraf בכל אחד צומת
  • apigee-grafana

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

  1. מעדכנים את Edge ל-4.17.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-service/bin/apigee-service apigee-influxdb update
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb setup
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb הפעלה מחדש
  3. מעדכנים את apigee-telegraf ב- צומת 1:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf update
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f /opt/apigee/customer/application/sa_telegraf.txt
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf מחדש
  4. חוזרים על שלב 3 לכל צומת.
  5. עדכון apigee-grafana:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana update
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana setup -f /opt/apigee/customer/application/sa_grafana.txt
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana מחדש