全部产品
Search
文档中心

Elasticsearch:Lakukan pemeriksaan sebelum peningkatan versi

更新时间:Jun 24, 2025

Sebelum meningkatkan versi kluster Alibaba Cloud Elasticsearch, Anda harus melakukan pemeriksaan manual yang diperlukan. Kami juga menyarankan untuk memeriksa status kluster dan kompatibilitas konfigurasi secara manual serta memodifikasi konfigurasi berdasarkan kebutuhan bisnis Anda. Topik ini menjelaskan pemeriksaan manual yang diperlukan, pemeriksaan status kluster, serta kompatibilitas konfigurasi yang direkomendasikan sebelum peningkatan versi. Ini juga menyediakan metode untuk memodifikasi konfigurasi yang tidak kompatibel.

Informasi latar belakang

  • Untuk informasi lebih lanjut tentang cara meningkatkan versi kluster, lihat Tingkatkan Versi Kluster.

  • Perintah yang disediakan dalam topik ini dapat dijalankan di konsol Kibana. Untuk informasi lebih lanjut tentang cara masuk ke konsol Kibana, lihat Masuk ke Konsol Kibana.

Lakukan pemeriksaan manual

Sebelum meningkatkan versi kluster Anda, lakukan operasi berikut secara manual:

  • Jalankan perintah berikut untuk memeriksa apakah kluster Anda menyimpan indeks dalam keadaan tertutup:

    GET _cat/indices?v

    Check for indexes that are in the close state

    Jika kluster Anda menyimpan indeks dalam keadaan tertutup, jalankan perintah berikut untuk membuka indeks:

    POST test/_open
  • Jika ingin memperbarui kernel kluster Anda, periksa apakah ada versi kernel yang lebih baru tersedia. Anda hanya dapat memperbarui kernel kluster jika versi kernel yang lebih baru tersedia untuk kluster tersebut.

    Anda dapat mengunjungi halaman Informasi Dasar kluster Anda untuk memeriksa apakah versi kernel yang lebih baru tersedia.A later kernel version is available

  • Periksa apakah klien digunakan untuk mengakses kluster. Jika klien digunakan, pastikan bahwa versi klien kompatibel dengan versi kluster. Jika kedua versi tidak kompatibel, tingkatkan versi klien. Untuk informasi lebih lanjut tentang kompatibilitas versi antara klien dan kluster, lihat Kompatibilitas.

Jika ingin meningkatkan versi kluster dari V5.X ke V6.X, Anda juga harus melakukan operasi berikut:

  • Pisahkan setiap indeks multi-tipe yang disimpan dalam kluster V5.X menjadi beberapa indeks single-tipe.

    Kluster V6.X atau yang lebih baru tidak mendukung indeks multi-tipe. Jika kluster V5.X menyimpan indeks multi-tipe, Anda masih dapat menulis data ke indeks setelah versi kluster ditingkatkan ke V6.X. Namun, jika Anda membuat indeks multi-tipe di V6.X, kesalahan akan dilaporkan. Kami menyarankan untuk membagi setiap indeks multi-tipe menjadi indeks single-tipe sebelum peningkatan.

  • Jalankan perintah berikut untuk memeriksa apakah fitur pencarian lintas kluster diaktifkan untuk kluster. Jika fitur diaktifkan untuk kluster, parameter search.remote ditampilkan dalam hasil pengembalian, dan nilai parameter ini tidak nol.

    GET _cluster/settings

    Jika fitur diaktifkan untuk kluster, jalankan perintah berikut untuk menonaktifkan fitur tersebut. Setelah Anda meningkatkan versi kluster, Anda dapat mengaktifkan fitur tersebut lagi.

    PUT _cluster/settings
    {
      "persistent": {
        "search.remote.*": null
      },
      "transient": {
        "search.remote.*": null
      }
    }
    null

    Parameter search.remote digunakan untuk mengonfigurasi fitur pencarian lintas kluster di V5.X, sedangkan parameter cluster.remote digunakan di V6.X.

Pemeriksaan status kluster

Saat meningkatkan versi kluster Anda, klik Pra-pemeriksaan untuk memastikan sistem memeriksa apakah status kluster dan beban kluster normal. Versi kluster Anda hanya dapat ditingkatkan jika kluster berada dalam keadaan normal dan bebannya normal. Sebelum meningkatkan versi kluster Anda, Anda juga dapat merujuk pada item yang tercantum dalam tabel berikut untuk melakukan pemeriksaan manual.

Item pemeriksaan

Keadaan normal

Status kluster

Kluster berada dalam keadaan Normal (ditunjukkan oleh warna hijau).

Penggunaan memori heap JVM

Penggunaan memori heap JVM kluster kurang dari 75%.

Penggunaan disk

