Amazon OpenSearch Service rename - Ringkasan perubahan - OpenSearch Layanan Amazon

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

Amazon OpenSearch Service rename - Ringkasan perubahan

Pada 8 September 2021, rangkaian pencarian dan analitik kami diubah namanya menjadi Amazon OpenSearch Service. OpenSearch Layanan mendukung OpenSearch serta warisan Elasticsearch OSS. Bagian berikut menjelaskan berbagai bagian layanan yang berubah dengan penggantian nama, dan tindakan apa yang perlu Anda lakukan untuk memastikan bahwa domain Anda terus berfungsi dengan baik.

Beberapa perubahan ini hanya berlaku saat Anda meningkatkan domain dari Elasticsearch ke OpenSearch. Dalam kasus lain, seperti di konsol Billing and Cost Management, pengalaman akan segera berubah.

Perhatikan bahwa daftar ini bukan daftar lengkap. Sementara bagian lain dari produk juga berubah, pembaruan ini adalah yang paling relevan.

Versi API baru

Versi baru API konfigurasi OpenSearch Layanan (2021-01-01) berfungsi dengan OpenSearch serta Elasticsearch OSS lama. 21 operasi API diganti dengan nama yang lebih ringkas dan engine-agnostik (misalnya,CreateElasticsearchDomain diubah menjadiCreateDomain), tetapi OpenSearch Service terus mendukung kedua versi API.

Kami menyarankan agar Anda menggunakan operasi API baru untuk membuat dan mengelola domain ke depan. Perhatikan bahwa ketika Anda menggunakan operasi API baru untuk membuat domain, Anda perlu menentukanEngineVersion parameter dalam formatElasticsearch_X.Y atauOpenSearch_X.Y, bukan hanya nomor versi. Jika Anda tidak menentukan versinya, itu akan mengatur default ke versi terbaru dari OpenSearch.

Upgrade AndaAWS CLI ke versi 1.20.40 atau yang lebih baruaws opensearch ... untuk digunakan untuk membuat dan mengelola domain Anda. Untuk format CLI baru, lihat referensiOpenSearch CLI.

Tipe instans berganti nama

Jenis instans di Amazon OpenSearch Service sekarang dalam format<type>.<size>.search —misalnya,m6g.large.search bukanm6g.large.elasticsearch. Anda tidak perlu mengambil tindakan apa pun. Domain yang ada akan mulai secara otomatis merujuk ke jenis instans baru di dalam API dan di konsol Billing and Cost Management.

Jika Anda memiliki Instans Cadangan (RI), kontrak Anda tidak akan terpengaruh oleh perubahan tersebut. Versi API konfigurasi lama masih kompatibel dengan format penamaan lama, tetapi jika Anda ingin menggunakan versi API baru, Anda perlu menggunakan format baru.

Perubahan kebijakan akses

Bagian berikut menjelaskan tindakan apa yang perlu Anda lakukan untuk memperbarui kebijakan akses Anda.

Kebijakan IAM

Kami menyarankan agar Anda memperbarui kebijakan IAM untuk menggunakan operasi API berganti nama. Namun, OpenSearch Layanan akan terus menghormati kebijakan yang ada dengan mereplikasi izin API lama secara internal. Misalnya, jika saat ini Anda memiliki izin untuk melakukanCreateElasticsearchDomain operasi, Anda sekarang dapat melakukan panggilan ke keduanyaCreateElasticsearchDomain (operasi API lama) danCreateDomain (operasi API baru). Hal yang sama berlaku untuk penyangkalan eksplisit. Untuk melihat daftar operasi API yang diperbarui, lihat referensi elemen kebijakan.

Kebijakan SCP

Kebijakan kontrol layanan (SCP) memperkenalkan lapisan kompleksitas tambahan dibandingkan dengan IAM standar. Untuk mencegah kebijakan SCP Anda melanggar, Anda perlu menambahkan operasi API lama dan baru ke setiap kebijakan SCP Anda. Misalnya, jika pengguna saat ini mengizinkan izinCreateElasticsearchDomain, Anda juga perlu memberi mereka izin izinCreateDomain agar mereka dapat mempertahankan kemampuan untuk membuat domain. Hal yang sama berlaku untuk penyangkalan eksplisit.

Misalnya:

"Statement": [ { "Effect": "Allow", "Action": [ "es:CreateElasticsearchDomain", "es:CreateDomain" ... ], }, "Effect": "Deny", "Action:" [ "es:DeleteElasticsearchDomain", "es:DeleteDomain" ...

Tipe sumber daya baru

OpenSearch Layanan memperkenalkan jenis sumber daya baru berikut:

Sumber Daya Deskripsi

AWS::OpenSearchService::Domain

Merupakan domain OpenSearch Layanan Amazon. Sumber daya ini ada di tingkat layanan dan tidak spesifik untuk perangkat lunak yang berjalan di domain. Ini berlaku untuk layanan seperti AWS CloudFormationdan AWSResource Groups, di mana Anda membuat dan mengelola sumber daya untuk layanan secara keseluruhan.

Untuk petunjuk untuk meningkatkan domain yang didefinisikan dalam CloudFormation dari Elasticsearch ke OpenSearch, lihat Keterangan di Panduan CloudFormation Pengguna.

AWS::OpenSearch::Domain

OpenSearchMewakili/Elasticsearch perangkat lunak yang berjalan pada domain. Sumber daya ini berlaku untuk layanan seperti AWS CloudTraildan AWS Config, yang mereferensikan perangkat lunak yang berjalan pada domain, bukan OpenSearch Layanan secara keseluruhan. Layanan ini sekarang berisi jenis sumber daya terpisah untuk domain yang menjalankan Elasticsearch (AWS::Elasticsearch::Domain) versus domain running OpenSearch (AWS::OpenSearch::Domain).
catatan

Di AWS Config, Anda akan terus melihat data Anda di bawah jenisAWS::Elasticsearch::Domain sumber daya yang ada selama beberapa minggu, bahkan jika Anda meningkatkan satu atau beberapa domain ke OpenSearch.

Kibana berganti nama menjadi OpenSearch Dasbor

OpenSearch Dasbor,AWS alternatif untuk Kibana, adalah alat visualisasi open-source yang dirancang untuk digunakan OpenSearch. Setelah Anda memutakhirkan domain dari Elasticsearch ke OpenSearch,/_plugin/kibana titik akhir akan berubah menjadi/_dashboards. OpenSearch Layanan akan mengalihkan semua permintaan ke endpoint baru, tetapi jika Anda menggunakan endpoint Kibana dalam salah satu kebijakan IAM Anda, perbarui kebijakan tersebut untuk menyertakan/_dashboards endpoint baru juga.

Jika Anda menggunakanOtentikasi SAMP untuk Dasbor OpenSearch , sebelum meningkatkan domain OpenSearch, Anda perlu mengubah semua URL Kibana yang dikonfigurasi di penyedia identitas (IdP) dari/_plugin/kibana ke/_dashboards. URL yang paling umum adalah URL assertion consumer service (ACS) dan URL penerima.

kibana_read_onlyPeran default untuk OpenSearch Dasbor diubah namanya menjadiopensearch_dashboards_read_only, dankibana_user peran diubah namanyaopensearch_dashboards_user. Perubahan ini berlaku untuk semua yang baru dibuat OpenSearch 1. x domain yang menjalankan perangkat lunak layanan R20211203 atau yang lebih baru. Jika Anda meningkatkan domain yang ada ke perangkat lunak layanan R20211203, nama peran tetap sama.

CloudWatch Metrik berganti nama

Beberapa CloudWatch metrik berubah untuk domain yang berjalan OpenSearch. Saat Anda meningkatkan domain ke OpenSearch, metrik berubah secara otomatis dan CloudWatch alarm Anda saat ini akan rusak. Sebelum memutakhirkan klaster Anda dari versi Elasticsearch ke OpenSearch versi, pastikan untuk memperbarui CloudWatch alarm Anda untuk menggunakan metrik baru.

Metrik berikut berubah:

Nama metrik asli Nama baru

KibanaHealthyNodes

OpenSearchDashboardsHealthyNodes

KibanaConcurrentConnections

OpenSearchDashboardsConcurrentConnections

KibanaHeapTotal

OpenSearchDashboardsHeapTotal

KibanaHeapUsed

OpenSearchDashboardsHeapUsed

KibanaHeapUtilization

OpenSearchDashboardsHeapUtilization

KibanaOS1MinuteLoad

OpenSearchDashboardsOS1MinuteLoad

KibanaRequestTotal

OpenSearchDashboardsRequestTotal

KibanaResponseTimesMaxInMillis

OpenSearchDashboardsResponseTimesMaxInMillis

ESReportingFailedRequestSysErrCount

KibanaReportingFailedRequestSysErrCount

ESReportingRequestCount

KibanaReportingRequestCount

ESReportingFailedRequestUserErrCount

KibanaReportingFailedRequestUserErrCount

ESReportingSuccessCount

KibanaReportingSuccessCount

ElasticsearchRequests

OpenSearchRequests

Untuk daftar lengkap metrik yang dikirim OpenSearch Layanan ke Amazon CloudWatch, lihatMemantau metrik OpenSearch klaster dengan Amazon CloudWatch.

Perubahan konsol Billing and Cost Management

Data historis di konsol Penagihan dan Manajemen Biaya dan dalam Laporan Biaya dan Penggunaan akan terus menggunakan nama layanan lama, jadi Anda harus mulai menggunakan filter untuk Amazon OpenSearch Service dan nama Elasticsearch lama saat mencari data. Jika Anda memiliki laporan tersimpan yang ada, perbarui filter untuk memastikannya juga menyertakan OpenSearch Layanan. Anda mungkin awalnya menerima peringatan ketika penggunaan Anda berkurang untuk Elasticsearch dan meningkat untuk OpenSearch, tetapi menghilang dalam beberapa hari.

Selain nama layanan, kolom berikut akan berubah untuk semua laporan, tagihan, dan operasi API daftar harga:

Bidang Format lama Format baru
Tipe instans

m5.large.elasticsearch

m5.large.search

Keluarga produk

Contoh Elasticsearch

Volume Elasticsearch

Instans OpenSearch Layanan Amazon

Volume OpenSearch Layanan Amazon

Deskripsi harga

$5,098 per c5.18xlarge.elasticsearch instans hour (atau sebagian jam) - UE

$5,098 per c5.18xlarge.search instans hour (atau sebagian jam) - EU

Keluarga instance

ultrawarm.elasticsearch

ultrawarm.search

Format peristiwa baru

Format peristiwa yang dikirim OpenSearch Layanan ke Amazon EventBridge dan Amazon CloudWatch telah berubah, khususnyadetail-type bidangnya. Bidang sumber (aws.es) tetap sama. Untuk format lengkap untuk setiap jenis acara, lihatMemantau peristiwa OpenSearch Layanan dengan Amazon EventBridge. Jika Anda memiliki aturan acara yang ada yang bergantung pada format lama, pastikan untuk memperbaruinya agar sesuai dengan format baru.

Apa yang tetap sama?

Fitur dan fungsionalitas berikut, antara lain yang tidak terdaftar, akan tetap sama:

  • Prinsipal layanan (es.amazonaws.com)

  • Kode Vendor

  • ARN Domain

  • Titik akhir domain

Memulai: Tingkatkan domain Anda ke OpenSearch 1.x

OpenSearch 1. x mendukung upgrade dari Elasticsearch versi 6.8 dan 7. x. Untuk petunjuk untuk meningkatkan domain Anda, lihatMemulai upgrade (konsol). Jika Anda menggunakanAWS CLI atau API konfigurasi untuk meningkatkan domain Anda, Anda perlu menentukanTargetVersion sebagaiOpenSearch_1.x.

OpenSearch 1. x memperkenalkan setelan domain tambahan yang disebut Aktifkan mode kompatibilitas. Karena klien dan plugin Elasticsearch OSS tertentu memeriksa versi klaster sebelum menghubungkan, mode OpenSearch kompatibilitas akan melaporkan versinya sebagai 7.10 sehingga klien ini terus bekerja.

Anda dapat mengaktifkan mode kompatibilitas saat membuat OpenSearch domain untuk pertama kalinya, atau saat Anda memutakhirkan OpenSearch ke versi Elasticsearch. Jika tidak disetel, parameter akan ditetapkan secara defaultfalse saat Anda membuat domain, dantrue saat Anda meningkatkan domain.

Untuk mengaktifkan mode kompatibilitas menggunakan API konfigurasi, aturoverride_main_response_version ketrue:

POST https://es.us-east-1.amazonaws.com/2021-01-01/opensearch/upgradeDomain { "DomainName": "domain-name", "TargetVersion": "OpenSearch_1.0", "AdvancedOptions": { "override_main_response_version": "true" } }

Untuk mengaktifkan atau menonaktifkan mode kompatibilitas pada OpenSearch domain yang ada, Anda perlu menggunakan operasi API OpenSearch _cluster/settings:

PUT /_cluster/settings { "persistent" : { "compatibility.override_main_response_version" : true } }