Tự chữa lành bằng apigee-monit

Apigee Edge cho Đám mây riêng tư bao gồm apigee-monit, một công cụ dựa trên tiện ích monit nguồn mở. apigee-monit định kỳ thăm dò các dịch vụ Edge; nếu một dịch vụ không hoạt động, thì apigee-monit sẽ cố gắng khởi động lại dịch vụ đó.

Để sử dụng apigee-monit, bạn phải cài đặt theo cách thủ công. Đây không phải là một phần của quy trình cài đặt tiêu chuẩn.

Theo mặc định, apigee-monit sẽ kiểm tra trạng thái của các dịch vụ Edge sau mỗi 60 giây.

Bắt đầu nhanh

Phần này hướng dẫn bạn cách thiết lập và sử dụng nhanh apigee-monit.

Nếu bạn đang sử dụng Amazon Linux hoặc Oracle-Linux-7.X, trước tiên hãy cài đặt monit thông qua Fedora. Nếu không, hãy bỏ qua bước này.

sudo yum install -y https://kojipkgs.fedoraproject.org/packages/monit/5.25.1/1.el6/x86_64/monit-5.25.1-1.el6.x86_64.rpm

Để cài đặt apigee-monit, hãy làm theo các bước sau:

  Cài đặt apigee-monit
/opt/apigee/apigee-service/bin/apigee-service apigee-monit install
/opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
/opt/apigee/apigee-service/bin/apigee-service apigee-monit start

Thao tác này sẽ cài đặt apigee-monit và bắt đầu giám sát tất cả các thành phần trên nút theo mặc định.

  Ngừng giám sát các thành phần
/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c component_name
/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all
  Bắt đầu giám sát các thành phần
/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c component_name
/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c all
  Nhận thông tin tóm tắt về trạng thái
/opt/apigee/apigee-service/bin/apigee-service apigee-monit report
/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary
  Xem các tệp nhật ký apigee-monit
cat /opt/apigee/var/log/apigee-monit/apigee-monit.log

Từng chủ đề này và các chủ đề khác được mô tả chi tiết trong các phần tiếp theo.

Giới thiệu về apigee-monit

apigee-monit giúp đảm bảo rằng tất cả các thành phần trên một nút đều hoạt động. Việc này được thực hiện bằng cách cung cấp nhiều dịch vụ, bao gồm:

  • Khởi động lại các dịch vụ không thành công
  • Hiển thị thông tin tóm tắt
  • Ghi nhật ký trạng thái giám sát
  • Gửi thông báo
  • Giám sát các dịch vụ không phải Edge

Apigee khuyên bạn nên theo dõi apigee-monit để đảm bảo rằng dịch vụ này đang chạy. Để biết thêm thông tin, hãy xem bài viết Theo dõi apigee-monit.

Cấu trúc apigee-monit

Trong quá trình cài đặt và định cấu hình Apigee Edge cho Đám mây riêng tư, bạn có thể cài đặt một phiên bản riêng biệt của apigee-monit trên mỗi nút trong cụm. Các phiên bản apigee-monit riêng biệt này hoạt động độc lập với nhau: chúng không truyền đạt trạng thái của các thành phần cho các nút khác, cũng như không truyền đạt các lỗi của chính tiện ích giám sát cho bất kỳ dịch vụ trung tâm nào.

Hình ảnh sau đây cho thấy cấu trúc apigee-monit trong một cụm gồm 5 nút:

Cấu trúc của Apigee monit trong một cụm 5 nút
Hình 1: Một phiên bản riêng biệt của apigee-monit chạy độc lập trên mỗi nút trong một cụm

Cấu hình thành phần

apigee-monit sử dụng cấu hình thành phần để xác định những thành phần cần giám sát, những khía cạnh của thành phần cần kiểm tra và hành động cần thực hiện trong trường hợp xảy ra lỗi.

Theo mặc định, apigee-monit sẽ giám sát tất cả các thành phần Edge trên một nút bằng cách sử dụng cấu hình thành phần được xác định trước. Để xem chế độ cài đặt mặc định, bạn có thể xem các tệp cấu hình thành phần apigee-monit. Bạn không thể thay đổi cấu hình mặc định của thành phần.

