Panduan operasi QPID

Edge untuk Private Cloud versi 4.52.01 dikirimkan dengan Qpid Broker-J 8.0.6. Halaman ini menjelaskan pertimbangan memori dan disk untuk komponen apigee-qpidd Edge for Private Cloud (dengan Broker berbasis Java). Bagian di bawah ini berlaku 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

Di kedua alur kerja ini, Pemroses Pesan menghasilkan pesan, yang dikumpulkan menjadi beberapa batch dan dikirim ke Qpid. Untuk Analytics, pesan dibaca oleh server Qpid; untuk Monetisasi, pesan dibaca oleh Server Rating (bagian dari server pengelolaan). Setelah dibaca, pesan yang dikelompokkan akan dibatalkan dan diserap.

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

Memori

Qpid Broker menggunakan dua jenis memori: memori off-heap dan memori heap. Qpid menyimpan pesan dalam memori di luar heap, dan menggunakan memori heap untuk tugas internalnya, pesan langsung ke antrean dan pertukaran, dll. Dalam sebagian besar situasi, Apigee menyarankan agar Anda mempertahankan rasio 3:1 antara memori di luar heap dan memori heap untuk Qpid Broker.

Pesan dalam memori di luar heap tetap ada di disk. Selain itu, jika total pemanfaatan memori off-heap melampaui batas tertentu, Qpid akan dikonfigurasi untuk meneruskan pesan ke disk.

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

  • 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 informasi tentang cara mengganti konfigurasi.

Untuk mengetahui 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 adalah kunci performa Broker secara keseluruhan. Untuk performa terbaik, pilih perangkat yang memiliki latensi rendah dan yang tidak digunakan oleh aplikasi lain.

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

bin_run-qpidd_qpid.store.filesystem.maxUsagePercent=60

Dalam contoh ini, Broker menolak pesan baru saat sistem file yang mendasarinya sudah 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:
    mulai ulang apigee-service apigee-qpidd