Trang này được dịch bởi Cloud Translation API.

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

Apigee Edge dành cho Cloud riêng tư bao gồm apigee-monit, một công cụ dựa trên nguồn mở tiện ích Monit. apigee-monit định kỳ dịch vụ các cuộc thăm dò ý kiến; nếu một dịch vụ không hoạt động thì apigee-monit sẽ cố 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 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 60 giây một lần.

Bắt đầu nhanh

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

Nếu bạn đang sử dụng Amazon Linux hoặc Oracle-Linux-7.X, trước tiên cài đặt monit qua phớt. Nếu không, 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` Theo mặc định, thao tác này sẽ cài đặt `apigee-monit` và bắt đầu giám sát tất cả thành phần trên nút.
	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
	Xem thông tin về trạng thái của bản tóm tắt
	/opt/apigee/apigee-service/bin/apigee-service apigee-monit report /opt/apigee/apigee-service/bin/apigee-service apigee-monit summary
	Xem tệp nhật ký `apigee-monit`
	cat /opt/apigee/var/log/apigee-monit/apigee-monit.log

Mỗi chủ đề trong số 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 tất cả các thành phần trên một nút luôn sẵn sàng và hoạt động. Công cụ này thực hiện việc này bằng cách cung cấp nhiều dịch vụ đa dạng, bao gồm:

Khởi động lại các dịch vụ không thành công
Đang hiển thị thông tin tóm tắt
Trạng thái giám sát việc ghi nhật ký
Đang 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 ứng dụng này đang chạy. Để biết thêm thông tin, xem bài viết Theo dõi apigee-monit.

kiến 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 (không bắt buộc) apigee-monit trên mỗi nút trong cụm của bạn. Các thực thể apigee-monit riêng biệt này hoạt động độc lập với một thực thể nút kia: chúng không thông báo trạng thái của các thành phần cho các nút khác, chúng cũng không thông báo về các sự cố của chính tiện ích giám sát tới 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 5 nút:

Kiến trúc
của Apigee monit trong một cụm 5 nút — **Hình 1: Một thực thể riêng của `apigee-monit` chạy riêng biệt trên từng 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 các thành phần cần giám sát, các khía cạnh của thành phần cần kiểm tra và hành động nào cần thực hiện trong trường hợp không thành công.

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

apigee-monit sẽ 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 đang được kiểm tra. Chiến lược phát hành đĩa đơn 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í mà thành phần đó kiểm tra 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 cấu hình duy nhất mà những tệp 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` bước kiểm tra: (Các) cổng được chỉ định đang mở và chấp nhận các yêu cầu Hỗ trợ(các) giao thức đã chỉ định Trạng thái của phản hồi Ngoài ra, đối với các thành phần này `apigee-monit`: Yêu cầu nhiều lỗi trong một số chu kỳ nhất định trước khi hành động Thiết lập một đường dẫn yêu cầu tuỳ chỉnh
Trình xử lý thư	`/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 cạnh OpenLDAP Postgres Qpid Người giữ vườn thú	`/opt/apigee/data/apigee-monit/monit.conf`	`apigee-monit` bước kiểm tra: Dịch vụ đang chạy

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

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 trình bày cấu hình mặc định của Giao diện người dùng cổ điển (edge-ui) thành phần:

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ổ điển, không áp dụng cho 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 của mọi ứng dụng Apigee Edge cho thành phần Đám mây riêng tư. Bạn có thể tuy nhiên, hãy thêm các cấu hình thành phần riêng của bạn cho các dịch vụ bên ngoài, chẳng hạn như điểm cuối đích hoặc dịch vụ httpd. Để biết thêm thông tin, hãy xem Cấu hình thành phần không phải API.

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

Dừng và bắt đầu giám sát một thành phần
Dừng, bắt đầu và tắt apigee-monit

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 Private Cloud.

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 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:

Cài đặt apigee-monit bằng lệnh sau:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit install

Định cấu hình apigee-monit bằng lệnh sau:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit configure

Khởi động apigee-monit bằng lệnh sau:

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

Lặp lại quy trình này trên mỗi 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 gì, apigee-monit sẽ cố khởi động lại dịch vụ đó.

Điều này có thể gây ra sự cố nếu bạn muốn chủ ý 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, thì quy trình bảo trì của bạn có thể bị gián đoạn, có thể khiến nó không hoạt động.

Các phần sau đây cho thấy các tuỳ chọn để ngừng theo dõi các thành phần.

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

Để dừng một thành phần và huỷ 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:

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)

Lưu ý rằng "tất cả" không phải là lựa chọn hợp lệ cho stop-component. Bạn có thể dừng và huỷ giám sát chỉ 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 theo dõi, hãy thực thi lệnh sau:

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

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

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

Huỷ theo dõi một thành phần (nhưng đừng dừng lại)

Để huỷ giám sát một thành phần (nhưng không dừng lại), 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:

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 theo dõi 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

Huỷ giám sát tất cả các thành phần (nhưng đừng dừng chúng)

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

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

Để tiếp tục giám sát 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ả thành phần và ngừng giám sát chúng

Để dừng tất 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 theo dõi, 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 Dừng, bắt đầu và tắt apigee-monit.

Dừng, bắt đầu và tắt apigee-monit

Giống như với bất kỳ dịch vụ nào, bạn có thể dừng và bắt đầu apigee-monit bằng apigee-service . Ngoài ra, apigee-monit hỗ trợ lệnh unmonitor để bạn có thể tạm thời ngừng giám sát các thành phần.

Dừng apigee-monit

LƯU ÝNếu bạn sử dụng cron để xem apigee-monit, bạn phải tắt tiện ích đó trước khi dừng apigee-monit, như mô tả trong Giám sát apigee-monit.

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

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

Bắt đầu apigee-monit

Để khởi động 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 việc giám sát tất cả thành phần trên nút bằng cách dù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 ứng dụng này khỏi nút, như được 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:

conf_monit_httpd_port

httpd

apigee-monit

httpd

conf_monit_httpd_allow

httpd

apigee-monit

httpd

Để yêu cầu bao gồm tên người dùng và mật khẩu, hãy sử 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 quy tắc ràng buộc. Không nên chèn các dòng mới thực tế hoặc ký tự trả lại vị trí đầu dòng vào giá trị.

conf_monit_monit_datadir

conf_monit_monit_delay_time

apigee-monit

conf_monit_monit_logdir

apigee-monit

conf_monit_monit_retry_time

apigee-monit

conf_monit_monit_rundir

apigee-monit

Cách tuỳ chỉnh các chế độ cài đặt điều khiển mặc định cho apigee-monit:

Chỉnh sửa tệp sau:
```
/opt/apigee/customer/application/monit.properties
```
Nếu tệp không tồn tại, hãy tạo tệp và đặt chủ sở hữu thành "api" người dùng:
```
chown apigee:apigee /opt/apigee/customer/application/monit.properties
```
Lưu ý rằng nếu tệp đã tồn tại, có thể có thêm thuộc tính cấu hình được xác định ngoài những gì đượ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 với những loại được liệt kê ở trên.
Đặt hoặc thay thế giá trị thuộc tính bằng các 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
```
Lưu các thay đổi vào tệp monit.properties.
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 Truy cập vào các tệp nhật ký của apigee-monit.
Lặp lại quy trình này cho từng nút trong cụm của bạn.

