การติดตั้งแดชบอร์ดการตรวจสอบ (เบต้า)

Edge for Private Cloud v4.18.01

ข้อกำหนดของระบบ

คุณต้องติดตั้ง apigee-telegraf บนโหนด Edge ทั้งหมดเพื่อ รวบรวมข้อมูลแดชบอร์ด ดังนั้น ข้อกำหนดของระบบสำหรับ apigee-telegraf คือ เช่นเดียวกับสำหรับ Edge โหนดที่คุณกำลังติดตั้ง

คุณติดตั้ง apigee-grafana ได้ ในโหนดแยกต่างหาก หรือนำโหนด Edge ใดโหนดหนึ่งมาใช้ซ้ำ เช่น เซิร์ฟเวอร์การจัดการหรือ Edge โหนด UI

สำหรับ apigee-influxdb คุณสามารถ ติดตั้งบนโหนด Edge ที่มีอยู่ เช่น โหนดเซิร์ฟเวอร์การจัดการหรือโหนด Edge UI โดย ไม่มีการเปลี่ยนแปลงข้อกำหนดของระบบ

หากคุณตัดสินใจติดตั้ง apigee-influxdb บนโหนดของตนเองสำหรับ โหนดควรมีข้อกำหนดต่อไปนี้

  • CPU 2 แกน
  • RAM 4 GB
  • พื้นที่ในดิสก์ 250 GB (ตรวจสอบข้อมูลที่ถูกลบถาวรหลังจากผ่านไป 1 เดือน)
  • IOPS 1,000 หรือมากกว่า

โปรดดู เอกสาร 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 สำหรับเข้าสู่ระบบ UI ของแดชบอร์ด

GRAFANA_PASSWORD

รหัสผ่าน Grafana สำหรับการเข้าสู่ระบบ UI ของแดชบอร์ด

วิธีการติดตั้ง

ทำตามวิธีการด้านล่างเพื่อติดตั้งคอมโพเนนต์ของหน้าแดชบอร์ดตามลำดับนี้

  • apigee-influxdb (บนโหนดกลาง)
  • apigee-telegraf (ในแต่ละโหนด)
  • apigee-grafana (บนเซิร์ฟเวอร์กลาง)

ติดตั้ง apigee-influxdb ในโหนด Edge เดียวหรือโหนดเดี่ยว

ในโหนดแบบสแตนด์อโลน หรือโหนด Edge ที่ใช้เซิร์ฟเวอร์การจัดการหรือ Edge UI:

  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 UI ดังนี้

  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 รหัสเดิม ตรวจหา ทรัพยากร Dependency ที่ขาดหายไป แล้วแก้ปัญหาเหล่านั้น
    2. รีสตาร์ท apigee-telegraf และตรวจสอบ /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.logสำหรับข้อผิดพลาดใดๆ
  2. วิธีตรวจสอบว่า apigee-influxdb กำลังรับข้อมูลอยู่
    1. ตรวจสอบว่าพอร์ต TCP ต่อไปนี้เปิดอยู่บนโหนดข้อมูล apigee-influxdb 8086 และ 8183
    2. ใช้ URL ต่อไปนี้เพื่อเปิด UI ของ influxdb ในเบราว์เซอร์
      http://influxdb_IP_or_DNS:8183
      1. ในฟิลด์การค้นหา ให้ป้อน "แสดงฐานข้อมูล" ตรวจสอบว่าฐานข้อมูลต่อไปนี้ สร้างเมื่อ: system, application, events, _internal
      2. ในฟิลด์การค้นหา ให้ป้อน "แสดงเซิร์ฟเวอร์" ตรวจสอบว่าคุณเห็น apigee-influxdb โหนดอยู่ในรายการ
  3. ตรวจสอบแหล่งข้อมูลในแดชบอร์ด ดังนี้
    1. เลือกแหล่งข้อมูลในเมนูหลัก คุณควรเห็นไอคอนสำหรับ ที่แสดงแหล่งข้อมูลอยู่
    2. เลือกไอคอนสําหรับแหล่งข้อมูลแต่ละรายการ
    3. ในหน้ารายละเอียดของแหล่งข้อมูล ให้เลือกบันทึกและ ทดสอบ
    4. หากแหล่งข้อมูลได้รับการกําหนดค่าอย่างถูกต้อง คุณควรเห็นข้อความในรูปแบบ
      สำเร็จ
      แหล่งข้อมูลใช้งานได้

การอัปเดตแดชบอร์ดการตรวจสอบเวอร์ชันเบต้า

ใช้ขั้นตอนใดขั้นตอนหนึ่งใน 2 ข้อด้านล่างนี้โดยยึดตามเวอร์ชันของ Edge ที่คุณต้องการอัปเกรด

  • 4.16.09 และ 4.17.0x ใช้ขั้นตอนเดียวกัน
  • 4.16.05 กำหนดให้คุณต้องถอนการติดตั้ง apigee-collectd เป็นส่วนหนึ่งของการอัปเดต

อัปเดตจากเวอร์ชัน 4.16.09 หรือ 4.17.0x

หากคุณติดตั้งแดชบอร์ดการตรวจสอบ Apigee เวอร์ชันเบต้าในเวอร์ชัน 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 ซ้ำสำหรับทุกโหนด