Penggunaan disk node kurang dari nilai cluster.routing.allocation.disk.watermark.low.

Shard replika

  • Semua indeks dikonfigurasikan dengan shard replika.

  • Sebelum Anda melakukan perubahan pada kluster multi-zona, Anda harus memastikan bahwa jumlah shard replika setiap indeks dalam kluster kurang dari jumlah zona tempat kluster diterapkan. Setelah perubahan selesai, Anda dapat secara manual meningkatkan jumlah shard replika berdasarkan kebutuhan bisnis Anda. Untuk informasi tentang cara mengubah jumlah shard replika indeks dalam kluster, lihat Template Indeks.

Snapshots

Sistem membuat snapshot untuk kluster selama satu jam terakhir.

Plugin kustom

Kluster tidak memiliki plugin kustom yang terpasang.

Instance ECS (Elastic Compute Service) di zona tempat kluster berada

Zona tempat kluster berada memiliki instance ECS yang cukup.

null

Saat Anda meningkatkan versi kluster, sistem menambahkan node versi yang lebih baru ke kluster. Kemudian, sistem memigrasikan data yang disimpan pada node asli ke node yang ditambahkan dan menghapus node asli dari kluster. Pastikan bahwa zona tempat kluster berada memiliki instance ECS yang cukup sebelum peningkatan.

File konfigurasi YML

Kluster versi yang lebih baru kompatibel dengan file konfigurasi YML versi sebelumnya.

Pemeriksaan kompatibilitas konfigurasi

Saat meningkatkan versi kluster ke V6.X, sistem secara otomatis memeriksa apakah ada konfigurasi yang tidak kompatibel antara versi. Jika Anda tidak memodifikasi konfigurasi yang tidak kompatibel, layanan kluster Anda mungkin terpengaruh setelah peningkatan. Untuk memastikan bahwa versi kluster dapat ditingkatkan, Anda dapat menjalankan perintah GET _cluster/settings dan GET */_settings?flat_settings=true untuk memeriksa apakah konfigurasi yang tercantum dalam tabel berikut dikonfigurasikan untuk kluster Anda sebelum melakukan peningkatan.

null

Jika template indeks berisi konfigurasi yang tercantum dalam tabel berikut, template tersebut tidak dapat digunakan untuk membuat indeks setelah peningkatan versi.

No.

Tingkat konfigurasi

Kategori konfigurasi

Parameter

1

Kluster

Pengaturan snapshot

cluster.routing.allocation.snapshot.relocation_enabled

2

Pengaturan pembatasan penyimpanan

indices.store.throttle.type dan indices.store.throttle.max_bytes_per_sec

3

Indeks

Pengaturan kemiripan

index.similarity.base

4

Pengaturan replika bayangan

index.shared_filesystem dan index.shadow_replicas

5

Pengaturan penyimpanan indeks

index.store.type

6

Pengaturan pembatasan penyimpanan

index.store.throttle.type dan index.store.throttle.max_bytes_per_sec

7

Pengaturan include_in_all dalam konfigurasi pemetaan indeks

include_in_all

null

Indeks yang dibuat sebelum peningkatan dari V5.X ke V6.X dan memiliki parameter ini dikonfigurasi masih dapat digunakan setelah peningkatan. Indeks yang dibuat setelah peningkatan tidak mendukung parameter ini.

8

Pengaturan versi untuk pembuatan indeks

index.version.created

null

Parameter ini menentukan bahwa indeks tidak dapat ditingkatkan melintasi versi utama. Misalnya, Anda tidak dapat langsung meningkatkan indeks yang dibuat di V5.X ke V7.X. Sebelum peningkatan dari V5.X ke V7.X, Anda harus memanggil API reindex untuk memigrasi data dalam indeks ke kluster V7.X. Kemudian, hapus indeks dari kluster V5.X dan tingkatkan versi kluster V5.X.

9

Template indeks

Pengaturan kemiripan

index.similarity.base

10

Pengaturan replika bayangan

index.shared_filesystem dan index.shadow_replicas

11

Pengaturan penyimpanan indeks

index.store.type

12

Pengaturan pembatasan penyimpanan

index.store.throttle.type dan index.store.throttle.max_bytes_per_sec

13

Pengaturan include_in_all dalam konfigurasi pemetaan template indeks

include_in_all

14

Pengaturan _all dalam konfigurasi pemetaan template indeks

_all

15

Pengaturan tipe dalam konfigurasi pemetaan template indeks

Tidak ada

null

Periksa apakah konfigurasi pemetaan dalam template indeks berisi beberapa pengaturan tipe.

