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

Edge for Private Cloud v4.18.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

ตั้งค่าพร็อพเพอร์ตี้เหล่านี้ในไฟล์ข้อความที่คุณส่งไปยังคำสั่ง apigee-telegraf setup เช่น ตั้งค่าในไฟล์ข้อความชื่อ 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. ติดตั้ง apigee-telegraf ในโหนด Edge แรก โดยทำดังนี้

   > /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. ติดตั้ง apigee-grafana ในโหนด Edge แรก โดยทำดังนี้

   > /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.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 ซ้ำสำหรับทุกโหนด