Ikhtisar migrasi Prasyarat Langkah 1: Ekspor objek yang disimpan dari OpenSearch Dasbor Langkah 2: Impor objek yang disimpan ke OpenSearch UI

Migrasi objek yang disimpan dari OpenSearch Dasbor ke UI OpenSearch

Jika Anda memiliki dasbor, visualisasi, pola indeks, dan objek lain yang disimpan di OpenSearch Dasbor, Anda dapat memigrasi dan menggunakannya kembali di UI. OpenSearch

Manfaat bermigrasi ke OpenSearch UI:

Ketersediaan tinggi — OpenSearch UI dihosting di AWS Cloud dan tetap tersedia selama peningkatan dan pemeliharaan domain, sementara OpenSearch Dasbor dihosting dalam domain dan untuk sementara tidak tersedia.
Beberapa Sumber Data — OpenSearch UI dapat menyediakan panel kaca tunggal terkonsolidasi di beberapa sumber data, termasuk OpenSearch domain, koleksi tanpa server, dan koneksi data dengan Amazon S3 dan Amazon CloudWatch; sementara setiap OpenSearch Dasbor hanya dapat bekerja dengan satu domain atau koleksi.
Fitur tambahan seperti Asisten AI dan Ruang Kerja tersedia di OpenSearch UI. Pelajari lebih lanjut:Menggunakan OpenSearch UI di OpenSearch Layanan Amazon.

Topik

Ikhtisar migrasi
Prasyarat
Langkah 1: Ekspor objek yang disimpan dari OpenSearch Dasbor
Langkah 2: Impor objek yang disimpan ke OpenSearch UI

Ikhtisar migrasi

Proses migrasi terdiri dari langkah-langkah tingkat tinggi berikut:

Ekspor objek yang disimpan dari OpenSearch Dasbor — Gunakan UI manajemen Objek Tersimpan OpenSearch Dasbor atau API ekspor untuk mengunduh dasbor, visualisasi, pola indeks, dan objek lainnya sebagai file JSON (NDJSON) yang dibatasi baris baru.
Buat aplikasi OpenSearch UI dan ruang kerja - Jika Anda belum melakukannya, buat aplikasi OpenSearch UI dan ruang kerja untuk menerima objek yang diimpor.
Daftarkan sumber data di OpenSearch UI — Asosi OpenSearch asikan domain Anda dengan aplikasi OpenSearch UI dan daftarkan sebagai sumber data di dalam ruang kerja. Pola indeks pada objek yang diimpor mereferensikan sumber data ini.
Impor objek yang disimpan ke OpenSearch UI — Gunakan OpenSearch UI manajemen Objek Tersimpan UI atau API impor untuk mengunggah file NDJSON ke ruang kerja target.
Validasi objek yang diimpor — Buka dasbor dan visualisasi Anda di OpenSearch UI untuk memverifikasi bahwa objek tersebut ditampilkan dengan benar dan bahwa data mengalir dari domain atau koleksi terkait.

Prasyarat

Sebelum migrasi, verifikasi prasyarat berikut:

Anda memiliki izin IAM yang diperlukan untuk memanggil OpenSearch Layanan Amazon dan OpenSearch API. Untuk informasi selengkapnya, lihat Izin yang diperlukan untuk membuat aplikasi OpenSearch Layanan Amazon.
Anda dapat mengakses domain atau koleksi dan OpenSearch Dasbor yang ingin Anda migrasi.
Anda telah membuat aplikasi OpenSearch UI. Untuk informasi tentang membuat aplikasi dan ruang kerja, lihatMemulai dengan antarmuka OpenSearch pengguna di OpenSearch Layanan Amazon.
Anda telah mengaitkan domain atau koleksi yang sama ke aplikasi OpenSearch UI. Untuk informasi tentang mengaitkan sumber data, lihatMengelola asosiasi sumber data dan izin akses Virtual Private Cloud.

catatan

