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

Edge for Private Cloud phiên bản 4.17.09

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 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ư đố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 biệt hoặc sử dụng lại một trong các nút Edge hiện có, chẳng hạn như 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 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 cần thay đổi 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 đáp ứng các yêu cầu sau:

• CPU 2 nhân
• RAM 4 GB
• Dung lượng ổ đĩa 250 GB (dữ liệu giám sát sẽ bị xoá sau 1 tháng)
• IOPS từ 1.000 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ổng 8086 và 8183 phải mở trên các nút dữ liệu apigee-influxdb để nút chạy apigee-grafana và apigee-telegraf có thể truy cập.

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 cần truyền một 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à đặt quyền sở hữu cho 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 tệp văn bản mà bạn truyền đến lệnh setup apigee-telegraf. Ví dụ: đặt các biến này trong một tệp văn bản có tên là 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 tệp văn bản mà bạn truyền đến lệnh apigee-grafana setup. Ví dụ: đặt các biến đó trong một tệp văn bản có tên là sa_grafana.txt:

192.168.0.1

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

Hãy 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 một nút trung tâm)
• apigee-telegraf (trên mỗi nút)
• apigee-grafana (trên một 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 một nút Edge đang 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 install
2. Định cấu hình cơ sở dữ liệu 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

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

Trên mọi nút của bản cài đặt Edge:

1. Trên nút Edge đầu tiên, hãy cài đặt apigee-telegraf:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
2. Tạo tệp cấu hình cho apigee-telegraf có tên là sa_telegraf.txt. 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 người dùng "apigee" làm chủ sở hữu.
   
   Đặ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 setup -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 restart
6. Lặp lại quy 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 duy nhất

Trên một nút duy nhất của bản 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, hãy cài đặt apigee-grafana:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana install
2. Tạo tệp cấu hình cho apigee-grafana có tên là sa_grafana.txt. 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 quyền sở hữu cho người dùng "apigee".
   
   Đặt các thuộc tính sau trong tệp. Các thuộc tính này đượ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 restart

Để 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 đăng nhập bạn đã chỉ định trong tệp cấu hình cho apigee-grafana. Trong ví dụ trên, tên người dùng/mật khẩu là admin/admin.

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ố cài đặt:

1. Để đảm bảo apigee-telegraf đang thu thập dữ liệu
   1. Chạy apigee-service apigee-telegraf setup, đây là lệnh luỹ đẳng, hãy kiểm tra lỗi, các phần phụ thuộc bị 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 có lỗi nào không
2. Để đảm bảo apigee-influxdb đang nhận 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. Sử 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 "show databases".
         Đảm bảo rằng các cơ sở dữ liệu sau đã được tạo: system, application, events, _internal.
      2. Trong trường Truy vấn, hãy nhập "show servers".
         Đảm bảo rằng bạn thấy các nút apigee-influxdb được liệt kê.
3. Kiểm tra các nguồn dữ liệu cho trang tổng quan:
   1. Chọn Nguồn dữ liệu trong trình đơn chính. Bạn sẽ thấy biểu tượng của 3 nguồn dữ liệu.
   2. Đối với mỗi nguồn dữ liệu, hãy chọn biểu tượng.
   3. Trên trang thông tin chi tiết của nguồn dữ liệu, hãy chọn nút Lưu và kiểm tra.
   4. Nếu nguồn dữ liệu được định cấu hình chính xác, bạn sẽ thấy một thông báo có dạng:
      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 phiên bản thử nghiệm

Sử dụng một trong hai quy trình dưới đây dựa trên phiên bản Edge mà bạn đang nâng cấp:

• 4.16.09, 4.17.01 và 4.17.05 sử dụng cùng một quy trình
• Phiên bản 4.16.05 yêu cầu bạn gỡ cài đặt apigee-collectd trong quá trình cập nhật.

Cập nhật từ phiên bản 4.16.09, 4.17.01 hoặc 4.17.05

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

Cách cập nhật Trang tổng quan giám sát phiên bản thử nghiệm:

1. Cập nhật Edge lên phiên bản 4.17.09 như mô tả trong bài viết Cập nhật Apigee Edge phiên bản 4.17.01/4.17.05 lên phiên bản 4.17.09, Cập nhật Apigee Edge phiên bản 4.16.09 lên phiên bản 4.17.09 và Cập nhật Apigee Edge phiên bản 4.16.01/4.16.05 lên phiên bản 4.17.09.
2. Cập nhật apigee-influxdb trên nút Máy chủ quản lý:
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
   
   trong đó configFile là tệp cấu hình mà bạn đã dùng để cài đặt apigee-influx.
   
   Nếu bạn cũng đã cài đặt apigee-grafana trên nút Máy chủ quản lý, thì bước này cũng sẽ cập nhật apigee-grafana. Nếu không, hãy cập nhật apigee-granfana như trong bước sau.
3. Nếu bạn chưa cài đặt apigee-grafana trên nút Máy chủ quản lý, hãy cập nhật apigee-grafana trên nút mà bạn đã cài đặt:
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
4. 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 configFile
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
5. Lặp lại bước 4 cho mọi nút.

Cập nhật từ phiên bản 4.16.05

Phiên bản 4.16.05 của trang tổng quan đã sử dụng apigee-collectd thay vì apigee-telegraf. Trong quá trình cập nhật lên phiên bản 4.17.09, bạn sẽ gỡ cài đặt apigee-collectd và cài đặt apigee-telegraf.

Cách cập nhật Trang tổng quan giám sát phiên bản thử nghiệm:

1. Cập nhật Edge lên phiên bản 4.17.09 như mô tả trong phần Cập nhật Apigee Edge 4.17.01/4.17.05 lên 4.17.09, Cập nhật Apigee Edge 4.16.09 lên 4.17.09 và Cập nhật Apigee Edge 4.16.01/4.16.05 lên 4.17.09.
2. Cập nhật apigee-influxdb trên nút Máy chủ quản lý:
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
   
   trong đó configFile là tệp cấu hình mà bạn đã dùng để cài đặt apigee-influx.
   
   Nếu bạn cũng đã cài đặt apigee-grafana trên nút Máy chủ quản lý, thì bước này cũng sẽ cập nhật apigee-grafana. Nếu không, hãy cập nhật apigee-granfana như trong bước sau.
3. Nếu bạn chưa cài đặt apigee-grafana trên nút Máy chủ quản lý, hãy cập nhật apigee-grafana trên nút mà bạn đã cài đặt:
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
4. Cài đặt apigee-telegraf trên nút 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. Lặp lại bước 4 cho mọi nút.