Xin lưu ý rằng chức năng này chỉ dành cho các thành phần không phải Edge. Bạn không thể tuỳ chỉnh các 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ả các sự kiện, lần khởi động lại, thay đổi về cấu hình và cảnh báo trong 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 bảng điều khiển apigee-monit cài đặt.

Các mục nhập của 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 nhập 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 để cung cấp cho bạn thông tin trạng thái tổng hợp về 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 trong số này đượ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 một bản tóm tắt tổng hợp về số lượng thành phần đã thiết lập, ngừng hoạt động, hiện đang được khởi chạy hoặc hiện không được giám sát trên một nút. Chiến lược phát hành đĩa đơn ví dụ sau đây sẽ 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 một AIO (đầy đủ) cấu hình:

/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, 11 trong số 12 dịch vụ được apigee-monit báo cáo là đang hoạt động. Một dịch vụ chưa hiện đang được theo dõi.

Bạn có thể gặp lỗi Connection refused trong lần đầu thực thi lệnh Lệnh report. Trong trường hợp này, hãy chờ đến khi conf_monit_monit_delay_time rồi thử lại.

tóm tắt

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 đó. Nội dung sau đây ví dụ sẽ 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 một AIO (đầy đủ) cấu hình:

/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 thực thi lệnh gọi đầu tiên summary, hãy thử đợi khoảng thời gian 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 rằng 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 phát lệnh này định kỳ trên mỗi nút đang chạy apigee-monit. Bạn có thể thực hiện việc này bằng một tiện ích như cron. Tiện ích này sẽ thực thi các việc cần làm đã lên lịch vào lúc khoảng thời gian xác định trước.

Cách sử dụng cron để giám sát apigee-monit:

Thêm tính năng hỗ trợ cron bằng cách sao chép 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/
```
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 hiện công việc đó. Ví dụ sau đây trình bày giá trị mặc định giá trị:
```
# 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 đó năm trường đầu tiên xác định thời điểm 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 * * * *, thời gian này sẽ hướng dẫn cron để kiểm tra quy trình apigee-monit 2 phút một lần.

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

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 công việc cron được xác định trong tệp này. (Các dòng được nhận xét không count.)

Nếu muốn ngừng hoặc tạm thời tắt apigee-monit, bạn phải tắt 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 làm theo 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 mã này nếu bạn 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 công việc bằng cách thêm dấu "#" vào đầu dòng; ví dụ:
```
# 10 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit
```