Amazon OpenSearch Service rename - Riepilogo delle modifiche - OpenSearch Servizio Amazon

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Amazon OpenSearch Service rename - Riepilogo delle modifiche

L'8 settembre 2021, la nostra suite di ricerca e analisi è stata rinominata Amazon OpenSearch Service. OpenSearch Supporti di servizio OpenSearch oltre alla versione precedente di ElasticsearchOSS. Nelle sezioni seguenti vengono descritte le diverse parti del servizio modificate con la rinomina del servizio e le operazioni da eseguire per garantire che i domini continuino a funzionare correttamente.

Alcune di queste modifiche si applicano solo quando aggiorni i tuoi domini da Elasticsearch a. OpenSearch In altri casi, ad esempio nella console di gestione fatturazione e costi, l'esperienza cambia immediatamente.

Questo elenco non è completo. Mentre anche altre parti del prodotto sono cambiate, questi aggiornamenti sono i più rilevanti.

Nuova versione API

La nuova versione della configurazione del OpenSearch servizio API (2021-01-01) funziona anche con OpenSearch Elasticsearch legacy. OSS 21 API operazioni sono state sostituite con nomi più concisi e indipendenti dal motore (ad esempio, modificati in), ma Service continua a supportare entrambe le versioni. CreateElasticsearchDomain CreateDomain OpenSearch API

Ti consigliamo di utilizzare le nuove API operazioni per creare e gestire i domini in futuro. Tieni presente che quando utilizzi le nuove API operazioni per creare un dominio, devi specificare il EngineVersion parametro nel formato Elasticsearch_X.Y oOpenSearch_X.Y, anziché solo il numero di versione. Se non si specifica una versione, per impostazione predefinita viene utilizzata la versione più recente di. OpenSearch

Aggiorna il tuo AWS CLI alla versione 1.20.40 o successiva per utilizzarlo per creare e gestire aws opensearch ... i tuoi domini. Per il nuovo CLI formato, consulta il riferimento. OpenSearch CLI

Tipi di istanza rinominati

I tipi di istanza in Amazon OpenSearch Service ora sono nel formato, ad <type>.<size>.search esempio, m6g.large.search anzichém6g.large.elasticsearch. Non è necessario eseguire nessuna operazione. I domini esistenti inizieranno a fare riferimento automaticamente ai nuovi tipi di istanze all'interno API e nella console di Billing and Cost Management.

Se disponi di istanze riservate (RIs), il tuo contratto non sarà influenzato dalla modifica. La vecchia API versione di configurazione è ancora compatibile con il vecchio formato di denominazione, ma se desideri utilizzare la nuova API versione, devi usare il nuovo formato.

Modifiche delle policy di accesso

Nelle sezioni seguenti vengono descritte le azioni da intraprendere per aggiornare le policy di accesso.

IAMpolitiche

Si consiglia di aggiornare le IAMpolitiche per utilizzare le API operazioni rinominate. Tuttavia, OpenSearch Service continuerà a rispettare le politiche esistenti replicando internamente le vecchie autorizzazioni. API Ad esempio, se attualmente disponi dell'autorizzazione per eseguire l'CreateElasticsearchDomainoperazione, ora puoi effettuare chiamate sia a CreateElasticsearchDomain (vecchia API operazione) che a CreateDomain (nuova API operazione). Lo stesso vale per i rifiuti espliciti. Per un elenco delle API operazioni aggiornate, vedete il riferimento all'elemento policy.

SCPpolitiche

Le politiche di controllo dei servizi (SCPs) introducono un ulteriore livello di complessità rispetto allo standardIAM. Per evitare che le SCP policy vengano violate, è necessario aggiungere sia le vecchie che API le nuove operazioni a ciascuna SCP policy. Ad esempio, se un utente dispone attualmente delle autorizzazioni per CreateElasticsearchDomain, è necessario concedere loro anche le autorizzazioni per CreateDomain in modo che possano mantenere la possibilità di creare domini. Lo stesso vale per i rifiuti espliciti.

Ad esempio:

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

Nuovi tipi di risorsa

OpenSearch Il servizio introduce i seguenti nuovi tipi di risorse:

Risorsa Descrizione

AWS::OpenSearchService::Domain

Rappresenta un dominio Amazon OpenSearch Service. Questa risorsa esiste a livello di servizio e non è specifica del software in esecuzione nel dominio. Si applica a servizi come AWS CloudFormation e AWS Resource Groups, in cui è possibile creare e gestire le risorse per il servizio nel suo complesso.

Per istruzioni su come aggiornare i domini definiti all'interno di Elasticsearch CloudFormation a OpenSearch, consulta la sezione Note nella Guida per l'utente. CloudFormation

AWS::OpenSearch::Domain

Rappresenta il software OpenSearch /Elasticsearch in esecuzione su un dominio. Questa risorsa si applica a servizi come AWS CloudTrailand AWS Config, che fanno riferimento al software in esecuzione sul dominio anziché al OpenSearch servizio nel suo complesso. Questi servizi ora contengono tipi di risorse separati per i domini che eseguono Elasticsearch (AWS::Elasticsearch::Domain) rispetto ai domini che eseguono (). OpenSearch AWS::OpenSearch::Domain
Nota

In AWS Config, continuerai a visualizzare i tuoi dati con il tipo di AWS::Elasticsearch::Domain risorsa esistente per diverse settimane, anche se esegui l'upgrade di uno o più domini a. OpenSearch

Kibana è stato rinominato in Dashboards OpenSearch

