התקנת לוח בקרה של 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:

נכס

תיאור

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

יציאת InfluxDB API שמשמשת את מקור הנתונים של 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 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. בדרך כלל, מאחסנים את הקובץ הזה בספרייה שאליה יכול לגשת המשתמש API, כמו /opt/apigee/customer/application, והופכים אותו לבעלים של המשתמש API.

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

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

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

  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. יש להשתמש בכתובת ה-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.0x משתמשים באותו תהליך
  • בגרסה 4.16.05 נדרשת הסרה של apigee-collectd כחלק מהעדכון.

עדכון מגרסה 4.16.09 או 4.17.0x

אם התקנת את גרסת הבטא של Apigee Monitoring Dashboard בגרסה 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.00.17.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
    > /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 לכל צומת.