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

Cách theo dõi

Edge for Private Cloud phiên bản 4.17.09

Tài liệu này mô tả các kỹ thuật giám sát của các thành phần được hỗ trợ tại cơ sở hạ tầng riêng việc triển khai Apigee Edge.

Bật JMX

JMX được bật theo mặc định cho Cassandra và bị tắt theo mặc định cho tất cả các Edge khác thành phần. Do đó, bạn phải bật JMX riêng lẻ cho từng thành phần.

Mỗi thành phần hỗ trợ JMX trên một cổng khác. Bảng sau đây liệt kê cổng JMX và tệp mà bạn sửa đổi để bật JMX trên cổng đó:

Thành phần	Cổng JMX	Tệp
Máy chủ quản lý	1099	/opt/apigee/edge-management-server/bin/start
Bộ định tuyến	1100	/opt/apigee/edge-router/bin/start
Trình xử lý tin nhắn	1101	/opt/apigee/edge-message-processor/bin/start
Qpid	1102	/opt/apigee/edge-qpid-server/bin/start
Postgres	1103	/opt/apigee/edge-postgres-server/bin/start

Ví dụ: để bật JMX trên Máy chủ quản lý, mở /opt/apigee/edge-management-server/bin/start trong trình chỉnh sửa. Bạn sẽ thấy dòng sau được sử dụng để khởi động Máy chủ quản lý:

exec $JAVA -classpath "$classpath" -Xms$min_mem -Xmx$max_mem $xx_opts -Djava.security.auth.login.config=$conf_path/jaas.config 
-Dinstallation.dir=$install_dir $sys_props -Dconf.dir=$conf_path 
-Ddata.dir=$data_dir $* $debug_options com.apigee.kernel.MicroKernel

Chỉnh sửa dòng này để thêm như sau:

-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=1099 
-Dcom.sun.management.jmxremote.local.only=false  
-Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false

Lưu ý rằng dòng này chỉ định số cổng JMX là 1099 cho Máy chủ quản lý. Thiết lập số cổng cho mỗi thành phần như được xác định trong bảng trên. Ví dụ:

exec $JAVA -classpath "$classpath" -Xms$min_mem -Xmx$max_mem $xx_opts 
-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=1099 
-Dcom.sun.management.jmxremote.local.only=false  
-Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false 
-Djava.security.auth.login.config=$conf_path/jaas.config 
-Dinstallation.dir=$install_dir $sys_props -Dconf.dir=$conf_path -Ddata.dir=$data_dir $* $debug_options com.apigee.kernel.MicroKernel

Lưu tệp rồi khởi động lại thành phần này. Ví dụ: để khởi động lại quy trình Quản lý Máy chủ:

> /opt/apigee/apigee-service/bin/ apigee-service edge-management-server restart

Bật tính năng xác thực JMX và đặt mật khẩu JMX

Quy trình giám sát đối với Management Server, Message Processor, Qpid và Postgres sử dụng JMX. JMX được bật theo mặc định và truy cập JMX từ xa không yêu cầu mật khẩu.

Để bật tính năng xác thực JMX, mỗi thành phần sẽ có một thao tác change_jmx_auth mà bạn sử dụng để bật/tắt tính năng xác thực và đặt thông tin xác thực JMX.

Để bật tính năng xác thực JMX, hãy sử dụng lệnh sau:

>  /opt/apigee/apigee-service/bin/apigee-service comp change_jmx_auth optionsOrConfigFile

trong đó:

comp có thể là edge-management-server (máy chủ quản lý cạnh), Edge-message-processor, cạnh-qpid-server, hoặc edge-postgres-server.
Các tuỳ chọn bao gồm:
- -u: tên người dùng
- -p: mật khẩu
- -e: y (bật) hoặc n (có thể truy cập)
Tệp cấu hình bao gồm:
- JMX_USERNAME=tên người dùng
- JMX_ENABLED=y/n
- JMX_PASSWORD=password (nếu không được đặt hoặc không được truyền bằng -p, bạn sẽ được nhắc)

Ví dụ: để sử dụng các tuỳ chọn trên dòng lệnh:

> /opt/apigee/apigee-service/bin/apigee-service edge-management-server change_jmx_auth -u foo -p bar -e y

Nếu bạn có tệp cấu hình:

> /opt/apigee/apigee-service/bin/apigee-service edge-management-server change_jmx_auth -f configFile

Nếu bạn đang chạy Edge trên nhiều nút, hãy chạy lệnh này trên tất cả các nút, chỉ định cùng một nút tên người dùng và mật khẩu.

Để tắt tính năng xác thực JMX sau này, hãy sử dụng lệnh:

> /opt/apigee/apigee-service/bin/apigee-service edge-management-server change_jmx_auth -e n

