Umbenennung von Amazon OpenSearch Service – Zusammenfassung der Änderungen

Am 8. September 2021 wurde unsere Such- und Analyse-Suite in Amazon OpenSearch Service umbenannt. OpenSearch Service unterstützt OpenSearch und auch Legacy-System-Elasticsearch-OSS. In den folgenden Abschnitten werden die verschiedenen Teile des Services beschrieben, die sich mit der Umbenennung geändert haben und welche Maßnahmen Sie ergreifen müssen, um sicherzustellen, dass Ihre Domänen weiterhin ordnungsgemäß funktionieren.

Einige dieser Änderungen gelten nur, wenn Sie Ihre Domänen von Elasticsearch auf OpenSearch aktualisieren. In anderen Fällen, z. B. in der Fakturierung- und Kostenmanagement-Konsole, ändert sich die Benutzererfahrung sofort.

Beachten Sie, dass diese Liste nicht vollumfänglich ist. Auch andere Teile des Produkts haben sich geändert, aber diese Updates sind am relevantesten.

Neue API-Version

Die neue Version der OpenSearch Service-Konfigurations-API (2021-01-01) funktioniert sowohl mit OpenSearch als auch mit Legacy-System-Elasticsearch OSS. 21 API-Operationen wurden durch prägnantere und Engine-agnostische Namen ersetzt (z. B. CreateElasticsearchDomaingeändert in CreateDomain), aber OpenSearch Service unterstützt weiterhin beide API-Versionen.

Wir empfehlen, dass Sie zukünftig die neuen API-Operationen verwenden, um Domänen zu erstellen und zu verwalten. Beachten Sie, dass Sie bei Verwendung der neuen API-Operationen zum Erstellen einer Domäne den EngineVersion-Parameter im Format Elasticsearch_X.Y oder OpenSearch_X.Y und nicht nur die Versionsnummer angeben müssen. Wenn Sie keine Version angeben, wird standardmäßig die neueste Version von OpenSearch verwendet.

Aktualisieren Sie AWS CLI auf Version 1.20.40 oder höher, um aws opensearch ... zum Erstellen und Verwalten Ihrer Domänen zu verwenden. Informationen zum neuen CLI-Format finden Sie in der OpenSearch CLI-Referenz.

Umbenannte Instance-Typen

Instance-Typen in Amazon OpenSearch Service haben jetzt das Format <type>.<size>.search – zum Beispiel m6g.large.search statt m6g.large.elasticsearch. Sie müssen selbst keine Aktion durchführen. Vorhandene Domänen werden automatisch auf die neuen Instance-Typen innerhalb der API und in der Fakturierungs- und Kostenmanagementkonsole verweisen.

Falls Sie über Reserved Instances (RIs) verfügen, wird Ihr Vertrag von der Änderung nicht beeinflusst. Die alte Konfigurations-API-Version ist weiterhin kompatibel mit dem alten Benennungsformat, aber wenn Sie die neue API-Version verwenden möchten, müssen Sie das neue Format verwenden.

Änderungen der Zugriffsrichtlinie

In den folgenden Abschnitten wird beschrieben, welche Aktionen Sie ergreifen müssen, um Ihre Zugriffsrichtlinien zu aktualisieren.

IAM-Richtlinien

Wir empfehlen, dass Sie Ihre IAM-Richtlinien, um die umbenannten API-Vorgänge zu verwenden. OpenSearch Service wird jedoch weiterhin bestehende Richtlinien respektieren, indem es intern die alten API-Berechtigungen repliziert. Wenn Sie beispielsweise derzeit über die Berechtigung zum Ausführen des CreateElasticsearchDomain-Vorgangs verfügen, können Sie jetzt sowohl CreateElasticsearchDomain (alte API-Operation) als auch CreateDomain (neue API-Operation) aufrufen. Dasselbe gilt für explizite Zugriffsverweigerungen. Eine Liste der aktualisierten API-Operationen finden Sie in der Richtlinienelementverweis.

SCP-Richtlinien

