ApsaraDB for ClickHouse menyimpan pengaturan kluster global dalam dua file konfigurasi: config.xml dan user.xml. Topik ini menjelaskan cara melihat dan memodifikasi parameter config.xml dari Konsol, melacak riwayat perubahan, serta membatalkan perubahan yang belum diajukan.
Untuk memodifikasi parameter user.xml, gunakan perintah SQL SET GLOBAL — perubahan langsung berlaku tanpa perlu restart. Untuk detailnya, lihat Memodifikasi parameter user.xml.
Mode XML dan riwayat modifikasi hanya tersedia pada kluster Edisi Komunitas yang dibuat setelah 1 Desember 2021. Kluster Edisi Perusahaan tidak mendukung mode XML.
Dampak potensial
Saat kluster berada dalam status Changing Configuration atau Restarting, Anda hanya dapat melihat informasi kluster. Operasi seperti peningkatan, skala keluar, dan skala-masuk tidak tersedia.
Jika ada parameter yang dimodifikasi memerlukan restart agar berlaku, kluster akan direstart secara otomatis setelah Anda mengajukan perubahan. Jadwalkan operasi ini selama jam sepi untuk menghindari gangguan layanan.
Memodifikasi parameter
Untuk panduan mengenai parameter prometheus.port dan text_log, lihat Parameter penting.
Edisi Perusahaan
Masuk ke Konsol ApsaraDB for ClickHouse.
Di pojok kiri atas halaman, pilih Wilayah tempat kluster berada.
Pada halaman Clusters, klik tab Enterprise Edition Clusters, lalu klik ID kluster.
Di panel navigasi kiri, klik Parameter Management.
Pada kolom Parameter Value, klik ikon edit
. Masukkan nilai dalam rentang yang ditentukan, lalu klik OK.Setelah memodifikasi parameter, klik Submit Parameters di pojok kanan atas.
Pada kotak dialog Save Settings, tinjau perubahan, masukkan alasan perubahan, lalu klik OK.
Jika ada parameter yang diajukan memerlukan restart, ClickHouse akan merestart kluster secara otomatis. Pastikan restart tidak akan mengganggu layanan Anda sebelum melanjutkan.
Setelah pengajuan, sistem memvalidasi semua nilai parameter. Jika nilai tidak valid, muncul pesan Error. Jika ErrorCode bernilai 102, artinya nilai berada di luar rentang — kembali ke langkah sebelumnya, masukkan nilai dalam Input Range, lalu ajukan kembali.
Edisi Komunitas
Masuk ke Konsol ApsaraDB for ClickHouse.
Di pojok kiri atas halaman, pilih Wilayah tempat kluster berada.
Pada halaman Clusters, klik tab Clusters of Community-compatible Edition, lalu klik ID kluster.
Di panel navigasi kiri, klik Parameter Configuration.
Pada halaman Parameter Configuration, klik tab Settings. Pilih Default Mode atau XML mode: dan modifikasi parameter.
Default mode: Pada kolom Parameter Value, klik ikon edit
. Masukkan nilai dalam rentang yang ditentukan, lalu klik OK.XML mode: Di pojok kanan atas, klik Modify dan perbarui parameter.
PentingParameter
prometheus.porthanya menerima nomor port dalam rentang 2182–3000.(Opsional) Di pojok kanan atas, pilih Show Modified Parameters Only untuk menampilkan hanya parameter yang telah diubah tetapi belum diajukan.
Setelah memodifikasi parameter, klik Submit Parameters di pojok kanan atas.
Pada kotak dialog Save Settings, tinjau perubahan, masukkan alasan perubahan, lalu klik Submit Parameters.
Penting- Jika ada parameter yang diajukan memerlukan restart, ClickHouse akan merestart kluster secara otomatis. Pastikan restart tidak akan mengganggu layanan Anda sebelum melanjutkan. - Dalam mode XML, jika nilai tidak valid, muncul pesan Error. Jika ErrorCode bernilai 102, artinya nilai berada di luar rentang — kembali ke langkah sebelumnya, masukkan nilai dalam Input Range, lalu ajukan kembali.
Membatalkan perubahan
Anda hanya dapat membatalkan perubahan pada parameter yang belum diajukan.
Untuk kluster Edisi Komunitas dalam mode XML dan kluster Edisi Perusahaan, semua perubahan harus dibatalkan sekaligus — pembatalan per parameter tidak didukung.
Untuk membatalkan perubahan sebelum diajukan:
Membatalkan satu parameter (hanya Edisi Komunitas, mode default): Klik ikon
di samping nilai parameter. Parameter akan kembali ke nilai sebelumnya.Membatalkan semua parameter: Klik Cancel di pojok kanan atas daftar parameter. Semua perubahan yang belum diajukan akan dibuang.
Menampilkan riwayat modifikasi
Edisi Perusahaan
Masuk ke Konsol ApsaraDB for ClickHouse.
Di pojok kiri atas halaman, pilih Wilayah tempat kluster berada.
Pada halaman Clusters, klik tab Enterprise Edition Clusters, lalu klik ID kluster.
Di panel navigasi kiri, klik Parameter Management.
Pada halaman Parameter Management, klik tab Change History.
Lihat riwayat menggunakan salah satu opsi berikut:
Klik Last 30 Days atau Last 7 Days untuk memfilter berdasarkan rentang preset.
Pilih Waktu mulai dan waktu akhir untuk memfilter berdasarkan rentang kustom.
Edisi Komunitas
Masuk ke Konsol ApsaraDB for ClickHouse.
Di pojok kiri atas halaman, pilih Wilayah tempat kluster berada.
Pada halaman Clusters, klik tab Clusters of Community-compatible Edition, lalu klik ID kluster.
Di panel navigasi kiri, klik Parameter Configuration.
Pada halaman Parameter Configuration, klik tab Change History.
Lihat riwayat menggunakan salah satu opsi berikut:
Klik Last 30 Days atau Last 7 Days untuk memfilter berdasarkan rentang preset.
Pilih Waktu mulai dan waktu akhir, lalu klik Query untuk memfilter berdasarkan rentang kustom.
Parameter penting
prometheus.port
Parameter prometheus.port hanya menerima nomor port dalam rentang 2182–3000. Pembatasan ini berlaku baik untuk Edisi Perusahaan maupun Edisi Komunitas.
text_log
Pada beberapa versi kluster, text_log tidak diaktifkan secara default, atau text_log.level diatur terlalu rendah sehingga tidak mencatat output yang bermakna. Atur text_log.level ke level yang sesuai berdasarkan kasus penggunaan Anda:
| Level | Description | When to use |
|---|---|---|
trace | Level paling detail. Mencatat semua operasi dan event. | Melacak alur eksekusi selama pengembangan dan debugging |
debug | Mencatat pemanggilan fungsi dan status variabel. Lebih ringkas daripada trace. | Debugging program |
information | Mencatat operasi normal dan event status, seperti saat layanan dimulai dan tugas selesai. | N/A |
warning | Menandai potensi masalah atau error non-fatal yang mungkin perlu diperhatikan. | Memantau potensi masalah dan mengoptimalkan sistem |
error | Mencatat error yang memengaruhi fitur atau operasi sistem dan memerlukan penanganan segera. | Memantau dan mendiagnosis error |