Edge cho đám mây riêng tư phiên bản 4.18.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 nút này.
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 giao diện người dùng Edge.
Đối với apigee-influxdb
, bạn có thể cài đặt ứng dụng 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 này 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ổng 8086 và 8183 phải được 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
, hãy truyề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à đặt 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 apigee-telegraf setup
. Ví dụ: đặt chúng trong tệp văn bản có tên sa_telegraf.txt
:
Thuộc tính |
Mô tả |
---|---|
|
Chỉ định URL của nút apigee-influxdb, bao gồm cổng 8086. Ví dụ: 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
. Ví dụ: đặt chúng trong tệp văn bản có tên sa_grafana.txt
:
Thuộc tính |
Mô tả |
---|---|
|
Chỉ định địa chỉ IP hoặc tên DNS của nút InfluxDB. Ví dụ: 192.168.0.1 |
|
Cổng API InfluxDB do nguồn dữ liệu Grafana sử dụng. Chỉ định 8086. |
|
Tên người dùng Grafana để đăng nhập vào giao diện người dùng của trang tổng quan. |
|
Mật khẩu Grafana để đăng nhập vào giao diện người dùng của trang tổng quan. |
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:
- Cài đặt
apigee-influxdb
:> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb install
- Định cấu hình cơ sở dữ liệu
apigee-influxdb
:> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb setup
- Bắt đầu
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 khi cài đặt Edge:
- 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 install
- Tạo tệp cấu hình cho
apigee-telegraf
có tên làsa_telegraf.txt
. Thông thường, bạn sẽ 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".Đặ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
- Thay đổi chủ sở hữu thành "apigee":
> chown apigee:apigee /opt/apigee/customer/application/sa_telegraf.txt
- Đị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
- Khởi động lại
apigee-telegraf
:> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
- 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:
- 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 install
- 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 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. 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
- Thay đổi chủ sở hữu thành "apigee":
> chown apigee:apigee /opt/apigee/customer/application/sa_grafana.txt
- Đị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
- 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 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:
- Để đảm bảo
apigee-telegraf
đang thu thập dữ liệu- Chạy
apigee-service apigee-telegraf setup
, đây là quy tắc không thay đổi, kiểm tra lỗi, các phần phụ thuộc còn thiếu rồi khắc phục. - Hãy 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
- Chạy
- Để đảm bảo
apigee-influxdb
đang nhận được dữ liệu, hãy làm như sau:- Đả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. - 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
- Trong trường Truy vấn, hãy nhập "hiển thị cơ sở dữ liệu". Hãy đảm bảo bạn đã tạo các cơ sở dữ liệu sau:
system, application, events, _internal
. - Trong trường Truy vấn, hãy nhập "hiển thị máy chủ". Đảm bảo rằng bạn thấy các nút
apigee-influxdb
được liệt kê.
- Trong trường Truy vấn, hãy nhập "hiển thị cơ sở dữ liệu". Hãy đảm bảo bạn đã tạo các cơ sở dữ liệu sau:
- Đảm bảo các cổng TCP sau đây đang mở trên các nút dữ liệu
- Kiểm tra nguồn dữ liệu vào trang tổng quan:
- 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.
- Đối với mỗi nguồn dữ liệu, hãy chọn biểu tượng.
- 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).
- 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
Hãy làm theo 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 và 4.17.0x sử dụng cùng một quy trình
- 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 hoặc 4.17.0x
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 hoặc 4.17.0x, bạn có thể cập nhật lên phiên bản Beta cho 4.18.01.
Cách cập nhật trang tổng quan giám sát Beta:
- Cập nhật Edge lên 4.18.01 theo mô tả tại Cập nhật Apigee Edge từ 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
- 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ậtapigee-grafana
. Nếu không, hãy cập nhậtapigee-granfana
như bước sau. - Nếu bạn không cài đặt
apigee-grafana
trên nút Máy chủ quản lý, hãy cập nhậtapigee-grafana
trên nút mà bạn đã cài đặt:> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
- 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
- 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.18.01, 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 Beta:
- Cập nhật Edge lên 4.18.01 theo mô tả tại Cập nhật Apigee Edge từ 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.
- 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ậtapigee-grafana
. Nếu không, hãy cập nhậtapigee-granfana
như bước sau. - Nếu bạn không cài đặt
apigee-grafana
trên nút Máy chủ quản lý, hãy cập nhậtapigee-grafana
trên nút mà bạn đã cài đặt:> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
- 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
- Lặp lại bước 4 cho mọi nút.