Cambio de nombre de Amazon OpenSearch Service: resumen de cambios

El 8 de septiembre de 2021, nuestro conjunto de aplicaciones de búsqueda y análisis pasó a llamarse Amazon OpenSearch Service. OpenSearch Service es compatible con OpenSearch, así como con Elasticsearch OSS heredado. En las secciones siguientes, se describen las diferentes partes del servicio que sufrieron modificaciones con el cambio de nombre y las acciones que se deben realizar para garantizar que los dominios sigan funcionando correctamente.

Algunos de estos cambios solo se aplican cuando actualiza sus dominios de Elasticsearch a OpenSearch. En otros casos, como en la consola de Billing and Cost Management, la experiencia cambia inmediatamente.

Tenga en cuenta que esta lista no es exhaustiva. Mientras que otras partes del producto también cambiaron, estas actualizaciones son las más relevantes.

Nueva versión de la API

La nueva versión de la API de configuración de OpenSearch Service (01/01/2021) funciona con OpenSearch, así como con Elasticsearch OSS heredado. Se reemplazaron 21 operaciones de la API por nombres más concisos e independientes del motor (por ejemplo, CreateElasticsearchDomain cambió a CreateDomain), pero OpenSearch Service aún es compatible con ambas versiones de la API.

Recomendamos utilizar las nuevas operaciones de la API para crear y administrar dominios en el futuro. Tenga en cuenta que cuando utilice las nuevas operaciones de la API para crear un dominio, debe especificar el parámetro EngineVersion en el formato Elasticsearch_X.Y o OpenSearch_X.Y, en lugar de solo el número de versión. Si no especifica ninguna versión, toma de forma predeterminada la versión más reciente de OpenSearch.

Actualice la AWS CLI a la versión 1.20.40 o posterior para utilizar aws opensearch ... a fin de crear y administrar los dominios. Para obtener el nuevo formato de la CLI, consulte la Referencia de la CLI de OpenSearch.

Tipos de instancia con cambio de nombre

Los tipos de instancias de Amazon OpenSearch Service ahora tienen el formato <type>.<size>.search, por ejemplo, m6g.large.search en lugar de m6g.large.elasticsearch. No es necesario realizar ninguna acción. Los dominios existentes comenzarán a hacer referencia automáticamente a los nuevos tipos de instancias dentro de la API y en la consola de Billing and Cost Management.

Si dispone de instancias reservadas (RI), el cambio no afectará al contrato. La versión antigua de la API de configuración aún es compatible con el formato de nomenclatura anterior, pero si desea utilizar la nueva versión de la API, debe utilizar el nuevo formato.

Cambios en las políticas de acceso

En las secciones siguientes, se describen las acciones que debe realizar para actualizar las políticas de acceso.

Políticas de IAM

Recomendamos que actualice sus Políticas de IAM para utilizar las operaciones de la API con cambio de nombre. Sin embargo, OpenSearch Service seguirá respetando las políticas existentes al replicar internamente los permisos de la API antiguos. Por ejemplo, si actualmente tiene permiso para realizar la operación CreateElasticsearchDomain, ahora puede realizar llamadas a ambos CreateElasticsearchDomain (operación antigua de la API) y CreateDomain (nueva operación de la API). Lo mismo se aplica a las denegaciones explícitas. Para obtener una lista de las operaciones de la API actualizadas, consulte la referencia de elementos de política.

Políticas de SCP

Las políticas de control de servicios (SCP) presentan una capa adicional de complejidad en comparación con IAM estándar. Para evitar que las políticas de SCP se rompan, debe agregar tanto las operaciones de la API antiguas como las nuevas a cada una de sus políticas de SCP. Por ejemplo, si actualmente un usuario tiene permisos para CreateElasticsearchDomain, también debe concederles permisos para CreateDomain a fin de que puedan retener la capacidad de crear dominios. Lo mismo se aplica a las denegaciones explícitas.

Por ejemplo:

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

Nuevos tipos de recursos

OpenSearch Service presenta los siguientes tipos de recursos nuevos:

Recurso	Descripción
AWS::OpenSearchService::Domain	Representa un dominio de Amazon OpenSearch Service. Este recurso existe en el nivel de servicio y no es específico del software que se ejecuta en el dominio. Se aplica a servicios como AWS CloudFormation y AWS Resource Groups, en los que crea y administra recursos para el servicio en su conjunto. Para obtener instrucciones para actualizar los dominios definidos en CloudFormation de Elasticsearch a OpenSearch, consulte Observaciones en la Guía del usuario de CloudFormation.
AWS::OpenSearch::Domain	Representa el software OpenSearch/Elasticsearch que se ejecuta en un dominio. Este recurso se aplica a servicios como AWS CloudTrail y AWS Config, que hacen referencia al software que se ejecuta en el dominio en lugar de a OpenSearch Service como un todo. Estos servicios ahora contienen tipos de recursos separados para dominios que ejecutan Elasticsearch (AWS::Elasticsearch::Domain) frente a dominios que ejecutan OpenSearch (AWS::OpenSearch::Domain).

nota

En AWS Config, seguirá viendo sus datos en el tipo de recurso AWS::Elasticsearch::Domain existente durante varias semanas, incluso si actualiza uno o más dominios a OpenSearch.

Kibana cambió de nombre a OpenSearch Dashboards

