Mengembalikan indeks .kibana_{num} dari Snapshot - Elasticsearch

Jika kluster Kibana Anda di-reset karena suatu masalah, indeks konfigurasinya—seperti .kibana_{num} (di mana {num} adalah variabel, misalnya .kibana_1 atau .kibana_2)—juga akan di-reset. Anda harus mengembalikan indeks yang sesuai untuk memulihkan data Anda. Topik ini menjelaskan cara mengembalikan indeks .kibana_{num} dari Snapshot atau menggunakan metode reindex, dengan contoh indeks .kibana_1.

Latar Belakang

Indeks .kibana_{num} menyimpan informasi konfigurasi Kibana, termasuk dashboard dan pola indeks. Secara default, Kibana menggunakan alias .kibana untuk membaca data. Jika terdapat beberapa indeks .kibana_{num}, hanya salah satu yang menggunakan alias .kibana.

Data Kibana Anda dapat di-reset karena berbagai alasan. Misalnya, jika indeks .kibana_1 rusak atau Kibana menjadi tidak dapat diakses, Anda mungkin perlu menghapus indeks .kibana_1 untuk me-reset kluster Kibana. Demikian pula, jika tugas terjadwal yang dikonfigurasi secara salah menghapus indeks .kibana_1, data Kibana Anda akan di-reset setelah kluster di-restart. Dalam kasus tersebut, .kibana_task_manager_1 secara otomatis membuat indeks .kibana_1 baru yang ditautkan ke alias .kibana. Semua informasi yang sebelumnya dikonfigurasi—seperti pola indeks Kibana, dashboard, dan peran pengguna—akan di-reset.

Anda dapat mengembalikan indeks .kibana_1 dengan salah satu cara berikut:

Pulihkan langsung dari Snapshot.
Mengembalikan data Snapshot ke indeks cadangan, lalu menggunakan metode reindex untuk menulis data dari indeks cadangan ke indeks .kibana_1.
Membangun ulang secara manual pola indeks atau peran pengguna Kibana.

Prasyarat

Kluster Anda telah mengaktifkan fitur backup Snapshot otomatis, atau Anda telah melakukan pencadangan manual indeks sistem dalam sebuah Snapshot. Snapshot tersebut harus berisi versi sehat dari indeks .kibana_1.
Pastikan alias .kibana tersedia di kluster dan mengarah ke indeks .kibana_1. Jika indeks .kibana_1 tidak ada, kami menyarankan Anda me-restart layanan Kibana untuk menginisialisasi indeks .kibana_1 baru.

Prosedur

Snapshot restore

Login ke Konsol Kibana kluster Elasticsearch Anda dan buka halaman utama Kibana.
Di bilah navigasi kiri, klik Dev tools.
Pada tab Console, jalankan perintah berikut untuk menampilkan daftar Snapshot di repositori.
```
GET _cat/snapshots/aliyun_auto_snapshot?v
```
aliyun_auto_snapshot adalah nama repositori tempat Snapshot disimpan. Jika Anda menggunakan fitur backup Snapshot otomatis Alibaba Cloud Elasticsearch untuk mencadangkan data kluster secara berkala, nama repositorinya selalu aliyun_auto_snapshot. Jika Anda menggunakan backup manual, ganti aliyun_auto_snapshot dengan nama repositori Anda.
Perintah yang berhasil akan mengembalikan detail semua Snapshot di repositori, seperti id dan status Snapshot tersebut.
Catatan
Catat id Snapshot terbaru yang dibuat sebelum masalah terjadi. Anda akan membutuhkannya nanti.
Sebelum mengembalikan Snapshot, ambil detailnya untuk memverifikasi bahwa Snapshot tersebut berisi indeks .kibana_1.
```
GET _snapshot/aliyun_auto_snapshot/<yourSnapshotId>
```
<yourSnapshotId>: id Snapshot terbaru yang dibuat sebelum masalah Kibana terjadi. Masukkan id yang Anda peroleh pada langkah sebelumnya. Contohnya, es-cn-m7r23wodb006n****_20220303020235.
Perintah yang berhasil akan mengembalikan detail Snapshot. Anda hanya dapat melanjutkan proses pemulihan jika output berisi indeks .kibana_1.
Tutup indeks .kibana_1.
Penting
Jika Anda menutup indeks .kibana_1 lalu me-restart Kibana, Anda mungkin tidak dapat login. Dalam kasus ini, gunakan perintah curl untuk mengembalikan indeks .kibana_1. Untuk informasi lebih lanjut, lihat FAQ.
```
POST /.kibana_1/_close
```
Jika perintah berhasil, hasil berikut akan dikembalikan.
```
{
  "acknowledged" : true,
  "shards_acknowledged" : true,
  "indices" : {
    ".kibana_1" : {
      "closed" : true
    }
  }
}
```

Jalankan perintah pemulihan Snapshot untuk mengembalikan indeks .kibana_1.

POST _snapshot/aliyun_auto_snapshot/<yourSnapshotId>/_restore
{
   "indices": ".kibana_1",
   "rename_pattern": ".kibana_1",
   "rename_replacement": ".kibana_1"
}