apigee-monit kiểm tra nhiều khía cạnh của một thành phần, tuỳ thuộc vào thành phần mà nó đang kiểm tra. Bảng sau đây liệt kê những nội dung mà apigee-monit kiểm tra cho từng thành phần và cho bạn biết vị trí cấu hình thành phần cho từng thành phần. Lưu ý rằng một số thành phần được xác định trong một tệp cấu hình duy nhất, trong khi những thành phần khác có cấu hình riêng.

Thành phần Vị trí cấu hình Nội dung được giám sát
Máy chủ quản lý /opt/apigee/edge-management-server/monit/default.conf apigee-monit kiểm tra:
  • (Các) cổng được chỉ định đang mở và chấp nhận yêu cầu
  • (Các) giao thức đã chỉ định được hỗ trợ
  • Trạng thái của phản hồi

Ngoài ra, đối với các thành phần apigee-monit này:

  • Yêu cầu nhiều lần thất bại trong một số chu kỳ nhất định trước khi thực hiện hành động
  • Đặt đường dẫn yêu cầu tuỳ chỉnh
Trình xử lý thông báo /opt/apigee/edge-message-processor/monit/default.conf
Máy chủ Postgres /opt/apigee/edge-postgres-server/monit/default.conf
Máy chủ Qpid /opt/apigee/edge-qpid-server/monit/default.conf
Bộ định tuyến /opt/apigee/edge-router/monit/default.conf
Cassandra
Giao diện người dùng Edge
SymasLDAP
Postgres
Qpid
Zookeeper
/opt/apigee/data/apigee-monit/monit.conf apigee-monit kiểm tra:
  • Dịch vụ đang chạy

Ví dụ sau đây cho thấy cấu hình thành phần mặc định cho thành phần edge-router:

check host edge-router with address localhost
  restart program = "/opt/apigee/apigee-service/bin/apigee-service edge-router monitrestart"
  if failed host 10.1.1.0 port 8081 and protocol http
    and request "/v1/servers/self/uuid"
    with timeout 15 seconds
    for 2 times within 3 cycles
  then restart

  if failed port 15999 and protocol http
    and request "/v1/servers/self"
    and status < 600
    with timeout 15 seconds
    for 2 times within 3 cycles
  then restart

Ví dụ sau đây cho thấy cấu hình mặc định cho thành phần Giao diện người dùng cổ điển (edge-ui):

check process edge-ui
 with pidfile /opt/apigee/var/run/edge-ui/edge-ui.pid
 start program = "/opt/apigee/apigee-service/bin/apigee-service edge-ui start" with timeout 55 seconds
 stop program = "/opt/apigee/apigee-service/bin/apigee-service edge-ui stop"

Điều này áp dụng cho Giao diện người dùng cũ, chứ không phải Giao diện người dùng Edge mới có tên thành phần là edge-management-ui.

Bạn không thể thay đổi cấu hình thành phần mặc định cho bất kỳ thành phần nào của Apigee Edge cho Đám mây riêng. Tuy nhiên, bạn có thể thêm cấu hình thành phần của riêng mình cho các dịch vụ bên ngoài, chẳng hạn như điểm cuối mục tiêu hoặc dịch vụ httpd. Để biết thêm thông tin, hãy xem phần Cấu hình thành phần không phải Apigee.

Theo mặc định, apigee-monit sẽ giám sát tất cả các thành phần trên một nút mà nó đang chạy. Bạn có thể bật hoặc tắt tính năng này cho tất cả các thành phần hoặc cho từng thành phần riêng lẻ. Để biết thêm thông tin, hãy xem các bài viết sau:

Cài đặt apigee-monit

apigee-monit không được cài đặt theo mặc định; bạn có thể cài đặt theo cách thủ công sau khi nâng cấp hoặc cài đặt phiên bản 4.19.01 trở lên của Apigee Edge cho Đám mây riêng.

Phần này mô tả cách cài đặt apigee-monit.

Để biết thông tin về cách gỡ cài đặt apigee-monit, hãy xem phần Gỡ cài đặt apigee-monit.

Cài đặt apigee-monit

Phần này mô tả cách cài đặt apigee-monit.

Cách cài đặt apigee-monit:

  1. Cài đặt apigee-monit bằng lệnh sau:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit install
  2. Định cấu hình apigee-monit bằng lệnh sau:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
  3. Khởi động apigee-monit bằng lệnh sau:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit start
  4. Lặp lại quy trình này trên từng nút trong cụm của bạn.

