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.01

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

Bật JMX

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

Mỗi thành phần đều hỗ trợ JMX trên một cổng khác nhau. Bảng sau 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ộ xử lý thư	1101	/opt/apigee/edge-mesage-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ý, hãy mở /opt/apigee/edge-management-server/bin/start trong một trình chỉnh sửa. Bạn sẽ thấy dòng sau được 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 nội dung 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ý. Đặt số cổng cho mỗi thành phần như 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. Ví dụ về cách khởi động lại Máy chủ quản lý:

> /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 của Máy chủ quản lý, Trình xử lý thông báo, Qpid và Postgres đều sử dụng JMX. JMX được bật theo mặc định và quyền 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 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 là edge-management-server, edge-message-processor, Edge-qpid-server hoặc Edge-postgres-server.
Có các tuỳ chọn sau:
- -u: tên người dùng
- -p: mật khẩu
- -e: y (enable) hoặc n (dsiable)
Tệp cấu hình bao gồm:
- JMX_USERNAME=tên người dùng
- JMX_ENABLED=y/n
- JMX_passwords=password (nếu chưa đặt hoặc không chuyể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 tên người dùng và mật khẩu.

Để tắt tính năng xác thực JMX vào lúc khác, 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 thông tin xử lý và kiểm tra tình trạng hệ thống

Sử dụng JConsole (một công cụ tương thích với JMX) để quản lý và giám sát quá trình kiểm tra tình trạng và xử lý số liệu thống kê. 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ủ bất kỳ) hiển thị và hiển thị các số liệu đó trong giao diện đồ hoạ. Để biết thêm thông tin về cách sử dụng JConsole, vui lòng xem http://docs.oracle.com/javase/8/docs/technotes/guides/management/jconsole.html.

Sử dụng JConsole và URL dịch vụ sau đây để 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ê JMX chung:

Tiếng MB của JMX	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ị theo bốn giá trị: đã cam kết, bắt đầu, tối đa và đã sử dụng.

Sử dụng các bước kiểm tra API ứng dụng Edge

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

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

Trong đó, <host> là địa chỉ IP của Máy chủ quản lý.

Lệnh gọi này trả về "true" và "false". Nếu đúng, điều đó có nghĩa là nút đã hoạt động và dịch vụ Java đ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ác yêu cầu về cổng 8080.

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 Edge-management-server status
Nếu dịch vụ không chạy, hãy khởi động dịch vụ:
/opt/apigee/apigee-service/bin/apigee-service Edge-management-server start

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

Máy chủ quản lý đóng vai trò quan trọng trong việc tập hợp tất cả các kiện hàng khác lại với nhau trong mỗi lần lắp đặt tại cơ sở. Bạn có thể kiểm tra trạng thái 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ị trạng thái "đã triển khai" cho tất cả lệnh gọi. Nếu những trường hợp này không thành công, hãy làm như sau:

Kiểm tra nhật ký Máy chủ quản lý (tại opt/apigee/var/log/edge-management-server) để xem có lỗi nào không.
Thực hiện lệnh gọi với Máy chủ quản lý để kiểm tra xem máy chủ có đang hoạt động đúng cách hay không.
Hãy gỡ 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 Edge-management-server khởi động lại

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 lệnh 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ề "true" và "false". Nếu đúng, điều đó có nghĩa là nút đã hoạt động và dịch vụ Bộ định tuyến đ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ác yêu cầu về cổng 8081.