Cài đặt trang tổng quan giám sát beta

Edge for Private Cloud phiên bản 4.17.01

Yêu cầu hệ thống

Bạn phải cài đặt apigee-telegraf trên tất cả các nút Edge để thu thập dữ liệu trên trang tổng quan. Do đó, các yêu cầu về hệ thống đối với apigee-telegraf cũng giống như yêu cầu đối với nút Edge mà bạn đang cài đặt.

Bạn có thể cài đặt apigee-grafana trên một nút riêng hoặc sử dụng lại một trong các nút Edge hiện có, chẳng hạn như nút Máy chủ quản lý hoặc nút Giao diện người dùng Edge.

Đối với apigee-influxdb, bạn có thể cài đặt API này trên một nút Edge hiện có, chẳng hạn như nút Máy chủ quản lý hoặc nút Giao diện người dùng Edge, mà không thay đổi các yêu cầu về hệ thống.

Nếu bạn quyết định cài đặt apigee-influxdb trên nút riêng vì lý do hiệu suất, thì nút đó phải có các yêu cầu sau:

• CPU 2 nhân
• RAM 4 GB
• Dung lượng ổ đĩa 250 GB (giá trị theo dõi dữ liệu sẽ bị xoá hoàn toàn sau 1 tháng)
• 1000 IOPS trở lên

Hãy xem tài liệu về InfluxData để biết thêm thông tin.

Yêu cầu về cổng cho apigee-influxdb

Các cổng 8086 và 8183 phải được mở trên các nút dữ liệu apigee-influxdb để truy cập bằng nút chạy apigee-grafana và apigee-telegraf.

Tệp cấu hình để cài đặt các thành phần của trang tổng quan

Để cài đặt các thành phần apigee-telegraf và apigee-grafana, bạn hãy chuyển tệp cấu hình đến tiện ích apigee-service. Lưu trữ các tệp này trong một thư mục mà người dùng "apigee" có thể truy cập, chẳng hạn như /opt/apigee/customer/application và làm cho các tệp đó thuộc quyền sở hữu của người dùng "apigee".

Thông số cấu hình cho apigee-telegraf

Đặt các thuộc tính này trong một tệp văn bản mà bạn truyền đến lệnh setup apigee-telegraf. Ví dụ: đặt các kết quả đó trong một tệp văn bản có tên sa_telegraf.txt:

http://192.168.0.1:8086

Thông số cấu hình cho apigee-grafana

Đặt các thuộc tính này trong một tệp văn bản mà bạn truyền đến lệnh apigee-grafana setup (thiết lập apigee-grafana). Ví dụ: đặt các URL đó trong một tệp văn bản có tên sa_grafana.txt:

192.168.0.1

Hướng dẫn cài đặt

Làm theo hướng dẫn bên dưới để cài đặt các thành phần của trang tổng quan theo trình tự sau:

• apigee-influxdb (trên nút trung tâm)
• apigee-telegraf (trên mỗi nút)
• apigee-grafana (trên máy chủ trung tâm)

Cài đặt apigee-influxdb trên một nút Edge hoặc nút độc lập

Trên một nút độc lập hoặc nút Edge chạy Máy chủ quản lý hoặc Giao diện người dùng Edge:

1. Cài đặt apigee-influxdb:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb cài đặt
2. Định cấu hình cơ sở dữ liệu apigee-influxdb:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb thiết lập
3. Bắt đầu apigee-influxdb:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb bắt đầu

Cài đặt apigee-telegraf trên mọi nút Edge

Trên mọi nút khi cài đặt Edge:

1. Trên nút Edge đầu tiên của bạn, hãy cài đặt apigee-telegraf:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf cài đặt
2. Tạo tệp cấu hình cho apigee-telegraf. Thông thường, bạn lưu trữ tệp này một thư mục mà người dùng "apigee" có thể truy cập (chẳng hạn như /opt/apigee/customer/application) và đặt thư mục này thuộc quyền sở hữu của người dùng "apigee".
   
   Đặt thuộc tính sau trong tệp để chỉ định URL của nút apigee-influxdb, bao gồm cả cổng 8086:
   INFLUXDB_URL=http://influx_IP:8086
3. Thay đổi chủ sở hữu thành "apigee":
   > chown apigee:apigee /opt/apigee/customer/application/sa_telegraf.txt
4. Định cấu hình apigee-telegraf:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf thiết lập -f /opt/apigee/customer/application/sa_telegraf.txt
5. Khởi động lại apigee-telegraf:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf khởi động lại
6. Lặp lại quá trình này trên tất cả các nút Edge.

Cài đặt apigee-grafana trên một nút Edge

Trên một nút duy nhất trong quá trình cài đặt Edge, chẳng hạn như nút Giao diện người dùng Edge:

1. Trên nút Edge đầu tiên của bạn, hãy cài đặt apigee-grafana:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana cài đặt
2. Tạo tệp cấu hình cho apigee-grafana. Thông thường, bạn lưu trữ tệp này trong một thư mục mà người dùng "apigee" có thể truy cập (chẳng hạn như /opt/apigee/customer/application) và đặt tệp này thuộc quyền sở hữu của người dùng "apigee".
   
   Thiết lập các thuộc tính sau trong tệp. Những thuộc tính sau được mô tả ở trên:
   INFLUXDB_HOST=192.168.56.101
   INFLUXDB_Port=8086
   GRAfanA_USERNAME=admin
   GRAfanA_Password=admin
3. Thay đổi chủ sở hữu thành "apigee":
   > chown apigee:apigee /opt/apigee/customer/application/sa_grafana.txt
4. Định cấu hình apigee-grafana bằng tệp cấu hình:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana setup -f /opt/apigee/customer/application/sa_grafana.txt
5. Khởi động lại apigee-grafana:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana khởi động lại

Để truy cập vào trang tổng quan, hãy mở URL sau trong trình duyệt:

http://grafana_IP_or_DNS:3000

Đăng nhập bằng thông tin xác thực bạn đã chỉ định trong tệp cấu hình cho apigee-grafana. Trong ví dụ ở phía trên, tên người dùng/mật khẩu là quản trị viên/quản trị viên.

Khắc phục sự cố cài đặt

Nếu bạn không thấy dữ liệu xuất hiện trong trang tổng quan, hãy làm theo quy trình sau để khắc phục sự cố về việc cài đặt:

1. Để đảm bảo apigee-telegraf đang thu thập dữ liệu
   1. Hãy chạy quy trình thiết lập apigee-service apigee-telegraf. Thao tác này không thay đổi giá trị, kiểm tra lỗi, các phần phụ thuộc còn thiếu và giải quyết chúng.
   2. Khởi động lại apigee-telegraf và kiểm tra /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log để xem mọi lỗi
2. Để đảm bảo apigee-influxdb nhận được dữ liệu, hãy làm như sau:
   1. Đảm bảo các cổng TCP sau đây đang mở trên các nút dữ liệu apigee-influxdb: 8086 và 8183.
   2. Dùng URL sau để mở giao diện người dùng influxdb trong trình duyệt:
      http://influxdb_IP_or_DNS:8183
      1. Trong trường Truy vấn, hãy nhập "hiển thị cơ sở dữ liệu".
         Đảm bảo bạn đã tạo các cơ sở dữ liệu sau: system, application, event, _internal.
      2. Trong trường Truy vấn, hãy nhập "hiển thị máy chủ".
         Hãy đảm bảo rằng bạn thấy các nút apigee-influxdb được liệt kê.
3. Kiểm tra nguồn dữ liệu vào trang tổng quan:
   1. Chọn Nguồn dữ liệu trong trình đơn chính. Bạn sẽ thấy các biểu tượng cho 3 nguồn dữ liệu xuất hiện.
   2. Đối với mỗi nguồn dữ liệu, hãy chọn biểu tượng.
   3. Trong trang chi tiết cho nguồn dữ liệu, hãy chọn nút Save & Test (Lưu và kiểm tra).
   4. Nếu nguồn dữ liệu được định cấu hình đúng cách, bạn sẽ thấy thông báo trong biểu mẫu:
      Thành công
      Nguồn dữ liệu đang hoạt động

Cập nhật trang tổng quan giám sát Beta

Nếu đã cài đặt phiên bản Beta của Trang tổng quan giám sát Apigee trong phiên bản 4.16.09, bạn có thể cập nhật lên phiên bản Beta cho 4.17.01.

Bạn phải cập nhật các thành phần của trang tổng quan theo thứ tự sau:

• apigee-influxdb
• apigee-telegraf trên mỗi nút
• apigee-grafana

Cách cập nhật trang tổng quan giám sát Beta:

1. Cập nhật Edge lên 4.17.01 theo mô tả tại Cập nhật Apigee Edge 4.16.01/4.16.05 lên 4.17.01 và Cập nhật Apigee Edge 4.16.09 lên 4.17.01.
2. Cập nhật apigee-influxdb:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb update
   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb thiết lập
   /opt/apigee-service apigee-apigee/apigee/apigee.
3. Cập nhật apigee-telegraf trên nút 1:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf update
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f /opt/apisapisapieservice/telegrapieapigeapieapieapi và thiết lập
   
4. Lặp lại bước 3 cho mọi nút.
5. Cập nhật apigee-grafana:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana update
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana thiết lập -f /opt/apigee_customerapie apianageapiebine.