null
  • Parameter yang tercantum dalam tabel di atas sudah tidak digunakan lagi di V6.0 dan yang lebih baru. Untuk informasi lebih lanjut, lihat Perubahan Besar dalam 6.0.

  • Item pemeriksaan di atas adalah item pemeriksaan KRITIS. Jika item pemeriksaan KRITIS dilaporkan, kluster gagal dalam pemeriksaan kompatibilitas, dan versi kluster tidak dapat ditingkatkan. Versi yang lebih baru tidak kompatibel dengan konfigurasi yang ditunjukkan oleh item pemeriksaan KRITIS. Anda harus merujuk ke Modifikasi Konfigurasi yang Tidak Kompatibel untuk memodifikasi konfigurasi yang tidak kompatibel dan melakukan pemeriksaan lagi. Jika item pemeriksaan PERINGATAN dilaporkan, kluster gagal dalam pemeriksaan kompatibilitas, tetapi versi kluster masih dapat ditingkatkan. Konfigurasi yang ditunjukkan oleh item pemeriksaan PERINGATAN diabaikan setelah peningkatan.

Modifikasi konfigurasi yang tidak kompatibel

Bagian ini menyediakan metode untuk memodifikasi konfigurasi yang tidak kompatibel.

  • Konfigurasi Tidak Kompatibel Tingkat Kluster

    Untuk konfigurasi tidak kompatibel tingkat kluster, Anda dapat menonaktifkan konfigurasi tersebut.

    Kategori konfigurasi

    Perintah untuk menonaktifkan konfigurasi

    Pengaturan snapshot

    PUT _cluster/settings
    {
      "persistent": {
        "cluster.routing.allocation.snapshot.relocation_enabled": null
      },
      "transient": {
        "cluster.routing.allocation.snapshot.relocation_enabled": null
      }
    }

    Pengaturan pembatasan penyimpanan

    PUT _cluster/settings
    {
      "persistent": {
        "indices.store.throttle.type": null,
        "indices.store.throttle.max_bytes_per_sec": null
      },
      "transient": {
        "indices.store.throttle.type": null,
        "indices.store.throttle.max_bytes_per_sec": null
      }
    }
  • Konfigurasi Tidak Kompatibel Tingkat Indeks

    Untuk konfigurasi tidak kompatibel tingkat indeks, Anda dapat menonaktifkan konfigurasi tersebut.

    Kategori konfigurasi

    Perintah untuk menonaktifkan konfigurasi

    Informasi tambahan

    Pengaturan kemiripan

    PUT test_index/_settings
    {
       "index.similarity.base.*": null
    }

    Konfigurasi ini hanya dapat dimodifikasi setelah indeks ditutup. Anda tidak dapat membaca data dari atau menulis data ke indeks yang ditutup. Setelah modifikasi, Anda dapat membuka indeks. Contoh berikut menunjukkan cara membuka dan menutup indeks test_index:

    • Tutup indeks

      POST test_index/_close
    • Buka indeks

      POST test_index/_open

    Pengaturan replika bayangan

    PUT test_index/_settings
    {
        "index.shared_filesystem": null,
        "index.shadow_replicas": null
    }

    Pengaturan penyimpanan indeks

    PUT test_index/_settings
    {
       "index.store.type": null
    }

    Pengaturan pembatasan penyimpanan

    PUT test_index/_settings
    {
      "settings": {
        "index.store.throttle.type": null,
        "index.store.throttle.max_bytes_per_sec": null
      }
    }

    Tidak ada.

    null

    Indeks yang memiliki parameter include_in_all yang dikonfigurasi masih dapat digunakan di versi yang lebih baru. Anda tidak perlu memodifikasi parameter ini.

  • Konfigurasi Tidak Kompatibel Tingkat Template Indeks

    Contoh berikut menunjukkan cara memodifikasi konfigurasi dalam template indeks test_template:

    1. Jalankan perintah GET _template/test_template untuk menanyakan template indeks test_template.

      Hasil query menunjukkan bahwa template indeks berisi konfigurasi tidak kompatibel berikut: pengaturan penyimpanan indeks, _all, dan include_in_all.

      {
       "test_template": {
         "order": 0,
         "template": "test_*",
         "settings": {
           "index": {
             "store": {
               "throttle": {
                 "max_bytes_per_sec": "100m"
               }
             }
           }
         },
         "mappings": {
           "test_type": {
             "_all": {
               "enabled": true
             },
             "properties": {
               "test_field": {
                 "type": "text",
                 "include_in_all": true
               }
             }
           }
         },
         "aliases": {}
       }
      }
    2. Jalankan perintah berikut untuk menghapus konfigurasi yang tidak kompatibel dan memperbarui template indeks:

      PUT _template/test_template
      {
         "order": 0,
         "template": "test_*",
         "settings": {
         },
         "mappings": {
           "test_type": {
             "properties": {
               "test_field": {
                 "type": "text"
               }
             }
           }
         },
         "aliases": {}
      }