Anda sedang melihat dokumentasi Apigee Edge.
Buka
dokumentasi Apigee X. info
Dokumen ini menjelaskan cara mengaktifkan Garbage First Garbage Collector (G1GC) di Prosesor Pesan Apigee Edge.
Message Processor Apigee Edge berjalan pada Java Virtual Machine (JVM) dan menggunakan Garbage Collector default—serial atau paralel, bergantung pada konfigurasi hardware dan sistem operasi. Dalam keadaan tertentu dan berdasarkan kebutuhan, Anda dapat mengubah jenis Pemilah Sampah yang digunakan pada Pemroses Pesan.
G1GC adalah pembersih sampah memori generasi bergaya server dengan jeda rendah untuk VM Java HotSpot yang meningkatkan performa keseluruhan Pemroses Pesan. Biasanya, solusi ini dirancang untuk aplikasi dengan set data berukuran sedang hingga besar yang waktu responsnya lebih penting daripada throughput keseluruhan. Misalnya: Anda dapat mempertimbangkan untuk menggunakan G1GC jika ukuran heap besar (lebih dari 3 GB).
Sebaiknya setel parameter JVM lain UseStringDeduplication
bersama
dengan G1GC. Parameter ini mengoptimalkan penggunaan memori heap Java dengan membuat nilai String duplikat atau yang identik
memiliki array karakter yang sama.
Sebelum memulai
- Jika Anda tidak terbiasa dengan pembersihan sampah memori dan berbagai jenis Pengumpul Sampah di Java, baca Dasar-Dasar Pembersihan Sampah Java.
- Jika Anda belum terbiasa dengan G1GC, baca Memulai dengan Pengumpul Sampah G1.
- Jika Anda tidak terbiasa mengonfigurasi properti untuk Edge di Private Cloud, baca Cara mengonfigurasi Edge.
Mengaktifkan G1GC pada Pemroses Pesan
Bagian ini menjelaskan cara mengaktifkan G1GC di Prosesor Pesan Edge. G1GC dapat diaktifkan melalui properti useG1GC
pada komponen Pemroses Pesan. Secara default, properti ini ditetapkan ke false
di Pemroses Pesan. Untuk mengonfigurasi properti apa pun pada Pemroses Pesan, gunakan token sesuai dengan sintaksis yang dijelaskan dalam Cara mengonfigurasi Edge.
Untuk mengaktifkan G1GC di Pemroses Pesan, lakukan langkah-langkah berikut:
Menemukan token untuk properti useG1GC
Langkah-langkah berikut menjelaskan cara menemukan token untuk properti useG1GC:
- Telusuri properti
useG1GC
di direktori sumber Pemroses Pesan/opt/apigee/edge-message-processor/source
menggunakan perintah berikut:grep -ri "useG1GC" /opt/apigee/edge-message-processor/source
-
Output perintah ini menunjukkan token untuk properti Message Processor
useG1GC
sebagai berikut:/opt/apigee/edge-message-processor/source/conf/system.properties:useG1GC={T}conf_system_useG1GC{/T}
Dengan string di antara tag
{T}{/T}
adalah nama token yang dapat Anda tetapkan dalam file.properties
Pemroses Pesan. Dengan demikian, token untuk propertiuseG1GC
adalah sebagai berikut:conf_system_useG1GC
Mengaktifkan G1GC di Pemroses Pesan
Langkah-langkah berikut menjelaskan cara mengaktifkan G1GC di Pemroses Pesan Apigee:
-
Buka file
/opt/apigee/customer/application/message-processor.properties
di mesin Message Processor di editor. Jika belum ada, buat file tersebut. Contoh:vi /opt/apigee/customer/application/message-processor.properties
-
Tambahkan baris berikut ke file ini:
conf_system_useG1GC=true
- Simpan perubahan.
-
Pastikan file properti ini dimiliki oleh pengguna
apigee
. Contoh:chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
-
Mulai ulang Pemroses Pesan menggunakan perintah berikut:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
- Jika Anda memiliki lebih dari satu Pemroses Pesan, ulangi langkah-langkah ini pada semua Pemroses Pesan.
Memverifikasi Konfigurasi G1GC pada Pemroses Pesan
Bagian ini menjelaskan cara memverifikasi bahwa konfigurasi G1GC telah berhasil diubah di Pemroses Pesan.
Meskipun Anda menggunakan token conf_system_useG1GC
untuk mengaktifkan G1GC pada Pemroses Pesan, Anda harus memverifikasi bahwa useG1GC
properti sebenarnya telah ditetapkan dengan nilai baru seperti berikut:
-
Telusuri properti
useG1GC
dalam direktori/opt/apigee/edge-message-processor/conf
dan periksa apakah properti telah ditetapkan dengan nilai baru. Contoh:grep -ri "useG1GC" /opt/apigee/edge-message-processor/conf
-
Jika G1GC berhasil diaktifkan di Pemroses Pesan, perintah sebelumnya akan menampilkan nilai baru dalam file
system.properties
.Contoh hasil dari perintah sebelumnya, setelah Anda mengaktifkan G1GC di Pemroses Pesan, adalah sebagai berikut:
/opt/apigee/edge-message-processor/conf/system.properties:useG1GC=true
Pada contoh output, perhatikan bahwa properti
useG1GC
telah ditetapkan dengan nilai barutrue
disystem.properties
. Hal ini menunjukkan bahwa G1GC berhasil diaktifkan di Prosesor Pesan. -
Jika Anda masih melihat nilai lama untuk properti
useG1GC
, pastikan bahwa Anda telah mengikuti semua langkah yang diuraikan dalam Mengaktifkan G1GC di Pemroses Pesan dengan benar. Jika Anda melewatkan satu langkah, ulangi lagi semua langkah tersebut dengan benar. - Jika Anda masih tidak dapat mengaktifkan G1GC, hubungi Dukungan Apigee Edge.