Mengonfigurasi ukuran memori heap pada Pemroses Pesan

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

Message Processor Apigee Edge adalah komponen berbasis Java dan menggunakan ukuran memori heap default sebesar 512 MB. Namun, ukuran memori heap default mungkin tidak cukup untuk semua kasus penggunaan di Apigee Edge. Anda mungkin perlu menyesuaikan ukuran memori heap untuk Prosesor Pesan, bergantung pada traffic dan persyaratan pemrosesan Anda, atau untuk mengatasi masalah terkait memori.

Ukuran memori heap aplikasi Java dikontrol melalui parameter command line Java -Xms (ukuran heap minimum) dan -Xmx (ukuran heap maksimum). Pada Apigee Edge Message Processors, hal ini dikontrol melalui properti bin_setenv_min_mem dan bin_setenv_max_mem. Anda dapat membaca properti ini lebih lanjut di Mengubah setelan memori Java.

Dokumen ini menjelaskan cara mengonfigurasi ukuran memori heap pada Prosesor Pesan Apigee Edge.

Sebelum memulai

Mengubah ukuran memori Heap pada Prosesor Pesan

Bagian ini menjelaskan cara mengubah ukuran memori heap pada Prosesor Pesan. Memori heap minimum dan maksimum dapat dikonfigurasi melalui properti bin_setenv_min_mem dan bin_setenv_max_mem pada komponen Message Processor.

Untuk mengubah ukuran memori heap pada Prosesor Pesan, lakukan langkah-langkah berikut:

  1. Buka file /opt/apigee/customer/application/message-processor.properties di mesin Message Processor di editor. Jika file tersebut belum ada, buat file tersebut. Contoh:
    vi /opt/apigee/customer/application/message-processor.properties
    
  2. Tambahkan baris berikut ke file ini:
    bin_setenv_min_mem=minimum_heap_in_megabytes
    bin_setenv_max_mem=maximum_heap_in_megabytes
    

    Misalnya, Jika Anda ingin mengubah heap minimum dan maksimum pada Prosesor Message menjadi 1 GB dan 2 GB, tambahkan baris berikut ke file ini:

    bin_setenv_min_mem=1024m
    bin_setenv_max_mem=2048m
    
  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 ukuran memori Heap pada Message Processors

Bagian ini menjelaskan cara memverifikasi apakah perubahan memori heap telah berhasil diubah di Prosesor Pesan.

Meskipun Anda menggunakan properti bin_setenv_min_mem dan bin_setenv_max_mem untuk mengubah ukuran memori heap pada Message Processor, Anda harus memverifikasi bahwa parameter command line Java yang sebenarnya -Xms dan -Xmx telah disetel dengan nilai baru sebagai berikut:

  1. Telusuri untuk melihat apakah parameter command line -Xms dan -Xmx telah ditetapkan dengan nilai baru untuk Message Processor menggunakan perintah berikut:
    ps -ef | grep message-processor | egrep -o 'Xms[0-9a-z]+|Xmx[0-9a-z]+' | tr '\r' ' '
    
  2. Jika memori heap minimum dan maksimum telah diubah pada Pemroses Pesan, perintah sebelumnya akan menampilkan nilai baru yang tercantum untuk -Xms dan -Xmx.

    Contoh hasil dari perintah sebelumnya, setelah Anda mengubah heap minimum dan maksimum pada Pemroses Pesan, adalah sebagai berikut:

    Xms1024m
    Xmx2048m
    

    Pada contoh output, perhatikan bahwa nilai baru untuk heap minimum dan maksimum telah disetel.

  3. Jika Anda masih melihat nilai lama untuk -Xms dan -Xmx, pastikan Anda telah mengikuti semua langkah yang diuraikan dalam Mengubah ukuran memori heap di Prosesor Pesan dengan benar. Jika Anda melewatkan langkah apa pun, ulangi semua langkah lagi dengan benar.
  4. Jika Anda masih tidak dapat mengubah memori heap, hubungi Dukungan Apigee Edge.

Langkah berikutnya?