OpenSearch UI hanya mendukung OpenSearch versi 1.3 dan yang lebih baru. Pastikan OpenSearch domain Anda menjalankan versi 1.3 atau lebih tinggi sebelum mencoba memigrasikan objek yang disimpan.

Langkah 1: Ekspor objek yang disimpan dari OpenSearch Dasbor

Ekspor objek yang disimpan dari OpenSearch Dasbor menggunakan UI manajemen atau API ekspor. Ekspor menghasilkan file JSON (NDJSON) yang dibatasi baris baru yang berisi semua jenis objek tersimpan yang dipilih dan dependensinya.

Topik

Ekspor secara manual di OpenSearch Dasbor
Mengekspor melalui API

Ekspor secara manual di OpenSearch Dasbor

Untuk mengekspor objek yang disimpan menggunakan UI manajemen OpenSearch Dashboard

Buka instance OpenSearch Dashboard Anda.
Di panel navigasi kiri, pilih Manajemen.
Di bawah Manajemen Dasbor, pilih Objek Tersimpan.
Pilih objek yang disimpan yang ingin Anda ekspor. Untuk mengekspor semua objek dari jenis tertentu, filter berdasarkan jenis menggunakan bilah pencarian. Untuk mengekspor semua objek, pilih kotak centang di header tabel.
Pilih Ekspor.
Di kotak dialog Ekspor objek yang disimpan, pastikan Termasuk objek terkait dipilih. Opsi ini mencakup semua objek yang bergantung pada objek tersimpan yang dipilih, seperti pola indeks yang direferensikan oleh visualisasi. Hapus opsi ini hanya jika Anda ingin mengelola dependensi secara manual.
Pilih Ek spor untuk mengunduh .ndjson file ke mesin lokal Anda.

Tip

Bila Anda memilih Ser takan objek terkait, file NDJSON yang diekspor berisi semua objek tersimpan yang diperlukan untuk merender dasbor dan visualisasi yang dipilih, termasuk pola indeks dependen, visualisasi, dan objek pencarian. Ini menyederhanakan langkah impor dan menghindari kesalahan referensi yang hilang.

Mengekspor melalui API

Anda dapat menggunakan API ekspor Ob OpenSearch jek Tersimpan Dasbor untuk mengekspor objek yang disimpan secara terprogram. Ini berguna untuk mengotomatiskan migrasi atau mengintegrasikan langkah ekspor ke dalam CI/CD pipa.

catatan

Jika OpenSearch domain Anda mengaktifkan kontrol akses halus, Anda harus memberikan kredentif otentikasi dengan permintaan ekspor Anda. Gunakan otentikasi dasar HTTP dengan menambahkan -u bendera dengan nama pengguna dan kata sandi Anda. Untuk informasi selengkapnya tentang opsi otentikasi, lihatFine-grained kontrol akses di OpenSearch Layanan Amazon.

Contoh berikut mengekspor semua dasbor dengan objek terkait. Ganti placeholder values dengan informasi Anda sendiri.


curl -X POST \
    "https://dashboards-endpoint/_dashboards/api/saved_objects/_export" \
    -u 'master-username:master-password' \
    -H "Content-Type: application/json" \
    -H "osd-xsrf: true" \
    -d '{
        "type": ["dashboard", "visualization", "index-pattern", "search"],
        "includeReferencesDeep": true,
        "excludeExportDetails": false
    }' \
    -o saved-objects-export.ndjson

Jika domain Anda tidak mengaktifkan kontrol akses halus, Anda dapat menghilangkan bendera tersebut. -u

Untuk mengekspor objek tertentu yang disimpan berdasarkan ID, gunakan objects parameter alih-alihtype:


curl -X POST \
    "https://dashboards-endpoint/_dashboards/api/saved_objects/_export" \
    -u 'master-username:master-password' \
    -H "Content-Type: application/json" \
    -H "osd-xsrf: true" \
    -d '{
        "objects": [
            {"type": "dashboard", "id": "dashboard-id"},
            {"type": "visualization", "id": "visualization-id"}
        ],
        "includeReferencesDeep": true
    }' \
    -o saved-objects-export.ndjson

