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 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ư đối với Edge nút 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ư Management Server hoặc Edge Nút giao diện người dùng.

Đối với apigee-influxdb, bạn có thể cài đặt API này trên nút Edge hiện có, chẳng hạn như nút Management Server (Máy chủ quản lý) hoặc nút Edge UI, với không có thay đổi nào đối vớ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 cho lý do liên quan đến 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 250GB (dữ liệu giám sát được xoá hoàn toàn sau 1 tháng)
  • 1000 IOPS trở lên

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

Yêu cầu về cổng đối với apigee-influxdb

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

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

Cách cài đặt apigee-telegraf và apigee-grafana, bạn 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à "apigee" có thể truy cập người dùng cụ thể, chẳng hạn như /opt/apigee/customer/application và đặt chúng thuộc sở hữu của "apigee" người dùng.

Tham 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 vào lệnh thiết lập apigee-telegraf. Ví dụ: đặt chúng trong tệp văn bản có tên sa_telegraf.txt:

Thuộc tính

Nội dung mô tả

INFLUXDB_URL

Chỉ định URL của nút apigee-influxdb, bao gồm cả 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 chuyển đến lệnh thiết lập apigee-grafana. Ví dụ: đặt chúng trong tệp văn bản có tên sa_grafana.txt:

Thuộc tính

Nội dung mô tả

INFLUXDB_HOST

Chỉ định địa chỉ IP hoặc tên DNS của nút InfluxDB.

Ví dụ:

192.168.0.1

INFLUXDB_PORT

Cổng API InfluxDB mà nguồn dữ liệu Grafana sử dụng. Chỉ định 8086.

GRAFANA_USERNAME

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.

GRAFANA_PASSWORD

Mật khẩu Grafana để đăng nhập vào giao diện người dùng trang tổng quan.

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

Hãy làm theo hướng dẫn dưới đây để 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 trang 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 bắt đầu apigee-influxdb

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

Trên mọi nút trong quá trình 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ữ trong thư mục mà "apigee" có thể truy cập người dùng cụ thể, chẳng hạn như /opt/apigee/customer/application và đặt miền đó thuộc sở hữu của "api" người dùng.

    Đặt thuộc tính sau trong tệp để chỉ định URL của nút apigee-influxdb, bao gồm 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 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

Trên một nút duy nhất của quá trình cài đặt Edge, chẳng hạn như nút Giao diện người dùng của 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 cài đặt
  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 "apigee" có thể truy cập được người dùng cụ thể, chẳng hạn như /opt/apigee/customer/application và đặt miền đó thuộc sở hữu của "api" người dùng.

    Thiết lập các thuộc tính sau trong tệp này. Những 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 cách sử dụng tệp cấu hình:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana thiết lập -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 đăng nhập mà bạn đã chỉ định trong tệp cấu hình cho apigee-grafana. Trong ví dụ bên 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ố khi 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 sử dụng quy trình sau để khắc phục sự cố bản cài đặt của bạn:

  1. Để đảm bảo apigee-telegraf đang thu thập dữ liệu
    1. Chạy dịch vụ apigee thiết lập apigee-telegraf, không thay đổi giá trị, kiểm tra lỗi, 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 để phát hiện bất kỳ lỗi nào
  2. Để đảm bảo apigee-influxdb đang nhận dữ liệu:
    1. Đảm bảo các cổng TCP sau đang mở trên 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 "showdatabase" (hiển thị cơ sở dữ liệu).
        Đảm bảo các cơ sở dữ liệu sau đã được tạo: hệ thống, ứng dụng, sự kiện, _internal.
      2. Trong trường Truy vấn, hãy nhập "show server" (hiển thị máy chủ).
        Đảm bảo rằng bạn thấy các nút apigee-influxdb trong danh sách.
  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 ba nguồn dữ liệu được hiển thị.
    2. Đối với mỗi nguồn dữ liệu, hãy chọn biểu tượng này.
    3. Trong trang chi tiết cho nguồn dữ liệu này, hãy chọn nút Lưu và Kiểm thử .
    4. Nếu nguồn dữ liệu được định cấu hình đúng cách, bạn sẽ thấy một 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 thử nghiệm

Hãy sử dụng một trong hai quy trình bên dưới 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
  • 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 bạn đã 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, 4.17.01, hoặc 4.17.05 bạn có thể cập nhật nó lên phiên bản Beta cho 4.17.09.

Cách cập nhật trang tổng quan giám sát thử nghiệm:

  1. Cập nhật Edge lên 4.17.09 như mô tả trong bài viết 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 đế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 Máy chủ quản lý nút này, thì bước này cũng cập nhật apigee-grafana. Nếu không, hãy cập nhật apigee-granfana như được thể hiện trong bước tiếp theo.
  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 cập nhật
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf thiết lập -f configFile
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf khởi động lại
  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 phương thức apigee-collectd thay vì apigee-telegraf. Trong quá trình cập nhật lên 4.17.09 bạn 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 thử nghiệm:

  1. Cập nhật Edge lên 4.17.09 như mô tả trong bài viết 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 đế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 Máy chủ quản lý nút này, thì bước này cũng cập nhật apigee-grafana. Nếu không, hãy cập nhật apigee-granfana như được thể hiện trong bước tiếp theo.
  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 dừng
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf cài đặt
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf thiết lập -f configFile
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf khởi động lại
    > /opt/apigee/apigee-service/bin/apigee-service apigee-collectd gỡ cài đặt
  5. Lặp lại bước 4 cho mỗi nút.