Service Control Policies (SCPs) führen im Vergleich zu Standard-IAM eine zusätzliche Komplexitätsebene ein. Um zu verhindern, dass Ihre SCP-Richtlinien verletzt werden, müssen Sie jeder Ihrer SCP-Richtlinien sowohl die alten als auch die neuen API-Operationen hinzufügen. Wenn ein Benutzer beispielsweise derzeit über Berechtigungen zum Zulassen von CreateElasticsearchDomain verfügt, müssen Sie ihm auch Berechtigungen zum Zulassen von CreateDomain erteilen, damit er weiterhin Domänen erstellen kann. Dasselbe gilt für explizite Zugriffsverweigerungen.

Zum Beispiel:

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

Neue Ressourcentypen

OpenSearch Service führt die folgenden neuen Ressourcentypen ein:

Ressource	Beschreibung
AWS::OpenSearchService::Domain	Repräsentiert eine Amazon OpenSearch Service-Domäne. Diese Ressource existiert auf Service-Ebene und ist nicht spezifisch für die Software, die in der Domäne ausgeführt wird. Sie gilt für Dienste wie AWS CloudFormation- und AWS-Ressourcengruppen, in denen Sie Ressourcen für den Dienst als Ganzes erstellen und verwalten. Anweisungen zum Upgrade von Domänen, die in CloudFormation von Elasticsearch auf OpenSearch definiert sind, finden Sie unter Anmerkungen im CloudFormation-Benutzerhandbuch.
AWS::OpenSearch::Domain	Repräsentiert OpenSearch/ElasticSearch-Software, die auf einer Domäne ausgeführt wird. Diese Ressource gilt für Services wie AWS CloudTrail und AWS Config, die auf die Software verweisen, die auf der Domäne ausgeführt wird, und nicht auf OpenSearch Service als Ganzes. Diese Dienste enthalten jetzt separate Ressourcentypen für Domänen, auf denen Elasticsearch (AWS::Elasticsearch::Domain) ausgeführt wird, und Domänen, auf denen OpenSearch (AWS::OpenSearch::Domain) ausgeführt wird.

Anmerkung

In AWS Config sehen Sie Ihre Daten weiterhin unter der vorhandenen AWS::Elasticsearch::Domain-Ressourcentyp für mehrere Wochen, auch wenn Sie eine oder mehrere Domänen auf OpenSearch upgraden.

Kibana wurde in OpenSearch Dashboards umbenannt

OpenSearch Dashboards, die AWS-Alternative zu Kibana, ist ein Open-Source-Visualisierungs-Tool, das für OpenSearch entwickelt wurde. Nachdem Sie eine Domäne von Elasticsearch auf OpenSearch aktualisiert haben, ändert sich der /_plugin/kibana-Endpunkt in /_dashboards. Der OpenSearch-Dienst leitet alle Anfragen an den neuen Endpunkt um. Wenn Sie jedoch den Kibana-Endpunkt in einer Ihrer IAM-Richtlinien verwenden, aktualisieren Sie diese Richtlinien, um auch den neuen /_dashboards-Endpunkt einzuschließen.

Wenn Sie SAML-Authentifizierung für Dashboards OpenSearch verwenden, müssen Sie vor dem Upgrade Ihrer Domäne auf OpenSearch alle in Ihrem Identitätsanbieter (IdP) konfigurierten Kibana-URLs von /_plugin/kibana auf /_dashboards ändern. Die häufigsten URLs sind Assertion Consumer Service (ACS)-URLs und Empfänger-URLs.

Die kibana_read_only-Standardrolle für OpenSearch Dashboards wurde umbenannt in opensearch_dashboards_read_only, und die kibana_user-Rolle wurde umbenannt inopensearch_dashboards_user. Die Änderung gilt für alle neu erstellten OpenSearch 1.x-Domänen mit Service-Software R20211203 oder höher. Wenn Sie eine bereits vorhandene Domäne auf die Service-Software R20211203 aktualisieren, bleiben die Rollennamen gleich.

Umbenannte CloudWatch-Metriken

Für Domänen, die OpenSearch ausführen, ändern sich mehrere CloudWatch-Metriken. Wenn Sie eine Domäne auf OpenSearch aktualisieren, ändern sich die Metriken automatisch und Ihre aktuellen CloudWatch-Alarme werden unterbrochen. Bevor Sie Ihren Cluster von einer Elasticsearch-Version auf eine OpenSearch-Version aktualisieren, müssen Sie Ihre CloudWatch-Alarme aktualisieren, um die neuen Metriken zu verwenden.

Die folgenden Metriken haben sich verändert:

Ursprünglicher Metrikname	Neuer Name
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

Eine vollständige Liste der Metriken, die OpenSearch Service an Amazon CloudWatch sendet, finden Sie unter Überwachung von OpenSearch Cluster-Metriken mit Amazon CloudWatch.

Änderungen Fakturierung und Kostenmanagement

Historische Daten in der Rechnungsstellungs- und Kostenmanagement-Konsole und in den Kosten- und Nutzungsberichten werden weiterhin den alten Service-Namen verwenden. Daher benötigen Sie bei der Suche nach Daten Filter sowohl für Amazon OpenSearch Service als auch für den alten Elasticsearch-Namen. Wenn Sie über gespeicherte Berichte verfügen, aktualisieren Sie die Filter, um sicherzustellen, dass sie auch den OpenSearch Service enthalten. Möglicherweise erhalten Sie zunächst eine Warnung, wenn Ihre Nutzung für Elasticsearch abnimmt und für OpenSearch zunimmt, diese verschwindet jedoch innerhalb weniger Tage.

Zusätzlich zum Service-Namen ändern sich die folgenden Felder für alle Berichte, Rechnungen und Preislisten-API-Vorgänge:

Feld	Altes Format	Neues Format
Instance-Typ	m5.large.elasticsearch	m5.large.search
Produktfamilie	Elasticsearch-Instance Elasticsearch-Volume	Amazon-OpenSearch-Service-Instance Amazon-OpenSearch-Service-Volume
Preisbeschreibung	5,098$ pro c5.18xlarge.elasticsearch-Instance-Stunde (oder Teilstunde) - EU	5,098$ pro c5.18xlarge.search-Instance-Stunde (oder Teilstunde) - EU
Instance-Familie	ultrawarm.elasticsearch	ultrawarm.search

Neues Ereignisformat

Das Format der Ereignisse, die OpenSearch Service an Amazon EventBridge und Amazon CloudWatch sendet, hat sich geändert, insbesondere das Feld detail-type. Das Quellfeld (aws.es) bleibt gleich. Das vollständige Format für jeden Ereignistyp finden Sie unter Überwachung von OpenSearch Service-Ereignissen mit Amazon EventBridge. Wenn Sie über vorhandene Ereignisregeln verfügen, die vom alten Format abhängen, stellen Sie sicher, dass sie dem neuen Format entsprechen.

Was bleibt gleich?

Die folgenden Funktionen und Funktionalitäten, unter anderem nicht aufgeführt, bleiben gleich:

• Dienstauftraggeber (es.amazonaws.com)

• Anbieter-Code

• Domänen-ARNs

• Domänen-Endpunkte

Erste Schritte: Aktualisieren Sie Ihre Domänen auf OpenSearch 1.x

OpenSearch 1.x unterstützt Upgrades von Elasticsearch Version 6.8 und 7.x aus. Anweisungen zum Upgrade Ihrer Domäne finden Sie unter Starten eines Upgrades (Konsole). Wenn Sie die AWS CLI oder Konfigurations-API zum Aktualisieren Ihrer Domäne verwenden, müssen Sie die TargetVersion als OpenSearch_1.x angeben.

OpenSearch 1.x führt eine zusätzliche Domäneneinstellung namens Kompatibilitätsmodus aktivieren ein. Da bestimmte Elasticsearch OSS-Clients und Plug-ins die Clusterversion vor der Verbindung überprüfen, setzt der Kompatibilitätsmodus OpenSearch so ein, dass er dessen Version als 7.10 meldet, damit diese Clients weiterhin funktionieren.

Sie können den Kompatibilitätsmodus aktivieren, wenn Sie OpenSearch-Domänen zum ersten Mal erstellen oder wenn Sie von einer Elasticsearch-Version auf OpenSearch aktualisieren. Wenn er nicht gesetzt ist, wird der Parameter standardmäßig auf false gesetzt, wenn Sie eine Domäne erstellen, und auf true wenn Sie eine Domäne aktualisieren.

Um den Kompatibilitätsmodus mit der Konfigurations-API zu aktivieren, setzen Sie override_main_response_version auf 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"
   }
}

Um den Kompatibilitätsmodus für vorhandene OpenSearch-Domänen zu aktivieren oder zu deaktivieren, müssen Sie die OpenSearch API-Operation _cluster/settings verwenden:

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