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

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

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

คุณต้องติดตั้ง 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 ชื่อ 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 ในตัวอย่างที่แสดงด้านบน ชื่อผู้ใช้/รหัสผ่านคือ 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. หากกำหนดค่าแหล่งข้อมูลอย่างถูกต้อง คุณจะเห็นข้อความในรูปแบบต่อไปนี้
      สำเร็จ
      แหล่งข้อมูลทำงานอยู่

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

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

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

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

หากคุณติดตั้งแดชบอร์ดการตรวจสอบ Apigee เวอร์ชันเบต้าใน 4.16.09 หรือ 4.17.01 คุณสามารถอัปเดตเป็นเวอร์ชันเบต้าสำหรับ 4.17.05 ได้

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

1. อัปเดต Edge เป็น 4.17.05 ตามที่อธิบายไว้ในอัปเดต Apigee Edge 4.17.01 เป็น 4.17.05, อัปเดต Apigee Edge 4.16.09 เป็น 4.17.05 และอัปเดต Apigee Edge 4.16.01/4.16.05 เป็น 4.17.05
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.17.05 คุณจะต้องถอนการติดตั้ง apigee-collectd และติดตั้ง apigee-telegraf

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

1. อัปเดต Edge เป็น 4.17.05 ตามที่อธิบายไว้ในอัปเดต Apigee Edge 4.17.01 เป็น 4.17.05, อัปเดต Apigee Edge 4.16.09 เป็น 4.17.05 และอัปเดต Apigee Edge 4.16.01/4.16.05 เป็น 4.17.05
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 ซ้ำสำหรับทุกโหนด