Migrasi objek yang disimpan dari OpenSearch Dasbor ke UI OpenSearch - OpenSearch Layanan Amazon
Ikhtisar migrasiPrasyaratLangkah 1: Ekspor objek yang disimpan dari OpenSearch DasborLangkah 2: Impor objek yang disimpan ke OpenSearch UI

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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 migrasi ke OpenSearch UI:

  • Ketersediaan tinggi — OpenSearch UI di-host di AWS Cloud dan tetap tersedia selama peningkatan dan pemeliharaan domain, sementara OpenSearch Dasbor di-host dalam domain dan untuk sementara tidak tersedia.

  • Beberapa Sumber Data — OpenSearch UI dapat menyediakan satu panel kaca terkonsolidasi di berbagai sumber data, termasuk OpenSearch domain, koleksi tanpa server, dan koneksi data dengan Amazon S3 dan CloudWatch Amazon; sementara OpenSearch setiap Dasbor hanya dapat berfungsi dengan satu domain atau koleksi.

  • Fitur tambahan seperti AI Assistant dan Workspaces tersedia di OpenSearch UI. Pelajari lebih lanjut:Menggunakan OpenSearch UI di Amazon OpenSearch Service.

Ikhtisar migrasi

Proses migrasi terdiri dari langkah-langkah tingkat tinggi berikut:

  1. 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.

  2. Buat aplikasi OpenSearch UI dan ruang kerja - Jika Anda belum melakukannya, buat aplikasi OpenSearch UI dan ruang kerja untuk menerima objek yang diimpor.

  3. Daftarkan sumber data di OpenSearch UI — Kaitkan OpenSearch domain Anda dengan aplikasi OpenSearch UI dan daftarkan sebagai sumber data di dalam ruang kerja. Pola indeks dalam objek impor Anda mereferensikan sumber data ini.

  4. 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.

  5. Validasi objek yang diimpor — Buka dasbor dan visualisasi Anda di OpenSearch UI untuk memverifikasi bahwa objek tersebut ditampilkan dengan benar dan data tersebut mengalir dari domain atau koleksi terkait.

Prasyarat

Sebelum migrasi, verifikasi prasyarat berikut:

catatan

OpenSearch UI hanya mendukung OpenSearch versi 1.3 dan yang lebih baru. Verifikasi bahwa OpenSearch domain Anda menjalankan versi 1.3 atau lebih tinggi sebelum mencoba memigrasi 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.

Ekspor secara manual di OpenSearch Dasbor

Untuk mengekspor objek yang disimpan menggunakan UI manajemen OpenSearch Dasbor

  1. Buka instance OpenSearch Dasbor Anda.

  2. Di panel navigasi kiri, pilih Manajemen.

  3. Di bawah Manajemen Dasbor, pilih Objek Tersimpan.

  4. 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.

  5. Pilih Ekspor.

  6. Dalam kotak dialog Ekspor objek yang disimpan, pastikan bahwa Sertakan 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 bermaksud mengelola dependensi secara manual.

  7. Pilih Ekspor untuk mengunduh .ndjson file ke mesin lokal Anda.

Tip

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

Mengekspor melalui API

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

catatan

Jika OpenSearch domain Anda telah mengaktifkan kontrol akses berbutir halus, Anda harus memberikan kredensi 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, lihatKontrol akses berbutir halus di Layanan Amazon OpenSearch.

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 berbutir halus, Anda dapat menghilangkan bendera. -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 objek yang disimpan IDs, Anda dapat menggunakan Saved Objects API untuk mencantumkan semua objek dari tipe 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 termasuk 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

  1. Buka aplikasi OpenSearch UI Anda dan arahkan ke ruang kerja target.

  2. Di ruang kerja, pilih Aset dari navigasi atas atau buka halaman aset ruang kerja.

  3. Pilih Impor untuk membuka dialog Impor aset.

  4. Pilih Pilih file dan pilih .ndjson file yang Anda ekspor dari OpenSearch Dasbor.

  5. Untuk manajemen Konflik, pilih salah satu dari berikut ini:

    • Buat aset baru dengan unik IDs (default) - Menghasilkan baru IDs 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:

      • Menimpa konflik secara otomatis - Aset yang ada dengan ID yang sama diganti secara otomatis.

      • Meminta tindakan atas konflik — Anda diminta untuk menyelesaikan setiap konflik secara individual.

  6. Pilih Impor.

  7. 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 ini menggunakan --aws-sigv4 opsi bawaan curl (tersedia di curl 7.75 atau yang lebih baru) untuk menandatangani permintaan. Tetapkan AWS kredensyal Anda sebagai variabel lingkungan sebelum menjalankan perintah:AWS_ACCESS_KEY_ID,AWS_SECRET_ACCESS_KEY, dan AWS_SESSION_TOKEN (jika menggunakan kredensyal sementara).