Elasticsearch:Error Umum

413 Request Entity Too Large

Satu permintaan bulk write melebihi batas http.max_content_length, yang secara default bernilai 100 MB. Jangan ubah batas ini.

Data yang ditulis per permintaan sama dengan jumlah dokumen dikalikan ukuran rata-rata dokumen. Karena ukuran dokumen bervariasi, mulailah menyesuaikan dari 5 MB per permintaan dan tingkatkan hingga maksimal 15 MB. Untuk panduan lebih lanjut, lihat Using and Sizing Bulk Requests dan HTTP settings.

"forbids automatic creation of the index"

Auto Indexing dinonaktifkan pada kluster. Aktifkan melalui Konsol Elasticsearch:

• Metode statis (disarankan): Aktifkan Auto Indexing di panel YML File Configuration. Untuk langkah-langkahnya, lihat Configure the YML file.

• Metode dinamis: Jalankan perintah API yang sesuai untuk mengaktifkan Auto Indexing tanpa melakukan restart kluster.

"all shards failed"

Error ini muncul ketika kluster tidak dapat melayani kueri dari satu atau beberapa shard. Penyebab umum meliputi node terputus, shard masih dalam proses pemulihan setelah restart, atau disk rusak.

Langkah 1: Diagnosis

Periksa data pemantauan dan log kluster untuk mengidentifikasi akar masalah — misalnya, ruang disk tidak mencukupi atau pengaturan indeks atau kluster yang salah sehingga menghalangi alokasi shard.

Langkah 2: Perbaiki shard yang tidak ditugaskan

Jika penyebabnya adalah node terputus atau shard tidak ditugaskan:

1. Masuk ke Konsol Kibana.

2. Periksa status alokasi shard:

   Jika semua shard sudah dialokasikan, perintah ini akan mengembalikan error — perilaku ini diharapkan.

   GET /_cluster/allocation/explain

3. Coba ulang alokasi shard yang gagal:

   POST /_cluster/reroute?retry_failed=true

SSL/TLS errors in cluster logs

Log kluster menampilkan error SSL/TLS seperti berikut ketika traffic plaintext dikirim melalui koneksi SSL. Hal ini biasanya terjadi ketika node tanpa komunikasi terenkripsi mencoba terhubung ke node yang telah mengaktifkan enkripsi.

Periksa hal-hal berikut:

• Ketidaksesuaian HTTP vs. HTTPS: Jika HTTPS tidak diaktifkan pada kluster, akses hanya tersedia melalui HTTP. Mengakses kluster melalui HTTPS akan memicu error ini. Untuk mengaktifkan HTTPS, lihat Enable HTTPS.

• Alamat IP tidak ada dalam daftar putih: Pastikan alamat IP yang ditampilkan dalam log kluster termasuk dalam daftar putih alamat IP publik. Tambahkan hanya alamat IP atau Blok CIDR yang diperlukan — jangan tambahkan 0.0.0.0/0.

Untuk pola error SSL/TLS lainnya, lihat Common SSL/TLS exceptions.

"No keyword/multi-field defined exact matches for [KeywordField]"

Error ini terjadi ketika Anda menggunakan operator LIKE dalam kueri plug-in X-Pack SQL terhadap bidang bertipe text. Operator LIKE hanya mendukung penyaringan eksak pada bidang bertipe keyword. Ubah kueri agar menggunakan bidang keyword sebagai gantinya.

Untuk latar belakang informasi, lihat Unable to run SQL query on multi fields using Elastic Search v. 7.3 dan SQL and multi-fields.

"path is not accessible on master node"

Error ini terjadi saat menjalankan PUT _snapshot/my_backup jika bucket Object Storage Service (OSS) target menggunakan kelas penyimpanan Archive. Bucket Archive memerlukan pemulihan objek sebelum data dapat dibaca, yang tidak kompatibel dengan operasi snapshot Elasticsearch.

Gunakan bucket OSS dengan kelas penyimpanan Standard di wilayah yang sama dengan kluster Elasticsearch. Untuk langkah-langkahnya, lihat Create manual snapshots and restore data from manual snapshots.

"kibana did not load properly"

Ketika penggunaan disk pada node data melebihi 95%, Elasticsearch memicu proteksi penulisan dan mengatur read_only_allow_delete pada semua indeks. Penulisan diblokir; hanya pembacaan dan penghapusan yang diizinkan.