Dừng và bắt đầu giám sát các thành phần

Khi một dịch vụ dừng vì bất kỳ lý do nào, apigee-monit sẽ cố gắng khởi động lại dịch vụ đó.

Điều này có thể gây ra vấn đề nếu bạn muốn cố ý dừng một thành phần. Ví dụ: bạn có thể muốn dừng một thành phần khi cần sao lưu hoặc nâng cấp thành phần đó. Nếu apigee-monit khởi động lại dịch vụ trong quá trình sao lưu hoặc nâng cấp, quy trình bảo trì của bạn có thể bị gián đoạn, có thể khiến quy trình này không thành công.

Các phần sau đây trình bày các lựa chọn để dừng giám sát các thành phần.

Dừng một thành phần và huỷ giám sát thành phần đó

Để dừng một thành phần và ngừng giám sát thành phần đó, hãy thực thi lệnh sau:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit stop-component -c component_name
component_name có thể là một trong những trạng thái sau đây:
  • apigee-cassandra (Cassandra)
  • apigee-openldap (OpenLDAP)
  • apigee-postgresql (Cơ sở dữ liệu PostgreSQL)
  • apigee-qpidd (Qpidd)
  • apigee-sso (Edge SSO)
  • apigee-zookeeper (ZooKeeper)
  • edge-management-server (Máy chủ quản lý)
  • edge-management-ui (Giao diện người dùng Edge mới)
  • edge-message-processor (Bộ xử lý thông báo)
  • edge-postgres-server (Máy chủ Postgres)
  • edge-qpid-server (Máy chủ Qid)
  • edge-router (Bộ định tuyến Edge)
  • edge-ui (Giao diện người dùng cổ điển)

Xin lưu ý rằng "all" không phải là một lựa chọn hợp lệ cho stop-component. Bạn chỉ có thể dừng và huỷ giám sát một thành phần tại một thời điểm bằng stop-component.

Để khởi động lại thành phần và tiếp tục giám sát, hãy thực thi lệnh sau:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit start-component -c component_name

Xin lưu ý rằng "all" không phải là một lựa chọn hợp lệ cho start-component.

Để biết hướng dẫn về cách dừng và huỷ giám sát tất cả các thành phần, hãy xem phần Dừng và huỷ giám sát tất cả các thành phần.

Ngừng giám sát một thành phần (nhưng không dừng thành phần đó)

Để ngừng giám sát một thành phần (nhưng không dừng thành phần đó), hãy thực thi lệnh sau:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c component_name
component_name có thể là một trong những trạng thái sau đây:
  • apigee-cassandra (Cassandra)
  • apigee-openldap (OpenLDAP)
  • apigee-postgresql (Cơ sở dữ liệu PostgreSQL)
  • apigee-qpidd (Qpidd)
  • apigee-sso (Edge SSO)
  • apigee-zookeeper (ZooKeeper)
  • edge-management-server (Máy chủ quản lý)
  • edge-management-ui (Giao diện người dùng Edge mới)
  • edge-message-processor (Bộ xử lý thông báo)
  • edge-postgres-server (Máy chủ Postgres)
  • edge-qpid-server (Máy chủ Qid)
  • edge-router (Bộ định tuyến Edge)
  • edge-ui (Giao diện người dùng cổ điển)

Để tiếp tục giám sát thành phần, hãy thực thi lệnh sau:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c component_name

Ngừng giám sát tất cả các thành phần (nhưng không dừng các thành phần đó)

Để ngừng giám sát tất cả các thành phần (nhưng không dừng các thành phần đó), hãy thực thi lệnh sau:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all

Để tiếp tục theo dõi tất cả các thành phần, hãy thực thi lệnh sau:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c all

Dừng tất cả các thành phần và ngừng giám sát chúng

Để dừng tất cả các thành phần và huỷ giám sát chúng, hãy thực thi các lệnh sau:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all
/opt/apigee/apigee-service/bin/apigee-all stop

Để khởi động lại tất cả các thành phần và tiếp tục giám sát, hãy thực thi các lệnh sau:

/opt/apigee/apigee-service/bin/apigee-all start
/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c all

Để ngừng giám sát tất cả các thành phần, bạn cũng có thể tắt apigee-monit, như mô tả trong phần Dừng, khởi động và tắt apigee-monit.

Dừng, khởi động và tắt apigee-monit

