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

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

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

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

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

สำหรับ 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 ดังนี้

พร็อพเพอร์ตี้

คำอธิบาย

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 ที่เรียกใช้ 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 settings
  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เกี่ยวกับการรีสตาร์ท
  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ของหน้ารีสตาร์ท

หากต้องการเข้าถึงหน้าแดชบอร์ด ให้เปิด URL ต่อไปนี้ในเบราว์เซอร์

http://grafana_IP_or_DNS:3000

ลงชื่อเข้าสู่ระบบโดยใช้ข้อมูลเข้าสู่ระบบที่คุณระบุในไฟล์การกำหนดค่าสำหรับ apigee-grafana ในตัวอย่างที่แสดงด้านบน ชื่อผู้ใช้/รหัสผ่านคือ admin/admin

การแก้ปัญหาการติดตั้ง

หากคุณไม่เห็นข้อมูลปรากฏในหน้าแดชบอร์ด ให้ใช้ขั้นตอนต่อไปนี้เพื่อแก้ปัญหาการติดตั้ง

  1. วิธีตรวจสอบว่า apigee-telegraf รวบรวมข้อมูล
    1. เรียกใช้การตั้งค่า apigee-service apigee-telegraf ซึ่งเป็นแอตทริบิวต์แบบ IDempot ตรวจสอบข้อผิดพลาด การขาดทรัพยากร 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. ในช่อง "การค้นหา" ให้ป้อน "show pages"
        ตรวจสอบว่าคุณเห็นโหนด apigee-influxdb ในรายการ
  3. ตรวจสอบแหล่งข้อมูลในหน้าแดชบอร์ด ดังนี้
    1. เลือกแหล่งข้อมูลในเมนูหลัก คุณจะเห็นไอคอนของแหล่งข้อมูล 3 แหล่งปรากฏอยู่
    2. เลือกไอคอนสำหรับแหล่งข้อมูลแต่ละแหล่ง
    3. ในหน้ารายละเอียดของแหล่งข้อมูล ให้เลือกปุ่มบันทึกและทดสอบ
    4. หากแหล่งข้อมูลได้รับการกำหนดค่าอย่างถูกต้อง คุณจะเห็นข้อความในรูปแบบ
      สำเร็จ
      แหล่งข้อมูลใช้งานได้

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

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

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

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

หากติดตั้งแดชบอร์ด Apigee Monitoring เวอร์ชันเบต้าไว้ในเวอร์ชัน 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.
  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-telegrafupdate
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegrafตั้งชื่อ -f configserviceelegee-api/api/optFile/apigee-f configFile
    /api/opt/apigee-apigee/apigee-service
  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.
  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/apigee/apigee-serviceผู้ใช้บางคน


    configFile
  5. ทำขั้นตอนที่ 4 ซ้ำสำหรับทุกโหนด