Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Memecahkan Masalah Dasbor OpenSearch
Bagian ini menjelaskan masalah yang diketahui yang dapat menyebabkan OpenSearch Dasbor menjadi tidak tersedia, gagal dimuat, atau berperilaku tidak terduga. Setiap masalah mencakup tindakan yang dapat Anda ambil untuk menyelesaikannya sendiri. Dasbor berjalan pada node data panas di domain Anda dan menyimpan statusnya (pola indeks, visualisasi, dan dasbor) di indeks Dasbor. OpenSearch Akibatnya, sebagian besar masalah ketersediaan Dasbor ditelusuri kembali ke kesehatan klaster, penyimpanan, migrasi indeks OpenSearch Dasbor, pengaturan cluster atau Dasbor, batas sumber daya, atau versi perangkat lunak layanan domain.
Setiap masalah diatur sebagai Gejala (apa yang Anda lihat dan bagaimana mengonfirmasinya), Akar penyebab, Cara mengurangi (langkah-langkah layanan mandiri), dan tindakan yang disarankan (cara mencegahnya berulang).
catatan
Banyak masalah Dasbor yang diketahui sudah diselesaikan dalam rilis perangkat lunak layanan yang lebih baru. Sebelum Anda memecahkan masalah lebih lanjut, buka konsol OpenSearch Layanan Amazon ( AWS konsol untuk layanan, bukan UI OpenSearch Dasbor), periksa panel Notifikasi, dan instal pembaruan perangkat lunak layanan terbaru yang tersedia. Beberapa bagian di bawah ini mencantumkan ini sebagai tindakan yang disarankan. Jika perubahan konfigurasi atau pemutakhiran sudah berlangsung, tunggu sampai selesai sebelum Anda menginstal pembaruan.
Dasbor macet di “server belum siap” (kesalahan HTTP 503 belum siap)
- Gejala
-
Dasbor ditampilkan
OpenSearch Dashboards server is not ready yet(kesalahan HTTP 503 tidak siap) dan tidak selesai memuat. Dasbor menampilkan halaman ini setiap kali belum selesai memulai. Versi singkat adalah normal selama restart, upgrade, atau blue/green deployment dan dihapus sendiri. Perlakukan itu sebagai masalah ketika itu berlanjut. Untuk mempersempit penyebabnya, periksa kesehatan Cluster domain dan apakah perubahan konfigurasi atau pemutakhiran sedang berlangsung:-
Jika perubahan atau peningkatan sedang berlangsung, pesan biasanya bersifat sementara; tunggu domain kembali ke Aktif.
-
Jika kesehatan cluster berwarna merah, Dasbor tidak dapat dimulai karena tergantung pada cluster; selesaikan masalah cluster terlebih dahulu (lihatMasalah klaster dan akses terkait).
-
Jika pesan tetap ada saat kesehatan klaster berwarna hijau, migrasi indeks OpenSearch Dasbor kemungkinan besar diblokir (dijelaskan di bawah).
-
- Penyebab galat
-
Dasbor melaporkan “server belum siap” sampai semua layanan intinya selesai diinisialisasi, itulah sebabnya versi sementara pesan diharapkan selama startup dan penerapan. blue/green Ketika berlanjut dengan cluster hijau, penyebab paling umum adalah migrasi indeks Dasbor diblokir: saat startup, OpenSearch Dasbor memigrasikan objek yang disimpan ke indeks baru di belakang alias, dan jika migrasi itu tidak dapat diselesaikan, Dasbor tidak pernah siap. Pemicu umum untuk migrasi yang diblokir:
-
Setelah pemutakhiran, migrasi yang diblokir dapat terjadi karena alasan berikut:
-
Indeks OpenSearch Dasbor yang tersisa dari versi sebelumnya mencegah alias baru dibuat.
-
Upgrade dari versi engine yang lebih lama yang Dashboardnya tidak menggunakan alias bertentangan dengan indeks yang ada.
-
Dokumen yang ditulis oleh instans Dasbor yang lebih baru (dikelola sendiri) tidak dapat dimigrasi secara otomatis ke versi target.
-
-
Tanpa upgrade, migrasi yang diblokir dapat terjadi karena alasan berikut:
-
Indeks OpenSearch Dasbor rusak yang dibuat oleh permintaan UI atau pemulihan memblokir alias.
-
Dua atau lebih indeks OpenSearch Dasbor berversi menunjuk pada alias yang sama. Ini juga dapat muncul sebagai
Internal Server Error(HTTP 500) bahkan ketika kesehatan cluster berwarna hijau. -
Per-user atau indeks per-penyewa dibuat tanpa alias pada domain yang menggunakan kontrol akses berbutir halus atau otentikasi Amazon Cognito.
-
Perubahan pemetaan objek tersimpan tidak dapat diterapkan karena dokumen yang rusak.
-
-
- Bagaimana cara mengurangi
-
-
Jika perubahan konfigurasi atau peningkatan versi sedang berlangsung, tunggu domain kembali ke Aktif. Pesannya sering bersifat sementara dan hilang dengan sendirinya. Perubahan atau peningkatan normal selesai dalam beberapa jam. Jika Dasbor masih tidak tersedia lebih dari 4 jam setelah domain kembali ke Aktif, perlakukan itu sebagai masalah yang terus-menerus. Lanjutkan dengan langkah-langkah berikut. (Anda tidak dapat memulai pembaruan perangkat lunak layanan saat domain masih memproses perubahan.)
-
Jika kesehatan cluster berwarna merah atau kuning, selesaikan masalah cluster terlebih dahulu (lihatMasalah klaster dan akses terkait). Dasbor tidak dapat dimulai pada cluster yang tidak sehat.
-
Jika pesan tetap ada saat kesehatan klaster berwarna hijau, kumpulkan beberapa diagnostik hanya-baca yang membantu AWS Support menyelesaikan masalah lebih cepat, lalu hubungi AWS Support
untuk memperbaiki indeks Dasbor. OpenSearch Sertakan output dari perintah berikut dalam kasus Anda: GET _cat/aliases/.kibana*?v GET _cat/indices/.kibana*?vMemperbaiki migrasi yang diblokir adalah perbaikan untuk domain yang sudah macet. Menginstal pembaruan perangkat lunak tidak, dengan sendirinya, membuka blokir domain yang sudah macet. Jangan hapus sendiri indeks OpenSearch Dasbor. Menghapusnya secara permanen akan menghapus semua visualisasi, dasbor, dan pola indeks yang disimpan yang tidak dicadangkan dalam snapshot. Jika perbaikan memerlukan penghapusan indeks yang berisi data, AWS Support meminta izin Anda terlebih dahulu. Untuk domain produksi yang tidak tersedia selama lebih dari satu jam tanpa perubahan konfigurasi yang sedang berlangsung, buka kasus Support Anda dengan tingkat keparahan gangguan sistem Produksi atau lebih tinggi.
-
Untuk mencegah kekambuhan, pertahankan domain pada pembaruan perangkat lunak layanan terbaru; rilis saat ini memperbaiki penyebab umum kegagalan migrasi. Instal pembaruan setelah domain kembali ke Aktif.
-
Ambil snapshot manual sebelum setiap versi upgrade sehingga Anda dapat memulihkan objek yang disimpan jika migrasi gagal. Untuk informasi selengkapnya tentang mengambil snapshot, lihatMembuat snapshot indeks di Amazon Service OpenSearch.
-
- Tindakan yang disarankan
-
Simpan domain Anda pada versi perangkat lunak layanan saat ini dan ambil snapshot sebelum setiap peningkatan. Jika Anda mengandalkan Dasbor untuk pemantauan produksi, pertimbangkan yang terpusatMenggunakan OpenSearch UI di Amazon OpenSearch Service, yang tidak terkait dengan migrasi indeks Dasbor per domain OpenSearch tunggal.
Dasbor gagal dimuat dengan pesan allow_explicit_index
- Gejala
-
Dasbor gagal memuat dan menampilkan pesan yang mirip dengan berikut ini:
Kibana must be able to specify the index within Elasticsearch multi-requests (rest.action.multi.allow_explicit_index=true). - Penyebab galat
-
Opsi cluster
rest.action.multi.allow_explicit_indexlanjutan diatur kefalse. Setel opsi initrueagar Dasbor dapat melakukan operasi massal, mget, dan msearch. - Bagaimana cara mengurangi
-
Atur
rest.action.multi.allow_explicit_indexkembali ketrueopsi lanjutan domain. Ini adalah perubahan bidang manajemen yang Anda buat dengan AWS kredensyal Anda sendiri, baik di konsol (buka domain, pilih Edit, dan perbarui pengaturan cluster lanjutan) atau dengan Antarmuka AWS Baris Perintah (CLI):AWSaws opensearch update-domain-config \ --domain-namemy-domain\ --advanced-options rest.action.multi.allow_explicit_index=trueMengubah opsi lanjutan memicu blue/green penerapan, sehingga perubahan membutuhkan waktu beberapa menit untuk diterapkan. Untuk informasi selengkapnya tentang pengaturan klaster lanjutan, lihatPengaturan cluster lanjutan.
- Tindakan yang disarankan
-
Jangan disetel
rest.action.multi.allow_explicit_indexkefalsekecuali Anda bermaksud membatasi akses indeks melalui kebijakan berbasis sumber daya. Membiarkannya di default (true) membuat Dasbor tetap beroperasi.
Dasbor kehabisan memori
- Gejala
-
Dasbor dimulai ulang, mogok, atau menjadi tidak responsif saat memuat, terutama saat membuka dasbor besar atau memuat banyak objek yang disimpan.
- Penyebab galat
-
Proses Dasbor kehabisan memori yang tersedia, seringkali karena memuat terlalu banyak objek yang disimpan atau merender dasbor yang berat.
- Bagaimana cara mengurangi
-
-
Instal pembaruan perangkat lunak layanan terbaru. Rilis saat ini mengukur tumpukan Dasbor secara dinamis dan menghapus batas ukuran tetap yang lebih lama.
-
Jika Anda meningkatkan
savedObjects:listingLimit(default1000) di Pengaturan Lanjut, kurangi. Nilai besar, seperti10000, telah menyebabkan kesalahan kehabisan memori. -
Kurangi kompleksitas dasbor, jumlah panel, dan frekuensi penyegaran otomatis.
-
Jika penggunaan memori kronis tinggi, skala ke jenis instance dengan lebih banyak memori. Untuk informasi selengkapnya tentang ukuran domain, lihat. Mengukur domain OpenSearch Layanan Amazon
-
- Tindakan yang disarankan
-
Untuk menangkap ini sebelum Dasbor kehabisan memori, perhatikan
OpenSearchDashboardsHeapUtilizationCloudWatch metriknya; jika secara konsisten melebihi 80%, skala ke jenis instans yang lebih besar. Right-size jenis instans Anda untuk penggunaan Dasbor Anda, jaga agar dasbor tetap ramping, dan hindari peningkatansavedObjects:listingLimitmelebihi yang Anda butuhkan.
Permintaan gagal karena ukuran muatan
- Gejala
-
Halaman Dasbor tertentu gagal dimuat karena payload permintaan melebihi batas payload Dasbor (, yang defaultnya adalah 1 MB
server.maxPayloadBytes/1.048.576 byte). - Penyebab galat
-
Pola indeks yang cocok dengan jumlah indeks atau bidang yang sangat besar menghasilkan permintaan yang lebih besar dari batas muatan.
- Bagaimana cara mengurangi
-
-
Kurangi ukuran permintaan daripada menaikkan batas:
-
Kurangi jumlah indeks dalam pola indeks Anda.
-
Kurangi jumlah bidang.
-
Kurangi panjang nama bidang.
-
-
Hubungi AWS Support
untuk meminta opsi tingkat akun yang didukung yang mempertahankan server.maxPayloadBytesnilai yang meningkat sehingga bertahan dari blue/green penerapan dan penggantian node. Opsi ini tersedia di semua versi OpenSearch Layanan Amazon yang didukung.
catatan
Jangan mencoba menaikkan batas ini dengan mengedit konfigurasi Dasbor pada node sendiri. Node-level perubahan tidak persisten. Setiap blue/green penyebaran atau penggantian node menghapusnya. Gunakan opsi tingkat akun melalui AWS Support sebagai gantinya.
-
- Tindakan yang disarankan
-
Jaga agar pola indeks tetap tercakup pada indeks dan bidang yang sebenarnya Anda gunakan sehingga permintaan tetap berada dalam batas muatan.
Dasbor tidak tersedia selama peningkatan versi
- Gejala
-
Dasbor tidak tersedia untuk sebagian besar durasi penerapan peningkatan versi blue/green mesin. Ini adalah perilaku yang diharapkan, bukan kesalahan, dan itu menyelesaikan sendiri ketika peningkatan selesai.
- Penyebab galat
-
Dasbor tetap offline untuk sebagian besar peningkatan versi untuk menghindari kondisi balapan pemeriksaan versi antara lingkungan lama dan baru.
- Bagaimana cara mengurangi
-
Tunggu hingga pemutakhiran selesai; Dasbor tersedia kembali secara otomatis. Perlakukan peningkatan versi sebagai jendela pemeliharaan Dasbor yang direncanakan dan jadwalkan di luar jam kritis bisnis. Untuk informasi selengkapnya tentang perubahan konfigurasi, lihatMembuat perubahan konfigurasi di Amazon OpenSearch Service.
- Tindakan yang disarankan
-
Jadwalkan peningkatan selama jendela lalu lintas rendah. Jika Anda memerlukan ketersediaan Dasbor yang tidak terikat pada jendela pemutakhiran domain tunggal, pertimbangkan yang terpusatMenggunakan OpenSearch UI di Amazon OpenSearch Service.
Pemutakhiran versi mesin gagal dalam pemeriksaan pra-peningkatan dengan indeks yang tidak kompatibel
- Gejala
-
Anda memulai pemutakhiran versi mesin (atau menjalankan pemeriksaan kelayakan pemutakhiran) dan gagal pada pemeriksaan pra-peningkatan, sebelum pemutakhiran dimulai. Pemberitahuan validasi mencantumkan satu atau beberapa indeks yang tidak kompatibel, dan dapat memberi nama indeks OpenSearch Dasbor secara khusus. Ini biasanya terjadi ketika Anda memutakhirkan ke OpenSearch 3.x sementara domain masih memiliki indeks yang dibuat di OpenSearch 1.3, Elasticsearch 7.10, atau sebelumnya, termasuk indeks Dasbor. OpenSearch (Upgrade dari OpenSearch 1.3 atau 2.x harus pergi ke OpenSearch 2.19 terlebih dahulu, kemudian ke OpenSearch 3.x.)
- Penyebab galat
-
OpenSearch dapat membaca indeks hanya dari versi mayor sebelumnya, jadi OpenSearch 3.x tidak mendukung indeks yang dibuat di OpenSearch 1.3, Elasticsearch 7.10, atau sebelumnya. Pemeriksaan pra-pemutakhiran memblokir pemutakhiran dan mencantumkan indeks ini dengan sengaja, sehingga Anda tidak kehilangan data apa pun. Anda harus mengindeks ulang atau menghapus indeks lama sebelum upgrade versi utama; layanan tidak mengindeks ulang mereka secara otomatis. Indeks OpenSearch Dasbor mengikuti aturan yang sama.
- Bagaimana cara mengurangi
-
-
Jalankan pemeriksaan kelayakan pemutakhiran untuk melihat daftar lengkap indeks yang tidak kompatibel (daftar yang sama ada di notifikasi pemutakhiran gagal). Untuk informasi selengkapnya tentang memutakhirkan domain, lihat. Memutakhirkan domain OpenSearch Layanan Amazon
-
Ambil snapshot manual sebelum melakukan perubahan. Untuk informasi selengkapnya tentang mengambil snapshot, lihatMembuat snapshot indeks di Amazon Service OpenSearch.
-
Untuk setiap indeks data yang tidak kompatibel, indeks ulang menjadi indeks baru (dibuat pada versi saat ini), lalu hapus yang lama. Untuk UltraWarm atau indeks dingin, pindahkan ke penyimpanan panas terlebih dahulu, indeks ulang, lalu pindahkan kembali.
POST _reindex { "source": { "index": "my-old-index" }, "dest": { "index": "my-new-index" } } -
Untuk indeks OpenSearch Dasbor, buat cadangan terlebih dahulu karena menyimpan pola indeks, visualisasi, dan dasbor Anda: di Dasbor, buka Manajemen Dasbor, Objek Tersimpan, dan ekspor. Kemudian hapus indeks yang tidak kompatibel. Indeks baru yang kompatibel dibuat secara otomatis setelah pemutakhiran; impor ulang objek yang disimpan sesudahnya. Jika Anda lebih suka tidak menghapusnya, hubungi AWS Support
. -
Hapus indeks yang tidak kompatibel yang tidak lagi Anda perlukan alih-alih mengindeks ulang.
-
Re-run pemeriksaan kelayakan, dan memicu kembali peningkatan setelah lolos.
-
- Tindakan yang disarankan
-
Mengindeks ulang atau menghentikan indeks lama sehingga tidak menjangkau lebih dari satu versi utama; indeks yang tersisa di beberapa peningkatan pada akhirnya akan memblokir satu. Ambil snapshot manual sebelum setiap peningkatan, dan ekspor objek yang disimpan OpenSearch Dasbor Anda secara berkala sebagai cadangan.
Dasbor tidak dimuat dengan benar, menampilkan halaman kosong, atau menghasilkan laporan kosong
- Gejala
-
Satu pengguna atau browser melihat halaman kosong, laporan kosong, atau spanduk merah yang berbunyi
OpenSearch Dashboards did not load properly. Check the server output for more information., sementara pengguna lain tidak terpengaruh. Konfirmasikan dengan mereproduksi di jendela pribadi (penyamaran) atau browser lain. - Penyebab galat
-
Cache browser yang basi menyebabkan masalah ini, terutama setelah pembaruan perangkat lunak layanan atau saat Anda menggunakan fitur Pelaporan.
- Bagaimana cara mengurangi
-
-
Bersihkan cache dan cookie browser Anda, lalu muat ulang halaman. Coba jendela pribadi (penyamaran) dan browser terbaru yang didukung.
-
Nonaktifkan pemblokir iklan atau ekstensi browser untuk URL Dasbor.
-
Jika banner tetap ada untuk semua pengguna (bukan hanya satu browser), instal pembaruan perangkat lunak layanan terbaru, lalu hubungi AWS Support
jika masalah berlanjut.
-
- Tindakan yang disarankan
-
Bersihkan cache browser Anda setelah pembaruan perangkat lunak layanan, dan gunakan browser terbaru yang didukung.
Konfigurasi yang tidak didukung
Hindari konfigurasi ini, yang merupakan sumber umum masalah Dasbor:
-
Proksi terbalik (misalnya, nginx) di depan Dasbor hanya didukung untuk kontrol akses, seperti yang dijelaskan dalam. Menggunakan proxy untuk mengakses OpenSearch Layanan dari Dasbor Jika Anda menjalankan Dasbor melalui perangkat lunak proxy pihak ketiga dan mengalami kesalahan yang tidak terduga, buat ulang masalah tanpa proxy sebelum Anda menghubungi AWS Support.
-
Pengeditan manual ke file konfigurasi node tidak persisten. Setiap blue/green penerapan atau penggantian simpul mengembalikannya. Gunakan pengaturan dan opsi yang didukung alih-alih pengeditan tingkat simpul. Anda tidak dapat menggunakan SSH untuk mengakses node atau langsung memodifikasi file konfigurasi.
Masalah klaster dan akses terkait
Karena Dasbor bergantung pada klaster yang sehat dan konfigurasi akses domain Anda, topik pemecahan masalah berikut sering berlaku saat Dasbor tidak tersedia. Untuk semua ini, lihatMemecahkan Masalah Layanan Amazon OpenSearch.
-
Tidak dapat mengakses OpenSearch Dasbor: kebijakan akses dan autentikasi Amazon Cognito, termasuk kesalahan VPC-access dan batas waktu
User: anonymous is not authorized to perform: es:ESHttpGetpermintaan. -
Status klaster merah dan status klaster Kuning: pecahan yang tidak ditetapkan mencegah Dasbor membaca atau menulis indeks Dasbornya OpenSearch .
-
ClusterBlockException: ruang penyimpanan rendah atau blok tekanan memori JVM tinggi menulis, termasuk menulis ke indeks OpenSearch Dasbor.
-
JVM OutOfMemoryError dan Request throttling: cluster overload muncul sebagai kesalahan dan respons Dasbor.
429 Too Many Requests