Mengaktifkan G1GC pada Prosesor Pesan

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 UseStringDeduplicationbersama dengan G1GC. Parameter ini mengoptimalkan penggunaan memori heap Java dengan membuat nilai String duplikat atau yang identik memiliki array karakter yang sama.

Sebelum memulai

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:

  1. Menemukan token untuk properti useG1GC
  2. Mengaktifkan G1GC di Pemroses Pesan

Menemukan token untuk properti useG1GC

Langkah-langkah berikut menjelaskan cara menemukan token untuk properti useG1GC:

  1. 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
    
  2. 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 properti useG1GC adalah sebagai berikut:

    conf_system_useG1GC
    

Mengaktifkan G1GC di Pemroses Pesan

Langkah-langkah berikut menjelaskan cara mengaktifkan G1GC di Pemroses Pesan Apigee:

  1. 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
    
  2. Tambahkan baris berikut ke file ini:
    conf_system_useG1GC=true
    
  3. Simpan perubahan.
  4. Pastikan file properti ini dimiliki oleh pengguna apigee. Contoh:
    chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
    
  5. Mulai ulang Pemroses Pesan menggunakan perintah berikut:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
    
  6. 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:

  1. 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
    
  2. 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 baru true di system.properties. Hal ini menunjukkan bahwa G1GC berhasil diaktifkan di Prosesor Pesan.

  3. 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.
  4. Jika Anda masih tidak dapat mengaktifkan G1GC, hubungi Dukungan Apigee Edge.

Langkah berikutnya?

Mengaktifkan Penghapusan Duplikat String di Pemroses Pesan