Giống như mọi dịch vụ khác, bạn có thể dừng và bắt đầu apigee-monit bằng lệnh apigee-service. Ngoài ra, apigee-monit còn hỗ trợ lệnh unmonitor. Lệnh này cho phép bạn tạm thời dừng giám sát các thành phần.

Dừng apigee-monit

Để dừng apigee-monit, hãy dùng lệnh sau:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit stop

Khởi động apigee-monit

Để bắt đầu apigee-monit, hãy dùng lệnh sau:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit start

Tắt apigee-monit

Bạn có thể tạm ngưng giám sát tất cả các thành phần trên nút bằng lệnh sau:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all

Ngoài ra, bạn có thể tắt vĩnh viễn apigee-monit bằng cách gỡ cài đặt apigee-monit khỏi nút, như mô tả trong phần Gỡ cài đặt apigee-monit.

Gỡ cài đặt apigee-monit

Cách gỡ cài đặt apigee-monit:

  1. Nếu bạn thiết lập một công việc cron để theo dõi apigee-monit, hãy xoá công việc cron trước khi gỡ cài đặt apigee-monit:
    sudo rm /etc/cron.d/apigee-monit.cron
  2. Dừng apigee-monit bằng lệnh sau:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit stop
  3. Gỡ cài đặt apigee-monit bằng lệnh sau:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit uninstall
  4. Lặp lại quy trình này trên từng nút trong cụm của bạn.

Giám sát một thành phần mới cài đặt

Nếu cài đặt một thành phần mới trên một nút đang chạy apigee-monit, bạn có thể bắt đầu giám sát thành phần đó bằng cách thực thi lệnh restart của apigee-monit. Thao tác này sẽ tạo một tệp monit.conf mới, trong đó sẽ có thành phần mới trong cấu hình thành phần.

Ví dụ sau đây khởi động lại apigee-monit:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit restart

Tuỳ chỉnh apigee-monit

Bạn có thể tuỳ chỉnh nhiều chế độ cài đặt của apigee-monit, bao gồm:

  1. Chế độ cài đặt mặc định cho apigee-monitnút điều khiển
  2. Chế độ cài đặt cấu hình chung
  3. Cấu hình thành phần không phải Apigee

Chế độ cài đặt mặc định của chế độ kiểm soát apigee-monit

Bạn có thể tuỳ chỉnh chế độ cài đặt mặc định của apigee-monit, chẳng hạn như tần suất kiểm tra trạng thái và vị trí của các tệp apigee-monit. Bạn thực hiện việc này bằng cách chỉnh sửa một tệp thuộc tính bằng kỹ thuật mã có cấu hình. Các tệp thuộc tính sẽ vẫn tồn tại ngay cả sau khi bạn nâng cấp Apigee Edge cho Đám mây riêng tư.

Bảng sau đây mô tả các chế độ cài đặt mặc định của apigee-monit mà bạn có thể tuỳ chỉnh:

Thuộc tính Mô tả
conf_monit_httpd_port Cổng của trình nền httpd. apigee-monit sử dụng httpd cho ứng dụng trang tổng quan và để bật báo cáo/bản tóm tắt. Giá trị mặc định là 2812.
conf_monit_httpd_allow Các quy tắc ràng buộc đối với các yêu cầu gửi đến trình nền httpd. apigee-monit sử dụng httpd để chạy ứng dụng trang tổng quan và bật báo cáo/bản tóm tắt. Giá trị này phải trỏ đến máy chủ lưu trữ cục bộ (máy chủ lưu trữ mà httpd đang chạy).

Để yêu cầu các yêu cầu phải có tên người dùng và mật khẩu, hãy dùng cú pháp sau:

conf_monit_httpd_allow=allow username:"password"\nallow 127.0.0.1

Khi thêm tên người dùng và mật khẩu, hãy chèn "\n" giữa mỗi ràng buộc. Không chèn ký tự xuống dòng hoặc ký tự trả về dòng thực tế vào giá trị.

conf_monit_monit_datadir Thư mục lưu trữ thông tin chi tiết về sự kiện.
conf_monit_monit_delay_time Khoảng thời gian mà apigee-monit đợi sau khi được tải vào bộ nhớ lần đầu tiên trước khi chạy. Điều này chỉ ảnh hưởng đến apigee-monit lần kiểm tra quy trình đầu tiên.
conf_monit_monit_logdir Vị trí của tệp nhật ký apigee-monit.
conf_monit_monit_retry_time Tần suất mà apigee-monit cố gắng kiểm tra từng quy trình; mặc định là 60 giây.
conf_monit_monit_rundir Vị trí của các tệp PID và trạng thái mà apigee-monit dùng để kiểm tra các quy trình.

