All Products
Search
Document Center

Microservices Engine:Konfigurasikan parameter mesin ZooKeeper

Last Updated:Mar 12, 2026

Saat membuat mesin ZooKeeper di Microservices Engine (MSE), parameter akan diterapkan dengan nilai default. Anda dapat memodifikasi parameter waktu, session timeout, koneksi, dan data untuk mengoptimalkan kinerja mesin sesuai beban kerja Anda.

Prasyarat

Sebelum memulai, pastikan Anda telah:

Referensi parameter

Parameter waktu

TickTime adalah satuan waktu dasar untuk ZooKeeper. Parameter waktu lainnya dinyatakan sebagai kelipatan dari TickTime.

ParameterDeskripsi
TickTimeSatuan waktu dasar yang mengatur heartbeat dan timeout. Semua parameter berbasis tick merujuk pada nilai ini.
InitLimitWaktu maksimum (dalam tick) bagi follower untuk terhubung dan menyelaraskan data dengan leader. Timeout aktual sama dengan InitLimit dikalikan dengan TickTime.
SyncLimitWaktu maksimum (dalam tick) bagi follower untuk menyelaraskan data dengan leader. Follower yang terlalu jauh tertinggal akan diputus.

Parameter session timeout

ParameterDeskripsi
SessionTimeoutSession timeout yang dinegosiasikan oleh client. Server membatasi nilai ini dalam rentang yang ditentukan oleh MinSessionTimeout dan MaxSessionTimeout.
MinSessionTimeoutSession timeout minimum yang diizinkan server untuk dinegosiasikan oleh client.
MaxSessionTimeoutSession timeout maksimum yang diizinkan server untuk dinegosiasikan oleh client.
Catatan: Untuk mengonfigurasi parameter session timeout, lakukan upgrade dari versi open source ZooKeeper ke versi MSE ZooKeeper. Untuk detailnya, lihat Fitur edisi ZooKeeper.

Parameter koneksi dan data

ParameterDeskripsi
MaxClientCnxnsJumlah maksimum koneksi client bersamaan per alamat IP.
Jute.MaxbufferUkuran data maksimum (dalam byte) yang dapat disimpan oleh satu znode.
OpenSuperAclMengaktifkan akses Access Control List (ACL) super untuk mesin ZooKeeper.

Modifikasi parameter mesin

  1. Masuk ke Konsol MSE dan pilih wilayah di bilah navigasi atas.

  2. Di panel navigasi kiri, pilih Microservices Registry > Instances.

  3. Di halaman Instances, klik nama instans.

  4. Di panel navigasi kiri, klik Parameter Settings. Klik Edit di pojok kiri atas, lalu konfigurasikan parameter tersebut.

    Configure parameters

  5. Klik Save and Restart Instance.

  6. Setelah instans restart, kembali ke halaman Parameter Settings dan verifikasi bahwa nilai parameter telah diperbarui.

Cara kerja negosiasi session timeout

Saat klien terhubung ke mesin ZooKeeper, server dan klien melakukan negosiasi session timeout. Server menerapkan batasan yang telah dikonfigurasi:

  • Jika timeout klien kurang dari MinSessionTimeout, server akan menggantinya dengan nilai MinSessionTimeout.

  • Jika timeout klien lebih besar dari MaxSessionTimeout, server akan menggantinya dengan nilai MaxSessionTimeout.

Rentang timeout efektif selalu [MinSessionTimeout, MaxSessionTimeout].

Contoh: Mesin ZooKeeper memiliki MinSessionTimeout diatur ke 3.000 ms dan MaxSessionTimeout diatur ke 5.000 ms. Klien meminta session timeout sebesar 1.000 ms (minimum) dan 6.000 ms (maksimum). Setelah negosiasi, session timeout minimum efektif menjadi 3.000 ms dan session timeout maksimum efektif menjadi 5.000 ms.

Pertimbangan produksi

  • Hindari mengatur MinSessionTimeout dan MaxSessionTimeout ke nilai yang sangat kecil. Nilai kecil menyebabkan klien sering mendeteksi timeout koneksi, yang memutus session dan berpotensi menyebabkan kegagalan sistem. Gunakan nilai default kecuali beban kerja Anda memerlukan penyesuaian khusus.