การติดตั้งแดชบอร์ดการตรวจสอบรุ่นเบต้า

Edge for Private Cloud เวอร์ชัน 4.17.01

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

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

คุณสามารถติดตั้ง apigee-grafana ในโหนดแยกต่างหาก หรือใช้โหนด Edge ที่มีอยู่ซ้ำ เช่น โหนด Management Server หรือ Edge UI

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

หากคุณตัดสินใจติดตั้ง apigee-influxdb ในโหนดของตัวเองเพื่อเหตุผลด้านประสิทธิภาพ โหนดควรมีข้อกำหนดต่อไปนี้

• CPU 2 Core
• 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

ตั้งค่าพร็อพเพอร์ตี้เหล่านี้ในไฟล์ข้อความที่คุณส่งไปยังคำสั่ง 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 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 โดยปกติแล้ว คุณจะจัดเก็บไฟล์นี้ไว้ในไดเรกทอรีที่ผู้ใช้ "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 โดยปกติแล้ว คุณจะจัดเก็บไฟล์นี้ไว้ในไดเรกทอรีที่ผู้ใช้ "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 ซึ่งเป็น Idempotent ตรวจสอบข้อผิดพลาด ทรัพยากร 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. ในช่อง Query ให้ป้อน "show databases"
         ตรวจสอบว่าได้สร้างฐานข้อมูลต่อไปนี้แล้ว: system, application, events, _internal
      2. ในช่องการค้นหา ให้ป้อน "show servers"
         ตรวจสอบว่าคุณเห็นโหนด 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 restart
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 restart
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 restart