OpenSearch Dashboards, l' AWS alternativa a Kibana, è uno strumento di visualizzazione open source progettato per funzionare con. OpenSearch Dopo aver aggiornato un dominio da Elasticsearch a, l'endpoint cambia in. OpenSearch /_plugin/kibana /_dashboards OpenSearch Il servizio reindirizzerà tutte le richieste al nuovo endpoint, ma se utilizzi l'endpoint Kibana in una delle tue IAM politiche, aggiorna tali politiche per includere anche il nuovo endpoint. /_dashboards

Se stai utilizzandoSAMLautenticazione per i OpenSearch pannelli di controllo, prima di aggiornare il tuo dominio a OpenSearch, devi modificare tutti i Kibana URLs configurati nel tuo provider di identità (IdP) da a. /_plugin/kibana /_dashboards I più comuni URLs sono Assertion Consumer Service () ACS e Recipient. URLs URLs

Il kibana_read_only ruolo predefinito per OpenSearch Dashboards è stato rinominato inopensearch_dashboards_read_only, e il kibana_user ruolo è stato rinominato in. opensearch_dashboards_user La modifica si applica a tutti i 1 appena creati. OpenSearch domini x che eseguono il software di servizio R20211203 o versione successiva. Se si aggiorna un dominio esistente al software del servizio R20211203, i nomi dei ruoli rimangono invariati.

CloudWatch Metriche rinominate

Diverse CloudWatch metriche vengono modificate per i domini in esecuzione. OpenSearch Quando aggiorni un dominio a OpenSearch, le metriche cambiano automaticamente e gli CloudWatch allarmi attuali si interrompono. Prima di aggiornare il cluster da una versione di Elasticsearch a una OpenSearch versione, assicurati di aggiornare gli CloudWatch allarmi per utilizzare le nuove metriche.

Sono stati modificati i seguenti parametri:

Nome parametro originale Nuovo nome

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

Per un elenco completo delle metriche inviate dal OpenSearch Servizio ad Amazon CloudWatch, consultaMonitoraggio delle metriche dei OpenSearch cluster con Amazon CloudWatch.

Modifiche della console Gestione fatturazione e costi

I dati storici nella console di Billing and Cost Management e nei report sui costi e sull'utilizzo continueranno a utilizzare il vecchio nome di servizio, quindi devi iniziare a utilizzare i filtri sia per OpenSearch Amazon Service che per il nome precedente di Elasticsearch durante la ricerca dei dati. Se hai già dei report salvati, aggiorna i filtri per assicurarti che includano anche il servizio. OpenSearch Inizialmente potresti ricevere un avviso quando l'utilizzo di Elasticsearch diminuisce o aumenta OpenSearch, ma scompare nel giro di alcuni giorni.

Oltre al nome del servizio, i seguenti campi cambieranno per tutti i report, le fatture e le operazioni relative al listino prezzi: API

Campo Vecchio formato Nuovo formato
Tipo di istanza

m5.large.elasticsearch

m5.large.search

Famiglia di prodotti

Istanza Elasticsearch

Volume Elasticsearch

Istanza OpenSearch di servizio Amazon

Volume OpenSearch di servizi Amazon

Descrizione dei prezzi

5.098 USD per ora di istanza c5.18xlarge.elasticsearch (o ora parziale) - EU

5.098 USD per ora di istanza c5.18xlarge.search (o ora parziale) - EU

Famiglia di istanze

ultrawarm.elasticsearch

ultrawarm.search

Nuovo formato evento

Il formato degli eventi che il OpenSearch Servizio invia ad Amazon EventBridge e Amazon CloudWatch è cambiato, in particolare il detail-type campo. Il campo di origine (aws.es) rimane lo stesso. Per il formato completo per ogni tipo di evento, consultare Monitoraggio degli eventi del OpenSearch servizio con Amazon EventBridge. Se si dispone di regole di evento esistenti che dipendono dal formato precedente, assicurarsi di aggiornarle in modo che siano conformi al nuovo formato.

Cosa rimane lo stesso?

Le seguenti caratteristiche e funzionalità, tra le altre non elencate, rimarranno invariate:

  • Principale del servizio (es.amazonaws.com)

  • Codice fornitore

  • Dominio ARNs

  • Endpoint di dominio

Inizia: aggiorna i tuoi domini alla OpenSearch versione 1.x

OpenSearch 1. x supporta gli aggiornamenti dalle versioni 6.8 e 7 di Elasticsearch. x. Per istruzioni su come aggiornare il dominio, consultare Aggiornamento di un dominio (console). Se utilizzi la configurazione AWS CLI o API per aggiornare il tuo dominio, devi specificare TargetVersion asOpenSearch_1.x.

OpenSearch 1. x introduce un'impostazione di dominio aggiuntiva denominata Abilita la modalità di compatibilità. Poiché alcuni OSS client e plugin Elasticsearch controllano la versione del cluster prima di connettersi, la modalità di compatibilità imposta in modo OpenSearch da riportare la versione 7.10 in modo che questi client continuino a funzionare.

Puoi abilitare la modalità di compatibilità quando crei OpenSearch domini per la prima volta o quando esegui l'aggiornamento da una versione di Elasticsearch. OpenSearch Se non è impostato, viene ripristinato il parametro predefinito, false, quando crei un dominio e true quando esegui l'aggiornamento di un dominio.

Per abilitare la modalità di compatibilità utilizzando la configurazioneAPI, imposta su: override_main_response_version true

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" } }

Per abilitare o disabilitare la modalità di compatibilità sui OpenSearch domini esistenti, è necessario utilizzare l'operazione OpenSearch API_cluster/settings:

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