Cách tuỳ chỉnh chế độ cài đặt mặc định của chế độ apigee-monit:

  1. Chỉnh sửa tệp sau:
    /opt/apigee/customer/application/monit.properties

    Nếu tệp này không tồn tại, hãy tạo tệp và đặt chủ sở hữu thành người dùng "apigee":

    chown apigee:apigee /opt/apigee/customer/application/monit.properties

    Xin lưu ý rằng nếu tệp này đã tồn tại, thì có thể có thêm các thuộc tính cấu hình được xác định trong tệp ngoài những thuộc tính được liệt kê trong bảng ở trên. Bạn không nên sửa đổi các thuộc tính khác ngoài những thuộc tính được liệt kê ở trên.

  2. Đặt hoặc thay thế giá trị thuộc tính bằng giá trị mới.

    Ví dụ: để thay đổi vị trí của tệp nhật ký thành /tmp, hãy thêm hoặc chỉnh sửa thuộc tính sau:

    conf_monit_monit_logdir=/tmp/apigee-monit.log
  3. Lưu các thay đổi vào tệp monit.properties.
  4. Định cấu hình lại apigee-monit bằng lệnh sau:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
  5. Tải lại apigee-monit bằng lệnh sau:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit reload

    Nếu bạn không thể khởi động lại apigee-monit, hãy kiểm tra tệp nhật ký để tìm lỗi như mô tả trong phần Truy cập vào tệp nhật ký apigee-monit.

  6. Lặp lại quy trình này cho từng nút trong cụm.

Chế độ cài đặt cấu hình chung

Bạn có thể xác định chế độ cài đặt cấu hình chung cho apigee-monit; ví dụ: bạn có thể thêm thông báo qua email cho cảnh báo. Bạn thực hiện việc này bằng cách tạo một tệp cấu hình trong thư mục /opt/apigee/data/apigee-monit rồi khởi động lại apigee-monit.

Cách xác định chế độ cài đặt cấu hình chung cho apigee-monit:

  1. Tạo một tệp cấu hình thành phần mới ở vị trí sau:
    /opt/apigee/data/apigee-monit/filename.conf

    Trong đó filename có thể là bất kỳ tên tệp hợp lệ nào, ngoại trừ "monit".

  2. Thay đổi quyền sở hữu tệp cấu hình mới thành người dùng "apigee", như trong ví dụ sau:
    chown apigee:apigee /opt/apigee/data/apigee-monit/my-mail-config.conf
  3. Thêm chế độ cài đặt cấu hình chung vào tệp mới. Ví dụ sau đây định cấu hình một máy chủ thư và thiết lập người nhận cảnh báo:
    SET MAILSERVER smtp.gmail.com PORT 465
      USERNAME "example-admin@gmail.com" PASSWORD "PASSWORD"
      USING SSL, WITH TIMEOUT 15 SECONDS
    
    SET MAIL-FORMAT {
      from: edge-alerts@example.com
      subject: Monit Alert -- Service: $SERVICE $EVENT on $HOST
    }
    SET ALERT fred@example.com
    SET ALERT nancy@example.com

    Để xem danh sách đầy đủ các lựa chọn cấu hình chung, hãy xem tài liệu monit.

  4. Lưu các thay đổi vào tệp cấu hình thành phần.
  5. Tải lại apigee-monit bằng lệnh sau:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit reload

    Nếu apigee-monit không khởi động lại, hãy kiểm tra tệp nhật ký để tìm lỗi như mô tả trong phần Truy cập vào tệp nhật ký apigee-monit.

  6. Lặp lại quy trình này cho từng nút trong cụm.

Cấu hình thành phần không phải Apigee

Bạn có thể thêm cấu hình của riêng mình vào apigee-monit để kiểm tra các dịch vụ không thuộc Apigee Edge cho Đám mây riêng. Ví dụ: bạn có thể sử dụng apigee-monit để kiểm tra xem các API của bạn có đang chạy hay không bằng cách gửi yêu cầu đến điểm cuối mục tiêu.

