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

Edge สำหรับ Private Cloud เวอร์ชัน 4.18.01

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

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

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

สำหรับ apigee-influxdb คุณจะติดตั้งได้ในโหนด Edge ที่มีอยู่ เช่น โหนด Management Server หรือโหนด 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 ดังนี้

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

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

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

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

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

หากติดตั้งแดชบอร์ด Apigee Monitoring เวอร์ชันเบต้าไว้ในเวอร์ชัน 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.94.07. เป็น
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 ในโหนด Management Server ให้อัปเดต 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 ในโหนด Management Server ให้อัปเดต 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 ซ้ำสำหรับทุกโหนด