Halaman ini diterjemahkan oleh Cloud Translation API.

Cara Memantau

Edge for Private Cloud v4.18.01

Dokumen ini menjelaskan teknik pemantauan komponen yang didukung oleh infrastruktur lokal deployment Apigee Edge.

Mengaktifkan JMX

JMX diaktifkan secara default untuk Cassandra, dan dinonaktifkan secara default untuk semua Edge lainnya komponen. Oleh karena itu, Anda harus mengaktifkan JMX satu per satu untuk setiap komponen.

Setiap komponen mendukung JMX pada port yang berbeda. Tabel berikut ini mencantumkan porta JMX dan file yang Anda ubah untuk mengaktifkan JMX pada porta tersebut:

Komponen	Port JMX	File
Server Pengelolaan	1099	/opt/apigee/edge-management-server/bin/start
Router	1100	/opt/apigee/edge-router/bin/start
Message Processor	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

Misalnya, untuk mengaktifkan JMX pada Server Pengelolaan, buka {i>/opt/apigee/edge-management-server/bin/start<i} di editor. Anda akan melihat baris berikut digunakan untuk memulai Server Pengelolaan:

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

Edit baris ini untuk menambahkan hal berikut:

-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

Perhatikan bahwa baris ini menentukan nomor port JMX sebagai 1099 untuk Server Pengelolaan. Setel nomor porta untuk setiap komponen seperti yang ditentukan dalam tabel di atas. Contoh:

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

Simpan file, lalu mulai ulang komponen. Misalnya, untuk memulai ulang halaman Pengelolaan Server:

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

Mengaktifkan otentikasi JMX dan mengatur sandi JMX

Proses pemantauan untuk Server Pengelolaan, Pemroses Pesan, Qpid, dan Postgres menggunakan JMX. JMX diaktifkan secara default dan akses JMX jarak jauh tidak memerlukan sandi.

Untuk mengaktifkan autentikasi JMX, setiap komponen memiliki tindakan change_jmx_auth yang Anda gunakan untuk mengaktifkan/menonaktifkan otentikasi dan menetapkan kredensial JMX.

Untuk mengaktifkan autentikasi JMX, gunakan perintah berikut:

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

dalam hal ini:

comp adalah server pengelolaan edge, pemroses pesan edge, edge-qpid-server, atau edge-postgres-server.
Opsi yang tersedia:
- -u: nama pengguna
- -p: sandi
- -e: y (aktifkan) atau n (dapat ditentukan)
File konfigurasi mencakup:
- JMX_USERNAME=nama pengguna
- JMX_ENABLED=y/n
- JMX_PASSWORD=password (jika tidak ditetapkan atau tidak diteruskan dengan -p, Anda akan diminta)

Misalnya, untuk menggunakan opsi di command line:

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

Jika Anda memiliki file konfigurasi:

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

Jika Anda menjalankan Edge pada beberapa node, jalankan perintah ini pada semua node, dengan menentukan nama pengguna dan {i>password<i}.

Untuk menonaktifkan autentikasi JMX di lain waktu, gunakan perintah:

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

Server Pengelolaan

Menggunakan JConsole untuk memantau health check sistem dan memproses informasi

Gunakan JConsole (alat yang mematuhi JMX) untuk mengelola dan memantau health check dan memproses statistik. Dengan menggunakan JConsole, Anda dapat menggunakan statistik JMX yang diekspos oleh Server Pengelolaan (atau server mana pun) dan menampilkannya dalam antarmuka grafis. Untuk informasi selengkapnya tentang penggunaan JConsole, lihat http://docs.oracle.com/javase/8/docs/technotes/guides/management/jconsole.html.

Gunakan JConsole dan URL layanan berikut untuk memantau atribut JMX (MBean) ditawarkan melalui JMX.

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

dengan <ip address> adalah alamat IP Server Pengelolaan (atau server masing-masing). Secara default, port-nya adalah 1099 untuk Server Pengelolaan.

Tabel berikut menunjukkan statistik JMX generik:

JMX MBean	Atribut JMX
Memori	HeapMemoryUsage
	NonHeapMemoryUsage
	Penggunaan
Catatan: Nilai atribut akan ditampilkan dalam empat nilai: commit, init, max, dan used.

Menggunakan Edge Application API pemeriksaan

Anda dapat melakukan pemeriksaan API pada Server Pengelolaan (atau server mana pun) dengan memanggil metode Perintah CURL:

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

Dengan demikian, <host> adalah alamat IP Server Pengelolaan. Anda dapat menentukan jenis Accept sebagai application/json atau application/xml.

Panggilan ini akan menampilkan nilai "true" dan "false". Jika benar, berarti node aktif dan layanan Java sedang berjalan.

Jika Anda tidak menerima respons HTTP 200 (OK), Edge tidak dapat merespons port 8080 permintaan.

Pemecahan masalah

Login ke server dan jalankan perintah berikut:
/opt/apigee/apigee-service/bin/apigee-service status server pengelolaan edge
Jika layanan tidak berjalan, mulai layanan:
/opt/apigee/apigee-service/bin/apigee-service start server pengelolaan edge

Menggunakan Edge Aplikasi – Pemeriksaan pengguna, organisasi, dan deployment

Server Pengelolaan memainkan peran penting dalam menggabungkan semua paket lainnya di setiap lokasi lokal penginstalan. Anda dapat memeriksa status pengguna, organisasi, dan deployment di server pengelolaan dengan menjalankan perintah berikut:

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

Sistem akan menampilkan "di-deploy" untuk semua panggilan. Jika tidak berhasil, lakukan berikut ini:

Periksa log Server Pengelolaan (di opt/apigee/var/log/edge-management-server) untuk setiap error.
Melakukan panggilan ke Server Pengelolaan untuk memeriksa apakah server berfungsi mereka dapat terus berjalan dengan baik.
Hapus server dari ELB, lalu mulai ulang Server Pengelolaan.
/opt/apigee/apigee-service/bin/apigee-service mulai ulang server pengelolaan edge

Router

Anda dapat melakukan pemeriksaan API pada Router (atau server mana pun) dengan memanggil CURL berikut berikut:

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

Di mana, {i>host<i} adalah alamat IP {i>Router<i}.

Panggilan ini akan menampilkan nilai "true" dan "false". Jika benar, berarti node aktif dan Router layanan berjalan.

Jika Anda tidak menerima respons HTTP 200 (OK), Edge tidak dapat merespons port 8081 permintaan.