Cách thêm cấu hình thành phần không phải Apigee:

  1. Tạo một tệp cấu hình thành phần mới ở vị trí sau:
    /opt/apigee/data/apigee-monit/filename.conf

    Trong đó filename có thể là bất kỳ tên tệp hợp lệ nào, ngoại trừ "monit".

    Bạn có thể tạo bao nhiêu tệp cấu hình thành phần tuỳ ý. Ví dụ: bạn có thể tạo một tệp cấu hình riêng cho từng thành phần không phải Apigee mà bạn muốn theo dõi trên nút.

  2. Thay đổi quyền sở hữu tệp cấu hình mới thành người dùng "apigee", như trong ví dụ sau:
    chown apigee:apigee /opt/apigee/data/apigee-monit/my-config.conf
  3. Thêm cấu hình tuỳ chỉnh vào tệp mới. Ví dụ sau đây kiểm tra điểm cuối đích trên máy chủ cục bộ:
    CHECK HOST localhost_validate_test WITH ADDRESS localhost
      IF FAILED
        PORT 15999
        PROTOCOL http
        REQUEST "/validate__test"
        CONTENT = "Server Ready"
        FOR 2 times WITHIN 3 cycles
      THEN alert

    Để biết danh sách đầy đủ các chế độ cài đặt cấu hình có thể có, hãy xem tài liệu về monit.

  4. Lưu các thay đổi vào tệp cấu hình.
  5. Tải lại apigee-monit bằng lệnh sau:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit reload

    Nếu apigee-monit không khởi động lại, hãy kiểm tra tệp nhật ký để tìm lỗi như mô tả trong phần Truy cập vào tệp nhật ký apigee-monit.

  6. Lặp lại quy trình này cho từng nút trong cụm.

Xin lưu ý rằng điều này chỉ áp dụng cho các thành phần không phải của Edge. Bạn không thể tuỳ chỉnh cấu hình thành phần cho các thành phần Edge.

Truy cập vào tệp nhật ký apigee-monit

apigee-monit ghi lại mọi hoạt động, bao gồm cả sự kiện, lần khởi động lại, thay đổi về cấu hình và cảnh báo trong một tệp nhật ký.

Vị trí mặc định của tệp nhật ký là:

/opt/apigee/var/log/apigee-monit/apigee-monit.log

Bạn có thể thay đổi vị trí mặc định bằng cách tuỳ chỉnh apigee-monit chế độ cài đặt điều khiển.

Các mục nhập trong tệp nhật ký có dạng như sau:

'edge-message-processor' trying to restart
[UTC Dec 14 16:20:42] info     : 'edge-message-processor' trying to restart
'edge-message-processor' restart: '/opt/apigee/apigee-service/bin/apigee-service edge-message-processor monitrestart'

Bạn không thể tuỳ chỉnh định dạng của các mục trong tệp nhật ký apigee-monit.

Xem trạng thái tổng hợp bằng apigee-monit

apigee-monit bao gồm các lệnh sau đây để cung cấp cho bạn thông tin tổng hợp về trạng thái của các thành phần trên một nút:

Lệnh Cách sử dụng
report
/opt/apigee/apigee-service/bin/apigee-service apigee-monit report
summary
/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary

Mỗi lệnh này sẽ được giải thích chi tiết hơn trong các phần tiếp theo.

báo cáo

Lệnh report cung cấp cho bạn thông tin tóm tắt tổng hợp về số lượng thành phần đang hoạt động, không hoạt động, đang được khởi tạo hoặc hiện đang không được giám sát trên một nút. Ví dụ sau đây gọi lệnh report:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit report

Ví dụ sau đây cho thấy đầu ra report trên cấu hình AIO (tất cả trong một):

/opt/apigee/apigee-service/bin/apigee-service apigee-monit report
up:            11 (100.0%)
down:           0 (0.0%)
initialising:   0 (0.0%)
unmonitored:    1 (8.3%)
total:         12 services

Trong ví dụ này, apigee-monit báo cáo rằng 11 trong số 12 dịch vụ đang hoạt động. Hiện tại, một dịch vụ không được giám sát.

Bạn có thể gặp lỗi Connection refused khi lần đầu tiên thực thi lệnh report. Trong trường hợp này, hãy đợi trong khoảng thời gian của thuộc tính conf_monit_monit_delay_time rồi thử lại.

