Cara memodifikasi parameter global dalam file config.xml kluster ApsaraDB for ClickHouse - ApsaraDB for ClickHouse

Modifikasi parameter global dalam file config.xml kluster ApsaraDB for ClickHouse untuk mengoptimalkan performa instans.

Latar Belakang

Kluster ApsaraDB for ClickHouse menggunakan nilai parameter default yang dikonfigurasi dalam file config.xml dan user.xml. Anda dapat memodifikasi parameter tersebut untuk mengoptimalkan instans Anda:

File konfigurasi user.xml: Modifikasi parameter dengan menjalankan perintah SET GLOBAL. Perubahan langsung berlaku tanpa perlu restart. Untuk informasi selengkapnya, lihat Modifikasi parameter user.xml.
File konfigurasi config.xml: Modifikasi parameter melalui Konsol.

Catatan Penggunaan

Untuk kluster Edisi Kompatibel Komunitas, Anda dapat mengonfigurasi parameter dalam Mode XML dan melihat riwayat perubahan hanya jika kluster dibuat setelah 1 Desember 2021.
Kluster Edisi Perusahaan tidak mendukung konfigurasi parameter dalam Mode XML.
Mode XML tidak mendukung penghapusan parameter. Parameter yang dapat dikonfigurasi dalam Mode XML sama dengan yang tersedia di Mode Default.
Jika Anda memodifikasi parameter yang memerlukan restart agar berlaku, kluster akan secara otomatis melakukan restart setelah modifikasi parameter selesai. Sebelum mengirimkan parameter, pastikan bahwa restart tersebut tidak memengaruhi bisnis Anda.

Dampak terhadap kluster

Jika kluster berada dalam status Changing Configurations atau Restarting, Anda hanya dapat melihat informasi kluster. Anda tidak dapat melakukan operasi seperti peningkatan tipe instans, skala keluar, atau skala-masuk.
Jika Anda memodifikasi parameter yang memerlukan restart agar berlaku, kluster akan secara otomatis melakukan restart setelah modifikasi parameter selesai. Lakukan operasi ini pada jam sepi untuk menghindari gangguan layanan.

Modifikasi parameter

Prosedur modifikasi parameter berbeda tergantung edisi kluster.

Penting

Jika Anda perlu memodifikasi parameter prometheus.port atau text_log, rujuk ke Parameter penting.

Edisi Perusahaan

Login ke Konsol ApsaraDB for ClickHouse.
Di pojok kiri atas halaman, pilih wilayah kluster target Anda.
Pada halaman Clusters, klik tab Enterprise Edition Clusters, lalu klik ID kluster target.
Di panel navigasi kiri, klik Parameter Management.
Pada kolom Parameter Value, klik ikon Modify untuk mengedit nilai. Masukkan nilai dalam rentang yang valid, lalu klik OK.
Setelah memodifikasi parameter yang diinginkan, klik Submit Parameters di pojok kanan atas halaman.
Pada kotak dialog Save Settings, tinjau nilai parameter sebelum dan sesudah perubahan, konfirmasi perubahan, berikan alasan perubahan, lalu klik OK.

Penting
Jika Anda mengirimkan parameter yang memerlukan restart agar berlaku, kluster ClickHouse akan secara otomatis melakukan restart setelah modifikasi parameter selesai. Sebelum melanjutkan, pastikan bahwa restart tersebut tidak memengaruhi bisnis Anda.

Setelah Anda mengirimkan parameter, sistem akan memvalidasi nilai parameter tersebut. Jika nilai parameter tidak valid, pesan error akan muncul. ErrorCode 102 menunjukkan bahwa nilai yang dimasukkan tidak valid. Kembali ke langkah sebelumnya, masukkan nilai dalam rentang yang valid, lalu kirimkan kembali parameter tersebut.

Edisi Kompatibel Komunitas

Login ke Konsol ApsaraDB for ClickHouse.
Di pojok kiri atas halaman, pilih wilayah kluster target Anda.
Pada halaman Clusters, klik tab Clusters of Community-compatible Edition, lalu klik ID kluster target.
Di panel navigasi kiri, klik Parameter Configuration.
Klik tab Settings. Pilih Default Mode atau XML Mode untuk memodifikasi parameter.

Penting
Di Konsol ApsaraDB for ClickHouse, nilai parameter prometheus.port harus berada dalam rentang 2182 hingga 3000.
- Default Mode: Pada kolom Parameter Value, klik ikon Modify untuk memasuki mode edit. Masukkan nilai dalam rentang yang valid, lalu klik OK.
- XML Mode: Di pojok kanan atas halaman, klik Modify untuk memodifikasi parameter yang diinginkan dalam file.
Setelah memodifikasi parameter yang diinginkan, klik Submit Parameters di pojok kanan atas halaman.
Pada kotak dialog Save Settings, tinjau nilai parameter sebelum dan sesudah perubahan, konfirmasi perubahan, berikan alasan perubahan, lalu klik Submit Parameters.
Penting
- Jika Anda mengirimkan parameter yang memerlukan restart agar berlaku, kluster ClickHouse akan secara otomatis melakukan restart setelah modifikasi parameter selesai. Sebelum melanjutkan, pastikan bahwa restart tersebut tidak memengaruhi bisnis Anda.
- Dalam Mode XML, jika nilai parameter tidak valid, pesan error akan muncul. ErrorCode 102 menunjukkan bahwa nilai yang dimasukkan tidak valid. Kembali ke langkah sebelumnya, masukkan nilai dalam rentang yang valid, lalu kirimkan kembali parameter tersebut.

Membatalkan modifikasi

Catatan

Anda hanya dapat membatalkan modifikasi yang belum dikirimkan.
Untuk kluster Edisi Perusahaan dan kluster Edisi Kompatibel Komunitas dalam XML Mode, Anda hanya dapat membatalkan semua modifikasi parameter sekaligus.

Untuk membatalkan modifikasi yang belum dikirimkan, lakukan salah satu operasi berikut:

Membatalkan modifikasi satu parameter: Klik ikon di samping nilai parameter. ApsaraDB for ClickHouse akan mengembalikan modifikasi yang belum dikirimkan untuk parameter tersebut ke nilai sebelumnya.
Membatalkan semua modifikasi parameter: Klik Cancel di pojok kanan atas daftar parameter. ApsaraDB for ClickHouse akan mengembalikan semua perubahan yang belum dikirimkan ke nilai sebelumnya.

Lihat riwayat perubahan

Edisi Perusahaan

Login ke Konsol ApsaraDB for ClickHouse.
Di pojok kiri atas halaman, pilih wilayah kluster target Anda.
Pada halaman Clusters, klik tab Enterprise Edition Clusters, lalu klik ID kluster target.
Di panel navigasi kiri, klik Parameter Management.
Klik tab Change History untuk melihat riwayat perubahan dengan salah satu cara berikut:
- Klik Last 30 Days atau Last 7 Days untuk melihat perubahan dari periode yang sesuai.
- Tentukan rentang waktu untuk melihat catatan modifikasi dalam periode tersebut.

Edisi Kompatibel Komunitas

Login ke Konsol ApsaraDB for ClickHouse.
Di pojok kiri atas halaman, pilih wilayah kluster target Anda.
Pada halaman Clusters, klik tab Clusters of Community-compatible Edition, lalu klik ID kluster target.
Di panel navigasi kiri, klik Parameter Configuration.
Klik tab Change History untuk melihat riwayat perubahan dengan salah satu cara berikut:
- Klik Last 30 Days atau Last 7 Days untuk melihat perubahan dari periode yang sesuai.
- Tentukan rentang waktu dan klik Query untuk melihat catatan modifikasi dalam periode tersebut.

Parameter penting

Di Konsol ApsaraDB for ClickHouse, nilai parameter prometheus.port dibatasi pada nomor port dalam rentang 2182 hingga 3000.

Pada beberapa versi kluster, text_log tidak diaktifkan atau nilai text_log.level terlalu rendah. Untuk melihat log teks, atur parameter text_log.level ke nilai yang sesuai berdasarkan kebutuhan Anda:

Value	Description	Use cases
trace	Tingkat log paling detail. Mencatat semua operasi dan event.	Menelusuri eksekusi program selama pengembangan dan debugging.
debug	Berisi informasi detail yang berguna selama pengembangan, tetapi kurang verbose dibanding trace. Biasanya mencatat pemanggilan fungsi dan status variabel.	Debugging program.
information	Mencatat operasi normal dan event status, seperti memulai layanan dan menyelesaikan tugas. Biasanya menunjukkan bahwa sistem berjalan normal tanpa error.	N/A
warning	Menunjukkan potensi masalah atau error non-fatal. Sistem tetap berjalan, tetapi beberapa kondisi mungkin perlu diperhatikan.	Memantau sistem, menganalisis potensi masalah, dan mengoptimalkan sistem.
error	Menunjukkan bahwa sistem mengalami error yang memengaruhi beberapa fitur atau operasi. Sistem mungkin tetap berjalan, tetapi Anda harus menangani error tersebut.	Memantau sistem dan menganalisis error untuk memecahkan masalah.