Ganti nama OpenSearch Layanan Amazon - Ringkasan perubahan - OpenSearch Layanan Amazon
APIVersi baruJenis instance berganti namaPerubahan kebijakan aksesJenis sumber daya baruKibana berganti nama menjadi Dasbor OpenSearch Metrik berganti nama CloudWatch Perubahan konsol Billing and Cost ManagementFormat acara baruApa yang tetap sama?Memulai: Tingkatkan domain Anda ke 1.x OpenSearch

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

Ganti nama OpenSearch Layanan Amazon - Ringkasan perubahan

Pada 8 September 2021, rangkaian pencarian dan analitik kami diubah namanya menjadi OpenSearch Layanan Amazon. OpenSearch Dukungan layanan OpenSearch serta Elasticsearch OSS lama. Bagian berikut menjelaskan bagian-bagian berbeda dari layanan yang berubah dengan penggantian nama, dan tindakan apa yang perlu Anda ambil untuk memastikan bahwa domain Anda terus berfungsi dengan baik.

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

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

APIVersi baru

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

Kami menyarankan Anda menggunakan API operasi baru untuk membuat dan mengelola domain ke depan. Perhatikan bahwa ketika Anda menggunakan API operasi baru untuk membuat domain, Anda perlu menentukan EngineVersion parameter dalam format Elasticsearch_X.Y atauOpenSearch_X.Y, bukan hanya nomor versi. Jika Anda tidak menentukan versi, itu default ke versi terbaru. OpenSearch

Tingkatkan AWS CLI ke versi 1.20.40 atau yang lebih baru untuk digunakan aws opensearch ... untuk membuat dan mengelola domain Anda. Untuk CLI format baru, lihat OpenSearch CLIreferensi.

Jenis instance 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 (RIs), kontrak Anda tidak akan terpengaruh oleh perubahan tersebut. APIVersi konfigurasi lama masih kompatibel dengan format penamaan lama, tetapi jika Anda ingin menggunakan API versi baru, Anda perlu menggunakan format baru.

Perubahan kebijakan akses

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

IAMkebijakan

Kami menyarankan Anda memperbarui IAMkebijakan Anda untuk menggunakan API operasi yang diganti namanya. Namun, OpenSearch Layanan akan terus menghormati kebijakan yang ada dengan mereplikasi izin lama API secara internal. Misalnya, jika saat ini Anda memiliki izin untuk melakukan CreateElasticsearchDomain operasi, Anda sekarang dapat melakukan panggilan ke keduanya CreateElasticsearchDomain (APIoperasi lama) dan CreateDomain (APIoperasi baru). Hal yang sama berlaku untuk penyangkalan eksplisit. Untuk daftar API operasi yang diperbarui, lihat referensi elemen kebijakan.

SCPkebijakan

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

Sebagai contoh:

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

Jenis 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 AWS Resource Groups, di mana Anda membuat dan mengelola sumber daya untuk layanan secara keseluruhan.

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

AWS::OpenSearch::Domain

 Merupakan perangkat lunak OpenSearch /Elasticsearch yang berjalan pada domain. Sumber daya ini berlaku untuk layanan seperti AWS CloudTraildan AWS Config, yang merujuk perangkat lunak yang berjalan pada domain daripada OpenSearch Layanan secara keseluruhan. Layanan ini sekarang berisi tipe 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 jenis AWS::Elasticsearch::Domain sumber daya yang ada selama beberapa minggu, bahkan jika Anda memutakhirkan satu atau beberapa domain ke OpenSearch.

Kibana berganti nama menjadi Dasbor OpenSearch

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

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

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

Metrik berganti nama CloudWatch

Beberapa CloudWatch metrik berubah untuk domain yang berjalan. OpenSearch Saat Anda memutakhirkan 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 Billing and Cost Management dan di Cost and Usage Reports akan terus menggunakan nama layanan lama, jadi Anda harus mulai menggunakan filter untuk Layanan OpenSearch Amazon dan nama Elasticsearch lama saat mencari data. Jika Anda memiliki laporan tersimpan, 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, bidang berikut akan berubah untuk semua laporan, tagihan, dan API operasi daftar harga:

Bidang Format lama Format baru
Jenis 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 instance hour (atau sebagian jam) - UE

$5.098 per c5.18xlarge.search instance hour (atau sebagian jam) - EU

Keluarga instans

ultrawarm.elasticsearch

ultrawarm.search

Format acara baru

Format acara yang dikirim OpenSearch Layanan ke Amazon EventBridge dan Amazon CloudWatch telah berubah, khususnya detail-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

  • Domain ARNs

  • Titik akhir domain

Memulai: Tingkatkan domain Anda ke 1.x OpenSearch

OpenSearch 1. x mendukung peningkatan dari Elasticsearch versi 6.8 dan 7. x. Untuk petunjuk untuk meningkatkan domain Anda, lihatMemutakhirkan domain (konsol). Jika Anda menggunakan konfigurasi AWS CLI or API untuk meningkatkan domain Anda, Anda perlu menentukan TargetVersion sebagaiOpenSearch_1.x.

OpenSearch 1. x memperkenalkan pengaturan domain tambahan yang disebut Aktifkan mode kompatibilitas. Karena OSS klien dan plugin Elasticsearch tertentu memeriksa versi cluster sebelum menghubungkan, mode kompatibilitas ditetapkan OpenSearch untuk 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 meningkatkan ke OpenSearch versi Elasticsearch. Jika tidak disetel, parameter default adalah false saat Anda membuat domain, dan true saat Anda memutakhirkan domain.

Untuk mengaktifkan mode kompatibilitas menggunakan konfigurasi API, atur override_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 OpenSearch API_cluster/pengaturan:

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