Panduan operasi QPID

Edge for Private Cloud versi 4.52.02 dikirimkan dengan Qpid Broker-J 8.0.6. Halaman ini menjelaskan pertimbangan memori dan disk untuk komponen apigee-qpidd Edge untuk Private Cloud (dengan Broker berbasis Java). Bagian di bawah ini berlaku secara khusus untuk kasus penggunaan Qpid Apigee, dan menjelaskan cara menyesuaikan Qpid menggunakan mekanisme konfigurasi Apigee.

Qpid di Apigee

Di Apigee, Qpid digunakan dalam dua alur kerja utama:

  • Analisis
  • Monetisasi

Dalam kedua alur kerja ini, Pemroses Pesan menghasilkan pesan, yang dikumpulkan ke dalam batch dan didorong ke Qpid. Untuk Analytics, pesan dibaca oleh server Qpid; untuk Monetisasi, pesan tersebut dibaca oleh Server Rating (bagian dari server pengelolaan). Setelah dibaca, pesan batch akan tidak dikelompokkan dan ditransfer.

Bagian berikut menjelaskan konfigurasi yang direkomendasikan untuk memori dan disk dengan Qpid. Konfigurasi ini didasarkan pada ukuran pesan tunggal sebesar 2 KB untuk Analytics atau Monetisasi. Dengan ukuran tumpukan default 50, setiap pesan dalam Qpid akan berukuran sekitar 100 kb. Apigee memungkinkan proxy untuk mengubah dan menambahkan informasi tambahan ke pesan (Analytics atau Monetisasi). Dalam kasus yang ekstrem, hal ini dapat mengubah ukuran satu pesan dan keseluruhan pesan dalam batch di Qpid secara signifikan. Meskipun rekomendasi umum terkait memori dan disk pada bagian di bawah ini tetap berlaku bahkan dalam kasus semacam itu, Anda mungkin perlu melakukan penyesuaian tambahan pada Qpid untuk memastikan operasi yang lancar.

Memori

Qpid Broker menggunakan dua jenis memori: memori cadangan dan memori heap. Qpid menyimpan pesan di luar memori heap, dan menggunakan memori heap untuk tugas internalnya sendiri, mengirim pesan langsung ke antrean dan pertukaran, dsb. Dalam sebagian besar situasi, Apigee merekomendasikan agar Anda mempertahankan rasio 3:1 antara memori heap dan heap untuk Broker Qpid.

Pesan di memori off-heap akan tetap berada di disk. Selain itu, jika total penggunaan memori di luar heap melanggar batas tertentu, Qpid akan dikonfigurasi untuk men-overflow pesan ke disk.

Secara default, Apigee menghitung memori heap dan off-heap Qpid Broker berdasarkan memori yang tersedia pada node. Skrip Apigee memiliki batas gabungan sebesar 4 GB untuk memori heap dan off-heap Qpid Broker. Jika ingin mengganti batas ini, Anda dapat menggunakan dua konfigurasi di bawah ini untuk menetapkan nilai sendiri untuk memori heap dan off-heap Qpid.

  • Konfigurasi untuk memori heap: bin_run-qpidd_qpid.run.jvm.max_vm_heap=1024m
  • Konfigurasi untuk memori off-heap: bin_run-qpidd_qpid.run.jvm.max_direct_memory_size=3072m

Lihat Cara mengubah konfigurasi Qpid untuk mengetahui informasi tentang cara mengganti konfigurasi.

Untuk informasi selengkapnya, lihat Referensi Apache Qpid untuk Memori.

Disk

Direktori data Qpid Broker adalah $APIGEE_ROOT/data/apigee-qpidd. Log Qpid Broker disimpan di $APIGEE_ROOT/var/log/apigee-qpidd.

Performa sistem file yang menghosting direktori data merupakan kunci performa Broker secara keseluruhan. Untuk performa terbaik, pilih perangkat yang memiliki latensi rendah dan tidak digunakan oleh aplikasi lain.

Qpid Broker mempertahankan pesannya dalam direktori data. Secara default, Broker akan menerima pesan hingga sistem file yang menghosting direktori data 80% penuh. Anda dapat mengubah nilai minimum ini dengan mengganti konfigurasi yang ditampilkan pada contoh di bawah ini pada setiap node Qpid.

bin_run-qpidd_qpid.store.filesystem.maxUsagePercent=60

Dalam contoh ini, Broker menolak pesan baru saat sistem file yang mendasarinya mencapai 60% penuh.

Cara mengubah konfigurasi Qpid

Untuk mengubah konfigurasi Qpid:

  1. Buat atau edit file berikut:
    $APIGEE_ROOT/customer/application/qpidd.properties
  2. Tambahkan atau hapus atau ubah konfigurasi sesuai kebutuhan. Misalnya, untuk mengubah memori heap maksimum Qpid Broker menjadi 6 GB, tambahkan penggantian konfigurasi berikut dalam file:
    bin_run-qpidd_qpid.run.jvm.max_vm_heap=6144M
  3. Simpan perubahan dan pastikan file dimiliki dan dapat dibaca oleh pengguna apigee:
    chown apigee:apigee $APIGEE_ROOT/customer/application/qpidd.properties
  4. Mulai ulang proses qpidd:
    apigee-service apigee-qpidd restart