Gemini và Gemini Advanced

Lệnh summary liệt kê từng thành phần và cung cấp trạng thái của thành phần đó. Ví dụ sau đây gọi lệnh summary:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary

Ví dụ sau đây cho thấy đầu ra summary trên cấu hình AIO (tất cả trong một):

/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary
Monit 5.25.1 uptime: 4h 20m
 Service Name                     Status                      Type
 host_name                        OK                          System
 apigee-zookeeper                 OK                          Process
 apigee-cassandra                 OK                          Process
 apigee-openldap                  OK                          Process
 apigee-qpidd                     OK                          Process
 apigee-postgresql                OK                          Process
 edge-ui                          OK                          Process
 edge-qpid-server                 OK                          Remote Host
 edge-postgres-server             OK                          Remote Host
 edge-management-server           OK                          Remote Host
 edge-router                      OK                          Remote Host
 edge-message-processor           OK                          Remote Host

Nếu bạn gặp lỗi Connection refused khi lần đầu tiên thực thi lệnh summary, hãy thử đợi trong khoảng thời gian của thuộc tính conf_monit_monit_delay_time, rồi thử lại.

Giám sát apigee-monit

Tốt nhất là bạn nên thường xuyên kiểm tra để đảm bảo apigee-monit đang chạy trên mỗi nút.

Để kiểm tra xem apigee-monit có đang chạy hay không, hãy dùng lệnh sau:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit

Apigee khuyên bạn nên định kỳ phát lệnh này trên mỗi nút đang chạy apigee-monit. Một cách để thực hiện việc này là dùng một tiện ích như cron để thực thi các tác vụ theo lịch ở các khoảng thời gian được xác định trước.

Cách sử dụng cron để theo dõi apigee-monit:

  1. Thêm chế độ hỗ trợ cron bằng cách sao chép thư mục apigee-monit.cron vào thư mục /etc/cron.d, như trong ví dụ sau:
    cp /opt/apigee/apigee-monit/cron/apigee-monit.cron /etc/cron.d/
  2. Mở tệp apigee-monit.cron để chỉnh sửa.

    Tệp apigee-monit.cron xác định công việc cron cần thực thi cũng như tần suất thực thi công việc đó. Ví dụ sau đây cho thấy các giá trị mặc định:

    # Cron entry to check if monit process is running. If not start it
    */2 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit

    Tệp này sử dụng cú pháp sau, trong đó 5 trường đầu tiên xác định thời gian mà apigee-monit thực thi hành động của mình:

    min hour day_of_month month day_of_week task_to_execute

    Ví dụ: thời gian thực thi mặc định là */2 * * * *, hướng dẫn cron kiểm tra quy trình apigee-monit sau mỗi 2 phút.

    Bạn không thể thực thi một công việc cron thường xuyên hơn một lần mỗi phút.

    Để biết thêm thông tin về cách sử dụng cron, hãy xem tài liệu hoặc trang hướng dẫn của hệ điều hành máy chủ.

  3. Thay đổi chế độ cài đặt cron cho phù hợp với chính sách của tổ chức. Ví dụ: để thay đổi tần suất thực thi thành 5 phút một lần, hãy đặt định nghĩa công việc thành như sau:
    */5 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit
  4. Lưu tệp apigee-monit.cron.
  5. Lặp lại quy trình này cho từng nút trong cụm.

Nếu cron không bắt đầu xem apigee-monit, hãy kiểm tra để đảm bảo rằng:

  • Có một dòng trống sau định nghĩa công việc cron.
  • Chỉ có một việc làm cron được xác định trong tệp. (Các dòng có chú thích không được tính.)

Nếu muốn dừng hoặc tạm thời vô hiệu hoá apigee-monit, bạn cũng phải vô hiệu hoá công việc cron này, nếu không cron sẽ khởi động lại apigee-monit.

Để tắt cron, hãy thực hiện một trong những cách sau:

  • Xoá tệp /etc/cron.d/apigee-monit.cron:
    sudo rm /etc/cron.d/apigee-monit.cron

    Bạn sẽ phải sao chép lại nếu sau này muốn bật lại cron để xem apigee-monit.

    HOẶC

  • Chỉnh sửa tệp /etc/cron.d/apigee-monit.cron và nhận xét về định nghĩa công việc bằng cách thêm "#" vào đầu dòng; ví dụ:
    # 10 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit