Elasticsearch：Konfigurasi File YML

Peringatan

Konfigurasikan parameter dalam file YML

1. Masuk ke Konsol Elasticsearch Alibaba Cloud.

2. Di panel navigasi kiri, klik Elasticsearch Clusters.

3. Navigasikan ke klaster yang diinginkan.

   1. Di bilah navigasi atas, pilih grup sumber daya tempat klaster milik dan wilayah tempat klaster berada.

   2. Di halaman Elasticsearch Clusters, cari kluster yang diinginkan dan klik ID-nya.

4. Di panel navigasi kiri halaman yang muncul, pilih Configuration and Management > Cluster Configuration.

5. Pada halaman Cluster Configuration, klik Modify Configuration di sebelah kanan YML File Configuration.

6. Di panel YML File Configuration, konfigurasikan parameter berikut.

   Catatan

   Untuk melihat isi file elasticsearch.yml, masuk ke Konsol Kibana klaster Anda dan jalankan perintah GET _cluster/settings?include_defaults.

   Parameter	Deskripsi
   Auto Indexing	Menentukan apakah akan membuat indeks secara otomatis jika dokumen baru diunggah ke klaster Elasticsearch tetapi tidak ada indeks yang ada. Parameter ini sesuai dengan item konfigurasi action.auto_create_index dalam file YML. Nilai default dari item konfigurasi ini adalah false. Secara default, sistem dilarang membuat indeks secara otomatis. Anda dapat menggunakan salah satu metode berikut untuk mengaktifkan sistem agar membuat indeks secara otomatis: Penting Indeks yang dibuat secara otomatis mungkin tidak memenuhi persyaratan bisnis Anda. Oleh karena itu, kami sarankan Anda melakukan evaluasi sebelum mengaktifkan sistem untuk membuat indeks secara otomatis. Atur Pengindeksan Otomatis ke Aktifkan di panel YML File Configuration. Operasi ini merupakan konfigurasi statis dan akan memicu restart klaster. Gunakan mode dinamis untuk dengan cepat mengaktifkan sistem agar membuat indeks secara otomatis. Ini tidak memicu restart klaster. Anda dapat masuk ke Konsol Kibana klaster dan jalankan salah satu perintah berikut: Aktifkan sistem untuk membuat semua indeks secara otomatis PUT /_cluster/settings { "persistent": { "action": { "auto_create_index": "true" } } } Penting Setelah Anda menjalankan perintah di atas, sistem dapat membuat semua indeks secara otomatis. Jika Anda ingin melarang sistem membuat indeks secara otomatis, atur auto_create_index ke false dalam perintah. Aktifkan sistem untuk hanya membuat indeks tertentu secara otomatis (Perintah berikut memberikan contoh tentang cara mengaktifkan sistem untuk hanya membuat indeks sistem secara otomatis.) PUT /_cluster/settings { "persistent": { "action": { "auto_create_index": "+.*,-*" } } }
   Index Deletion	Menentukan apakah akan menentukan nama indeks saat Anda menghapus indeks. Jika Anda mengatur parameter ini ke Allow Wildcards, Anda dapat menggunakan wildcard untuk menghapus beberapa indeks sekaligus. Indeks yang dihapus tidak dapat dipulihkan. Lanjutkan dengan hati-hati. Parameter ini sesuai dengan item konfigurasi action.destructive_requires_name dalam file YML. Nilai default dari item konfigurasi ini adalah true.
   Audit Log Indexing	Jika Anda mengaktifkan Pengindeksan Log Audit, sistem akan menghasilkan log audit untuk operasi buat, hapus, ubah, dan pencarian yang dilakukan pada klaster Elasticsearch. Log ini mengonsumsi ruang disk dan memengaruhi kinerja klaster. Oleh karena itu, kami sarankan Anda menonaktifkan Pengindeksan Log Audit dan melanjutkan dengan hati-hati. Untuk informasi lebih lanjut tentang parameter terkait fitur Pengindeksan Log Audit, lihat Konfigurasikan fitur Pengindeksan Log Audit. Penting Di beberapa wilayah, Anda dapat melihat log audit klaster Elasticsearch versi 7.X atau lebih baru di konsol Elasticsearch. Untuk informasi lebih lanjut tentang wilayah tersebut, lihat Batasan. Sebelum Anda melihat log audit klaster, Anda harus memastikan bahwa fitur Audit Log Indexing diaktifkan untuk klaster tersebut. Untuk informasi lebih lanjut, lihat Kueri log. Untuk klaster Elasticsearch lainnya, Anda perlu menjalankan perintah terkait untuk melihat log audit mereka. Misalnya, untuk melihat log audit klaster tersebut, Anda dapat masuk ke Konsol Kibana klaster dan menjalankan perintah terkait di Konsol Kibana untuk melihat indeks yang namanya dimulai dengan .security_audit_log-. Parameter ini sesuai dengan item konfigurasi xpack.security.audit.enabled dalam file YML. Nilai default dari item konfigurasi ini adalah false.
   Watcher	Setelah Anda mengaktifkan Watcher, Anda dapat menggunakan fitur X-Pack Watcher. Anda harus membersihkan indeks .watcher-history* secara berkala untuk membebaskan ruang disk. Parameter ini sesuai dengan item konfigurasi xpack.watcher.enabled dalam file YML. Nilai default dari item konfigurasi ini adalah false.
   Other Configurations	Deskripsi berikut menyediakan beberapa item konfigurasi yang didukung. Kecuali dinyatakan lain, item-item ini tersedia untuk klaster Elasticsearch V5.X, V6.X, dan V7.X. Konfigurasikan CORS http.cors.enabled http.cors.allow-origin http.cors.max-age http.cors.allow-methods http.cors.allow-headers http.cors.allow-credentials Konfigurasikan daftar putih reindex jarak jauh reindex.remote.whitelist Konfigurasikan fitur Pengindeksan Log Audit Klaster Elasticsearch V7.X dan V8.X hanya mendukung parameter xpack.security.audit.logfile.events.include. Klaster Elasticsearch V5.X dan V6.X mendukung parameter berikut: xpack.watcher.enabled xpack.notification xpack.security.audit.enabled xpack.security.audit.index.bulk_size xpack.security.audit.index.flush_interval xpack.security.audit.index.rollover xpack.security.audit.index.events.include xpack.security.audit.index.events.exclude xpack.security.audit.index.events.emit_request_body xpack.security.audit.index.settings.index Konfigurasikan fitur autentikasi Protokol Akses Direktori Ringan (LDAP) Klaster Elasticsearch selain versi V5.X mendukung parameter berikut: xpack.security.authc.realms.ldap1 xpack.security.authc.realms.active_directory1 xpack.security.authc.realms.pki1 xpack.security.authc.realms.saml1 xpack.security.authc.realms.kerberos1 xpack.security.authc.token.enabled Konfigurasikan ukuran antrian thread_pool.bulk.queue_size (tersedia untuk klaster Elasticsearch V5.X dan V6.X) thread_pool.write.queue_size (tersedia untuk klaster Elasticsearch V6.X, V7.X, dan V8.X) thread_pool.search.queue_size Konfigurasikan plug-in SQL kustom xpack.sql.enabled Secara default, klaster Elasticsearch menggunakan plug-in SQL bawaan yang disediakan oleh X-Pack. Jika Anda ingin mengunggah plug-in SQL kustom ke klaster Elasticsearch Anda, atur xpack.sql.enabled ke false.

   Penting

   • Setelah mengonfigurasi file YML klaster, sistem akan melakukan restart bergulir untuk klaster. Jika indeks klaster memiliki shard replika dan beban klaster normal, klaster tetap dapat memberikan layanan selama restart. Berikut adalah indikator bahwa beban klaster normal: Utilisasi CPU setiap node sekitar 60%, penggunaan heap memory setiap node sekitar 50%, dan nilai NodeLoad_1m untuk setiap node kurang dari jumlah vCPU untuk node tersebut. Waktu yang diperlukan untuk restart tergantung pada ukuran, volume data, dan beban klaster. Kami sarankan Anda mengonfigurasi file YML klaster selama jam-jam sepi.

   • Jika indeks klaster tidak memiliki shard replika, beban klaster terlalu tinggi, dan sejumlah besar data ditulis atau dikueri di klaster, akses ke klaster mungkin timeout selama modifikasi klaster. Kami sarankan Anda mengonfigurasi mekanisme ulang akses untuk klien Anda sebelum melakukan modifikasi klaster. Ini membantu mengurangi dampak pada bisnis Anda.

7. Pilih This operation will restart the cluster. Continue? lalu klik OK.

   Sistem kemudian merestart klaster Elasticsearch. Anda dapat melihat kemajuan restart di kotak dialog Tugas. Setelah klaster direstart, konfigurasi dalam file YML diperbarui.

Konfigurasikan CORS

Konfigurasikan daftar putih reindex jarak jauh

Konfigurasikan fitur Pengindeksan Log Audit

Klaster Elasticsearch versi 7.X atau lebih baru

1. Buka panel YML File Configuration.

   Untuk informasi lebih lanjut, lihat Konfigurasikan Parameter dalam File YML.

2. Atur Audit Log Indexing ke Enable untuk mengaktifkan fitur Pengindeksan Log Audit.

3. Konfigurasikan fitur Pengindeksan Log Audit.

   Setelah fitur Pengindeksan Log Audit diaktifkan, konfigurasi default dari parameter xpack.security.audit.logfile.events.include muncul di Other Configurations. Anda dapat memodifikasi konfigurasi berdasarkan kebutuhan bisnis Anda. Kode berikut memberikan contoh:

   xpack:
     security:
       audit:
         logfile:
           events:
             include the following: >-
               akses_ditolak,akses_anonim_ditolak,otentikasi_gagal,koneksi_ditolak,permintaan_dimanipulasi,run_as_ditolak,run_as_diizinkan

   Penting

   • Klaster versi 7.X atau lebih baru hanya mendukung parameter xpack.security.audit.logfile.events.include.

   • Jika Anda menggunakan konfigurasi default fitur Pengindeksan Log Audit untuk klaster Anda, sistem menghasilkan log audit hanya untuk permintaan yang ditolak atau gagal yang dikirim ke klaster. Jika Anda ingin mendapatkan log audit dari permintaan yang berhasil, Anda harus menambahkan event access_granted untuk klaster. Setelah event ditambahkan, semua informasi akses tentang klaster disimpan, yang meningkatkan penggunaan disk klaster. Oleh karena itu, kami sarankan Anda menonaktifkan fitur Pengindeksan Log Audit setelah Anda menyelesaikan masalah.

4. Lihat log audit klaster.

   Setelah Anda mengaktifkan fitur Audit Log Indexing untuk klaster versi 7.X atau lebih baru, Anda dapat melihat log audit klaster di halaman Logs konsol Elasticsearch. Untuk informasi lebih lanjut, lihat Kueri log. Fitur Pengindeksan Log Audit hanya tersedia di beberapa wilayah. Untuk informasi lebih lanjut tentang wilayah tersebut, lihat Batasan.

Klaster Elasticsearch V5.X dan V6.X

1. Buka panel YML File Configuration.

   Untuk informasi lebih lanjut, lihat Konfigurasikan Parameter dalam File YML.

2. Atur Audit Log Indexing ke Enable untuk mengaktifkan fitur Pengindeksan Log Audit.

   Kode berikut memberikan konfigurasi default dari fitur Pengindeksan Log Audit. Anda dapat memodifikasi konfigurasi berdasarkan kebutuhan bisnis Anda.

   xpack.security.audit.index.bulk_size: 5000
   xpack.security.audit.index.events.emit_request_body: false
   xpack.security.audit.index.events.exclude: run_as_denied,anonymous_access_denied,realm_authentication_failed,access_denied,connection_denied
   xpack.security.audit.index.events.include the following: authentication_failed,access_granted,tampered_request,connection_granted,run_as_granted
   xpack.security.audit.index.flush_interval: 180s
   xpack.security.audit.index.rollover: hourly
   xpack.security.audit.index.settings.index.number_of_replicas: 1
   xpack.security.audit.index.settings.index.number_of_shards: 10

   Parameter	Nilai Default	Deskripsi
   xpack.security.audit.index.bulk_size	1000	Anda dapat menulis peristiwa audit ke indeks log audit dalam batch. Parameter ini menentukan jumlah maksimum peristiwa audit yang dapat ditulis dalam setiap batch.
   xpack.security.audit.index.flush_interval	1s	Frekuensi buffer peristiwa audit dibuang ke indeks log audit.
   xpack.security.audit.index.rollover	daily	Frekuensi peristiwa audit bergulir ke indeks log audit baru. Nilai valid: hourly, daily, weekly, dan monthly.
   xpack.security.audit.logfile.events.include	access_denied,anonymous_access_denied,authentication_failed, connection_denied,tampered_request,run_as_denied,run_as_granted	Jenis peristiwa audit yang dapat dikumpulkan ke log audit. Fitur Pengindeksan Log Audit hanya tersedia di beberapa wilayah. Untuk informasi lebih lanjut tentang wilayah tersebut, lihat Batasan. Untuk informasi lebih lanjut tentang jenis peristiwa audit yang didukung, lihat Jenis Peristiwa Audit (7.x).
   xpack.security.audit.index.events.include	access_denied, access_granted, anonymous_access_denied, authentication_failed, connection_denied, tampered_request, run_as_denied, run_as_granted	Jenis peristiwa audit yang dapat ditulis ke indeks log audit. Parameter ini hanya tersedia untuk klaster Elasticsearch V5.X dan V6.X. Untuk informasi lebih lanjut tentang jenis peristiwa audit yang didukung, lihat Jenis Peristiwa Audit (6.x).
   xpack.security.audit.index.events.exclude	null, yang menunjukkan bahwa sistem tidak memproses peristiwa audit	Jenis peristiwa audit yang tidak dapat ditulis ke indeks log audit.
   xpack.security.audit.index.events.emit_request_body	false	Menentukan apakah akan mengabaikan atau menyertakan badan permintaan REST saat peristiwa audit tertentu dipicu, seperti authentication_failed.

   Peringatan

   Jika peristiwa audit berisi badan permintaan, data sensitif mungkin terpapar.

3. Lihat log audit klaster.

   Setelah fitur Pengindeksan Log Audit diaktifkan untuk klaster V5.X atau V6.X, peristiwa audit disimpan di indeks log audit klaster. Nama indeks dimulai dengan .security_audit_log-. Anda dapat melihat log audit klaster dengan mengakses indeks ini di konsol Kibana klaster.

   Penting

   Indeks log audit mengonsumsi penyimpanan klaster, dan Elasticsearch tidak secara otomatis membersihkan indeks yang kedaluwarsa. Oleh karena itu, Anda harus secara manual membersihkan indeks log audit yang kedaluwarsa.

4. (Opsional) Konfigurasikan shard untuk indeks log audit.

   Anda dapat menggunakan parameter xpack.security.audit.index.settings untuk mengonfigurasi shard untuk indeks log audit di klaster V5.X atau V6.X. Kode berikut memberikan contoh konfigurasi. Dalam contoh ini, jumlah shard utama dan shard replika untuk indeks diatur ke 1.

   xpack.security.audit.index.settings:
     index:
       number_of_shards: 1
       number_of_replicas: 1

   Catatan

   Jika Anda ingin menyesuaikan konfigurasi untuk indeks log audit, tambahkan konfigurasi ke file YML klaster Anda setelah Anda mengatur xpack.security.audit.enabled ke true untuk mengaktifkan Pengindeksan Log Audit. Jika Anda tidak menyesuaikan konfigurasi, sistem menggunakan pengaturan default number_of_shards: 5 dan number_of_replicas: 1 untuk membuat indeks.

Konfigurasikan ukuran antrian