OpenSearch Dashboards, la alternativa de AWS a Kibana, es una herramienta de visualización de código abierto diseñada para funcionar con OpenSearch. Después de actualizar un dominio de Elasticsearch a OpenSearch, el punto de enlace /_plugin/kibana cambia a /_dashboards. OpenSearch Service redirigirá todas las solicitudes al nuevo punto de enlace, pero si utiliza el punto de enlace de Kibana en cualquiera de sus políticas de IAM, actualice esas políticas para incluir el nuevo punto de enlace de /_dashboards también.

Si utiliza Autenticación SAML para paneles OpenSearch , antes de actualizar su dominio a OpenSearch, debe cambiar todas las URL de Kibana configuradas en su proveedor de identidad (IdP) de /_plugin/kibana a /_dashboards. Las URL más comunes son las URL de servicio al consumidor de aserción (ACS) y las URL de destinatario.

Se ha cambiado el nombre del rol kibana_read_only predeterminado para OpenSearch Dashboards por opensearch_dashboards_read_only, y al rol kibana_user se le ha cambiado el nombre por opensearch_dashboards_user. El cambio es de aplicación a todos los dominios recién creados de OpenSearch 1.x en los que se ejecute el software de servicio R20211203 o posterior. Si se actualiza un dominio existente al software de servicio R20211203, los nombres de los roles siguen siendo los mismos.

Métricas de CloudWatch con cambio de nombre

Varias métricas de CloudWatch cambian para los dominios que ejecutan OpenSearch. Cuando actualiza un dominio a OpenSearch, las métricas cambian automáticamente y las alarmas actuales de CloudWatch fallarán. Antes de actualizar el clúster de una versión de Elasticsearch a una versión de OpenSearch, asegúrese de actualizar las alarmas de CloudWatch para utilizar las nuevas métricas.

Cambiaron las siguientes métricas:

Nombre de métrica original	Nombre nuevo
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

Para obtener una lista completa de las métricas que OpenSearch Service envía a Amazon CloudWatch, consulte Supervisión de las métricas del OpenSearch clúster con Amazon CloudWatch.

Cambios en la consola de Billing and Cost Management

Los datos históricos en la consola de Administración de facturación y costos y en los Informes de costos y usos seguirán utilizando el nombre del servicio antiguo, por lo que debe comenzar a emplear filtros tanto para Amazon OpenSearch Service como para el nombre de Elasticsearch heredado cuando haga búsquedas de datos. Si ya tiene informes guardados, actualice los filtros para asegurarse de que también incluyen OpenSearch Service. Es posible que reciba inicialmente una alerta cuando su utilización disminuya para Elasticsearch y aumente para OpenSearch, pero desaparezca en varios días.

Además del nombre del servicio, los siguientes campos cambiarán para todos los informes, facturas y operaciones de la API de lista de precios:

Campo	Formato antiguo	Formato nuevo
Tipo de instancia	m5.large.elasticsearch	m5.large.search
Familia de productos	Instancia de Elasticsearch Volumen de Elasticsearch	Instancia de Amazon OpenSearch Service Volumen de Amazon OpenSearch Service
Descripción del precio	5,098 USD por hora de instancia c5.18xlarge.elasticsearch (u hora parcial), UE	5,098 USD por hora de instancia c5.18xlarge.search (u hora parcial), UE
Familia de instancias	ultrawarm.elasticsearch	ultrawarm.search

Nuevo formato de evento

El formato de los eventos que OpenSearch Service envía a Amazon EventBridge y Amazon CloudWatch ha cambiado, específicamente el campo detail-type. El campo fuente (aws.es) aún es el mismo. Para obtener el formato completo de cada tipo de evento, consulte Monitorización OpenSearch de eventos del servicio con Amazon EventBridge. Si tiene reglas de evento existentes que dependen del formato antiguo, asegúrese de actualizarlas para que se ajusten al nuevo formato.

¿Qué permanece igual?

Las siguientes características y funcionalidades, entre otras no enumeradas, permanecerán iguales:

• Entidad principal de servicio (es.amazonaws.com)

• Código de proveedor

• ARN del dominio

• Puntos de enlace del dominio

Comience: Actualice sus dominios a OpenSearch 1.x

OpenSearch 1.x soporta actualizaciones de Elasticsearch versión 6.8 y 7.x. Para obtener instrucciones a fin de actualizar su dominio, consulte Inicio de una actualización (consola). Si utiliza la AWS CLI o la API de configuración para actualizar su dominio, debe especificar la TargetVersion como OpenSearch_1.x.

OpenSearch 1.x presenta una configuración de dominio adicional llamada Habilitar modo de compatibilidad. Debido a que algunos clientes y complementos de Elasticsearch OSS verifican la versión del clúster antes de conectarse, el modo de compatibilidad establece que OpenSearch informe su versión como 7.10 para que estos clientes sigan funcionando.

Puede habilitar el modo de compatibilidad al crear dominios de OpenSearch por primera vez o al actualizar a OpenSearch desde una versión de Elasticsearch. Si no está establecido, el parámetro predeterminado es false al crear un dominio y true cuando actualiza un dominio.

Para habilitar el modo de compatibilidad mediante la API de configuración, establezca override_main_response_version en 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"
   }
}

Para habilitar o desactivar el modo de compatibilidad en dominios de OpenSearch existentes, es necesario utilizar la operación de la API de OpenSearch _cluster/settings:

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