Máy chủ quản lý

Sử dụng JConsole để giám sát việc kiểm tra tình trạng hệ thống và xử lý thông tin

Sử dụng JConsole (một công cụ tuân thủ JMX) để quản lý và giám sát quy trình kiểm tra tình trạng cũng như số liệu thống kê về quy trình. Khi sử dụng JConsole, bạn có thể sử dụng số liệu thống kê JMX do Máy chủ quản lý (hoặc bất kỳ máy chủ nào) hiển thị và hiển thị chúng trong giao diện đồ hoạ. Để biết thêm thông tin về việc sử dụng JConsole, hãy xem http://docs.oracle.com/javase/8/docs/technotes/guides/management/jconsole.html.

Sử dụng JConsole và URL dịch vụ sau để theo dõi các thuộc tính JMX (MBeans) được cung cấp thông qua JMX.

service:jmx:rmi:///jndi/rmi://<ip address>:<port>/jmxrmi

trong đó <ip address> là địa chỉ IP của Máy chủ quản lý (hoặc máy chủ tương ứng). Theo mặc định, cổng là 1099 cho Máy chủ quản lý.

Bảng sau đây trình bày số liệu thống kê chung về JMX:

JMX MBeans	Thuộc tính JMX
Bộ nhớ	HeapMemoryUsage
	NonHeapMemoryUsage
	Cách sử dụng
Lưu ý: Các giá trị thuộc tính sẽ hiển thị trong 4 giá trị: cam kết, init, max và used.

Sử dụng API ứng dụng Edge séc

Bạn có thể thực hiện kiểm tra API trên Máy chủ quản lý (hoặc bất kỳ máy chủ nào) bằng cách gọi lệnh sau Lệnh CURL:

curl http://<host>:8080/v1/servers/self/up -H "Accept: application/json"

Trong đó, <host> là địa chỉ IP của Máy chủ quản lý. Bạn có thể chỉ định loại Chấp nhận là application/json hoặc application/xml.

Lệnh gọi này trả về giá trị "true" và "false". Nếu đúng, điều đó có nghĩa là nút đang hoạt động và dịch vụ Java đang đang chạy.

Nếu bạn không nhận được phản hồi HTTP 200 (OK), thì Edge không thể phản hồi cổng 8080 yêu cầu.

Khắc phục sự cố

Đăng nhập vào máy chủ và chạy lệnh sau:
/opt/apigee/apigee-service/bin/apigee-service trạng thái máy chủ quản lý cạnh
Nếu dịch vụ không chạy, hãy khởi động dịch vụ:
/opt/apigee/apigee-service/bin/apigee-service bắt đầu máy chủ quản lý cạnh

Sử dụng Edge Ứng dụng – Kiểm tra người dùng, tổ chức và triển khai

Máy chủ quản lý đóng vai trò quan trọng trong việc giữ tất cả các lô đất khác với nhau trong mỗi cơ sở hạ tầng cài đặt. Bạn có thể kiểm tra trạng thái của người dùng, tổ chức và triển khai trên máy chủ quản lý bằng cách ra các lệnh sau:

curl -u userEmail:password http://localhost:8080/v1/users
curl -u userEmail:password http://localhost:8080/v1/organizations
curl -u userEmail:password http://localhost:8080/v1/organizations/orgname/deployments

Hệ thống sẽ hiển thị "đã triển khai" trạng thái của tất cả cuộc gọi. Nếu những thao tác này không thành công, hãy thực hiện sau:

Kiểm tra nhật ký Máy chủ quản lý (tại opt/apigee/var/log/edge-management-server) phát hiện bất kỳ lỗi nào.
Thực hiện lệnh gọi với Management Server (Máy chủ quản lý) để kiểm tra xem máy chủ đó có đang hoạt động hay không đúng cách.
Hãy xoá máy chủ khỏi ELB rồi khởi động lại Máy chủ quản lý.
/opt/apigee/apigee-service/bin/apigee-service khởi động lại máy chủ quản lý cạnh

Bộ định tuyến

Bạn có thể thực hiện kiểm tra API trên Bộ định tuyến (hoặc bất kỳ máy chủ nào) bằng cách gọi CURL sau :

curl http://<host>:8081/v1/servers/self/up

Trong đó, máy chủ lưu trữ là địa chỉ IP của Bộ định tuyến.

Lệnh gọi này trả về giá trị "true" và "false". Nếu đúng, điều đó có nghĩa là nút đang hoạt động và Bộ định tuyến dịch vụ đang chạy.

Nếu bạn không nhận được phản hồi HTTP 200 (OK), thì Edge không thể phản hồi cổng 8081 yêu cầu.