Parameter	Deskripsi
<yourSnapshotId>	id Snapshot backup otomatis. Masukkan id yang Anda peroleh pada Langkah 3.
indices	Nama indeks yang akan dipulihkan.
rename_pattern	Opsional. Ekspresi reguler yang cocok dengan nama indeks yang akan dipulihkan.
rename_replacement	Opsional. Mengganti nama indeks yang cocok sesuai ketentuan.

Jika perintah berhasil, "accepted" : true akan dikembalikan.

Penting

Jika Anda menggunakan instans dengan versi selain 7.10 dan muncul error index_closed_exception index=".kibana_1" saat menjalankan perintah pemulihan Snapshot untuk mengembalikan indeks .kibana_1, lihat FAQ untuk solusinya.

Verifikasi pemulihan.
Periksa apakah pola indeks Kibana telah dipulihkan. Jika ya, pemulihan berhasil.
1. Di pojok kiri atas Konsol Kibana, klik ikon .
2. Di panel navigasi kiri, buka Management > Stack Management.
3. Di bagian Kibana, klik Index Patterns.
4. Pada halaman Index Patterns, klik pola indeks yang diawali dengan kibana_ untuk memeriksa apakah datanya telah dipulihkan.

Reindex restore

Sebelum memulihkan dari Snapshot, ambil informasi tentang Snapshot tersebut dan periksa apakah berisi indeks .kibana_1.
Untuk informasi lebih lanjut, lihat Langkah 1 hingga Langkah 4 di Snapshot restore.
Catatan
Lanjutkan hanya jika Snapshot berisi indeks .kibana_1.

Jalankan perintah pemulihan Snapshot untuk mengembalikan indeks .kibana_1 dari Snapshot ke indeks cadangan. Dalam contoh ini, indeks cadangan diberi nama kibana123.

POST _snapshot/aliyun_auto_snapshot/<yourSnapshotId>/_restore
{
   "indices": ".kibana_1",
   "rename_pattern": ".kibana_1",
   "rename_replacement": "kibana123"
}

Parameter	Deskripsi
<yourSnapshotId>	id Snapshot backup otomatis. Masukkan id yang Anda peroleh pada Langkah 1.
indices	Nama indeks yang akan dipulihkan.
rename_pattern	Opsional. Ekspresi reguler yang cocok dengan nama indeks yang akan dipulihkan.
rename_replacement	Nama indeks cadangan.

Jika perintah berhasil, "accepted" : true akan dikembalikan.

Jalankan perintah reindex untuk menulis data dari indeks cadangan ke indeks .kibana_1 saat ini.

POST _reindex
{
  "source": {
    "index": "kibana123"
  },
  "dest": {
    "index": ".kibana_1"
  }
}

Jika perintah berhasil, hasil berikut akan dikembalikan.

{
  "took" : 731,
  "timed_out" : false,
  "total" : 33,
  "updated" : 33,
  "created" : 0,
  "deleted" : 0,
  "batches" : 1,
  "version_conflicts" : 0,
  "noops" : 0,
  "retries" : {
    "bulk" : 0,
    "search" : 0
  },
  "throttled_millis" : 0,
  "requests_per_second" : -1.0,
  "throttled_until_millis" : 0,
  "failures" : [ ]
}

Hapus indeks cadangan. Dalam contoh ini, indeks cadangan diberi nama kibana123.
```
DELETE kibana123
```
Jika perintah berhasil, "accepted" : true akan dikembalikan.
Verifikasi pemulihan.
Periksa apakah pola indeks Kibana telah dipulihkan. Jika ya, pemulihan berhasil. Untuk informasi lebih lanjut, lihat Langkah 7 di bagian Snapshot restore.

FAQ

T: Saat saya mencoba mengembalikan indeks .kibana dari Snapshot, saya mendapatkan error konflik alias antara .kibana dan .kibana_1. Bagaimana cara memperbaikinya?

J: Setelah indeks .kibana_1 dihapus, Elasticsearch tidak dapat lagi menggunakan alias untuk membaca atau menulis data dan secara otomatis membuat indeks .kibana. Konflik alias terjadi saat pemulihan karena indeks .kibana_1 yang benar dalam Snapshot menggunakan .kibana sebagai alias. Kami menyarankan Anda menghapus indeks .kibana sebelum melakukan pemulihan.

T: Pada instans dengan versi selain 7.10, saya mendapatkan error index_closed_exception saat menjalankan perintah pemulihan Snapshot untuk mengembalikan indeks .kibana_1. Bagaimana cara memperbaikinya?

J: Error ini terjadi karena indeks .kibana_1 sedang ditutup, sehingga mencegah Anda menjalankan perintah apa pun di Konsol Kibana. Kami menyarankan Anda menghubungkan ke Elasticsearch dari Instance ECS dan menjalankan perintah curl yang sesuai. Untuk informasi lebih lanjut, lihat Connect to a cluster from the command line. Sebagai contoh, perintah curl berikut mengembalikan indeks .kibana_1 dari Snapshot.

curl -u <user>:<password> -XPOST "http://<host>:<port>/_snapshot/aliyun_auto_snapshot/<yourSnapshotId>/_restore" -H 'Content-Type: application/json' -d'{"indices": ".kibana_1","rename_pattern": ".kibana_1","rename_replacement": ".kibana_1"}'