Mengaktifkan G1GC pada Prosesor Pesan

Anda melihat dokumentasi Apigee Edge.
Buka dokumentasi Apigee X. info

Dokumen ini menjelaskan cara mengaktifkan Garbage First Garbage Collector (G1GC) di Message Processor Apigee Edge.

Message Processor Apigee Edge berjalan di 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, Anda mungkin ingin mengubah jenis Garbage Collector yang digunakan di Message Processor.

G1GC adalah garbage collector generasi gaya server dengan jeda rendah untuk Java HotSpot VM yang meningkatkan performa Message Processor secara keseluruhan. Biasanya, G1GC 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 besar dari 3 GB).

Sebaiknya tetapkan parameter JVM lain UseStringDeduplication bersama dengan G1GC. Parameter ini mengoptimalkan penggunaan memori heap Java dengan membuat nilai String duplikat atau identik berbagi array karakter yang sama.

Sebelum memulai

Mengaktifkan G1GC di Message Processor

Bagian ini menjelaskan cara mengaktifkan G1GC di Message Processor Edge. G1GC dapat diaktifkan melalui properti useG1GC pada komponen Message Processor. Secara default, properti ini ditetapkan ke false di Message Processor. Untuk mengonfigurasi properti apa pun di Message Processor, gunakan token sesuai dengan sintaksis yang dijelaskan dalam Cara mengonfigurasi Edge.

Untuk mengaktifkan G1GC di Message Processor, lakukan langkah-langkah berikut:

  1. Temukan token untuk properti useG1GC
  2. Aktifkan G1GC di Message Processor

Temukan token untuk properti useG1GC

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

  1. Telusuri properti useG1GC di direktori sumber Message Processor /opt/apigee/edge-message-processor/source menggunakan perintah berikut: 
    grep -ri "useG1GC" /opt/apigee/edge-message-processor/source
  2. Output perintah ini menampilkan 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 Message Processor. Jadi, token untuk properti useG1GC adalah sebagai berikut: 

    conf_system_useG1GC

Mengaktifkan G1GC di Message Processor

Langkah-langkah berikut menjelaskan cara mengaktifkan G1GC di Message Processor Apigee:

  1. Buka file /opt/apigee/customer/application/message-processor.properties di mesin Message Processor di editor. Jika file belum ada, maka 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 Message Processor menggunakan perintah berikut: 
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
  6. Jika Anda memiliki lebih dari satu Message Processor, ulangi langkah-langkah ini di semua Message Processor.

Memverifikasi Konfigurasi G1GC di Message Processor

Bagian ini menjelaskan cara memverifikasi bahwa konfigurasi G1GC telah berhasil diubah di Message Processor.

Meskipun Anda menggunakan token conf_system_useG1GC untuk mengaktifkan G1GC di Message Processor, Anda perlu memverifikasi bahwa properti useG1GC sebenarnya telah ditetapkan dengan nilai baru sebagai berikut:

  1. Telusuri properti useG1GC di direktori /opt/apigee/edge-message-processor/conf dan periksa apakah properti tersebut telah ditetapkan dengan nilai baru. Contoh: 
    grep -ri "useG1GC" /opt/apigee/edge-message-processor/conf
  2. Jika G1GC berhasil diaktifkan di Message Processor, perintah sebelumnya akan menampilkan nilai baru dalam file system.properties.

    Contoh hasil dari perintah sebelumnya, setelah Anda mengaktifkan G1GC di Message Processor, adalah sebagai berikut: 

    /opt/apigee/edge-message-processor/conf/system.properties:useG1GC=true

    Dalam contoh output, perhatikan bahwa properti useG1GC telah ditetapkan dengan nilai baru true di system.properties. Hal ini menunjukkan bahwa G1GC berhasil diaktifkan di Message Processor.

  3. Jika Anda masih melihat nilai lama untuk properti useG1GC, pastikan Anda telah mengikuti semua langkah yang diuraikan dalam Mengaktifkan G1GC di Message Processor dengan benar. Jika Anda melewatkan langkah apa pun, ulangi semua langkah dengan benar.
  4. Jika Anda masih tidak dapat mengaktifkan G1GC, hubungi Dukungan Apigee Edge.

Apa selanjutnya?

Mengaktifkan Penghapusan Duplikat String di Message Processor