Langkah 1: Atasi penggunaan disk tinggi (akar masalah)

Atasi terlebih dahulu penyebab utama penggunaan disk tinggi. Lihat High disk usage and read-only indexes untuk opsi seperti memperluas kapasitas disk, menghapus indeks yang tidak digunakan, atau mengonfigurasi manajemen siklus hidup indeks.

Langkah 2: Pulihkan akses tulis

Setelah penggunaan disk diatasi, reset flag read-only pada semua indeks:

PUT _settings
{
   "index.blocks.read_only_allow_delete": null
}

"unsupported_operation_exception" (plug-in aliyun-qos)

Setelah mengaktifkan pembatasan kecepatan dengan apack.qos.ratelimit.enabled, Anda melihat error ini saat mengonfigurasi limiter:

{
   "error": {
      "root_cause": [
         {
            "type": "unsupported_operation_exception",
            "reason": "unsupported_operation_exception: only define search or bulk action for limit"
         }
      ],
      "type": "unsupported_operation_exception",
      "reason": "unsupported_operation_exception: only define search or bulk action for limit"
   },
   "status": 500
}

Versi plug-in aliyun-qos belum yang terbaru. Jalankan GET /_cat/plugins?v untuk memeriksa versi saat ini. Versi terbaru yang diharapkan adalah:

• Elasticsearch V7.10: 7.10.0_ali1.6.0.2

• Versi lainnya: <ES version>-rc4

Lakukan peningkatan berdasarkan versi kluster Anda:

• Kluster V7.10: Lakukan upgrade kernel ke V1.6.0. Lihat Upgrade the version of a cluster.

• Versi lainnya: Submit a ticket agar insinyur teknis Elasticsearch melakukan upgrade plug-in. Restart kluster setelah upgrade agar perubahan berlaku.

"NoNodeAvailableException" (Transport Client, port 9300)

Saat menggunakan Transport Client 5.5 atau 5.6 untuk terhubung melalui port 9300, Anda mungkin melihat:

NoNodeAvailableException[None of the configured nodes are available: [{#transport#-1}{HVdK7Cff****_P0c9n****}{es-cn-v1qqweee****.elasticsearch.aliyuncs.com}{172.17.XX.XX:9300}]]

Alamat IP 172.17.XX.XX bukan merupakan node aktual dalam kluster — ini adalah masalah yang diketahui pada versi klien tersebut. Gunakan Transport Client 5.3.3 sebagai gantinya. Lihat Transport Client (5.x).

"Unclosed object or array found" / "ArrayIndexOutOfBoundsException" (V7.4)

Error ini disebabkan oleh bug pada Elasticsearch open source versi 7.4 dan tidak memengaruhi operasi bisnis Anda. Bug tersebut telah diperbaiki pada versi setelah 7.4.

Alibaba Cloud Elasticsearch V7.4 telah dihentikan. Beli kluster yang menjalankan versi lebih baru. Jika Anda perlu melakukan migrasi data sebelum beralih, lihat Select a data migration solution untuk memilih pendekatan yang tepat bagi workload Anda.

"No field found for [metaData] in mapping with types" (aliyun-knn)

Error ini muncul saat menggunakan plug-in aliyun-knn untuk pencarian vektor pada indeks yang dikonfigurasi dengan fungsi pengukuran jarak cosine. Periksa hal-hal berikut:

• Versi kluster: Plug-in aliyun-knn memerlukan Elasticsearch V6.7 dengan kernel V1.2 atau lebih baru, atau Elasticsearch V7.10 dengan kernel V1.4 atau lebih baru. Lihat Use the aliyun-knn plug-in untuk persyaratan versi.

• Metode kueri skrip: Kueri skrip harus menggunakan parameter script_score.

• Pelipatan bidang: Pastikan bidang yang ditentukan dalam kueri sesuai dengan struktur pelipatan pada pemetaan indeks. Jika indeks menggunakan bidang nested, kueri harus mereferensikan bidang nested tersebut secara tepat.

"API keys not enabled in Elasticsearch"

Kluster tidak memiliki autentikasi kunci API yang diaktifkan. Kunci API memerlukan HTTPS aktif pada kluster. Aktifkan HTTPS untuk mengatasi masalah ini. Lihat Enable HTTPS.