catatan

Untuk menemukan ID objek yang disimpan, Anda dapat menggunakan API Objek Tersimpan untuk mencantumkan semua objek dari jenis tertentu. Contoh berikut mencantumkan semua dasbor:


curl -X GET \
    "https://dashboards-endpoint/_dashboards/api/saved_objects/_find?type=dashboard" \
    -u 'master-username:master-password'

Respons mencakup ID untuk setiap objek yang disimpan. Anda juga dapat menemukan ID di URL browser saat melihat objek di OpenSearch Dasbor.

Langkah 2: Impor objek yang disimpan ke OpenSearch UI

Setelah mengekspor objek yang disimpan, Anda dapat mengimpor file NDJSON ke OpenSearch UI secara manual atau melalui API.

Impor secara manual di OpenSearch UI

Untuk mengimpor objek yang disimpan menggunakan OpenSearch UI manajemen UI

Buka aplikasi OpenSearch UI Anda dan navigasikan ke ruang kerja target.
Di ruang kerja, pilih A set dari navigasi atas atau buka halaman aset ruang kerja.
Pilih Imp or untuk membuka dialog Impor aset.
Pilih Pilih file dan pilih .ndjson file yang Anda ekspor dari OpenSearch Dasbor.
Untuk manajemen konflik, pilih salah satu dari berikut ini:
- Buat aset baru dengan ID unik (default) — Menghasilkan ID baru untuk semua objek yang diimpor, menghindari konflik dengan aset yang ada.
- Periksa aset yang ada — Memeriksa konflik dengan objek yang ada. Saat dipilih, pilih salah satu dari sub-opsi berikut:
  - Secara otomatis mengganti konflik — Aset yang ada dengan ID yang sama diganti secara otomatis.
  - Minta tindakan pada konflik — Anda diminta untuk menyelesaikan setiap konflik secara individual.
Pilih Impor.
Tinjau ringkasan impor.

Impor melalui API

Untuk mengimpor objek yang disimpan menggunakan API dengan otentikasi AWS Signature Version 4, Anda harus terlebih dahulu mendapatkan ID sumber data, lalu menggunakannya dalam permintaan impor. Ganti placeholder values dengan informasi Anda sendiri.

Langkah 1: Dapatkan ID sumber data untuk ruang kerja Anda:


curl -X GET \
    "https://opensearch-ui-endpoint/w/workspace-id/api/saved_objects/_find?type=data-source" \
    --aws-sigv4 "aws:amz:region:opensearch" \
    --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
    -H "x-amz-security-token: $AWS_SESSION_TOKEN" \
    -H "osd-xsrf: true"

catatan

Respons termasuk ID sumber data. Anda juga dapat menemukan ID sumber data di URL browser saat melihat sumber data di OpenSearch UI.

Langkah 2: Impor objek yang disimpan menggunakan ID sumber data dari Langkah 1:


curl -X POST \
    "https://opensearch-ui-endpoint/w/workspace-id/api/saved_objects/_import?overwrite=true&dataSourceId=data-source-id" \
    --aws-sigv4 "aws:amz:region:opensearch" \
    --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
    -H "x-amz-security-token: $AWS_SESSION_TOKEN" \
    -H "osd-xsrf: true" \
    -F "file=@saved-objects-export.ndjson"

catatan

Contoh-contoh ini menggunakan --aws-sigv4 opsi bawaan curl (tersedia di curl 7.75 atau yang lebih baru) untuk menandatangani permintaan. Tetapkan AWS kredenSIAL Anda sebagai variabel lingkungan sebelum menjalankan perintah:AWS_ACCESS_KEY_ID,AWS_SECRET_ACCESS_KEY, dan AWS_SESSION_TOKEN (jika menggunakan kredenSIAL sementara).

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Referensi konfigurasi

Pemantauan CloudWatch dengan