View a markdown version of this page

Migración de objetos guardados de los OpenSearch paneles a la interfaz de usuario OpenSearch - OpenSearch Servicio Amazon

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Migración de objetos guardados de los OpenSearch paneles a la interfaz de usuario OpenSearch

Si ya tiene paneles, visualizaciones, patrones de índice y otros objetos guardados en los OpenSearch paneles, puede migrarlos y reutilizarlos en la interfaz de usuario. OpenSearch

Ventajas de migrar a la interfaz de usuario: OpenSearch

  • Alta disponibilidad: la OpenSearch interfaz de usuario se aloja en el dominio Nube de AWS y permanece disponible durante las actualizaciones y el mantenimiento del dominio, mientras que los OpenSearch paneles se alojan dentro del dominio y no estarán disponibles temporalmente.

  • Varias fuentes de datos: la OpenSearch interfaz de usuario puede proporcionar un panel de control único y consolidado que abarca varias fuentes de datos, incluidos OpenSearch los dominios, las recopilaciones sin servidor y las conexiones de datos con Amazon S3 y Amazon CloudWatch; mientras que cada OpenSearch panel solo puede funcionar con un dominio o colección.

  • En la interfaz de usuario hay funciones adicionales, como AI Assistant y Workspaces. OpenSearch Más información:Uso de la OpenSearch interfaz de usuario en Amazon OpenSearch Service.

Información general sobre la migración

El proceso de migración consta de los siguientes pasos de alto nivel:

  1. Exporte los objetos guardados desde los OpenSearch paneles: utilice la interfaz de usuario de administración de objetos guardados del OpenSearch panel o la API de exportación para descargar los paneles, las visualizaciones, los patrones de índice y otros objetos como un archivo JSON (NDJSON) delimitado por nuevas líneas.

  2. Cree una aplicación de OpenSearch interfaz de usuario y un espacio de trabajo: si aún no lo ha hecho, cree una aplicación de OpenSearch interfaz de usuario y un espacio de trabajo para recibir los objetos importados.

  3. Registre la fuente de datos en la OpenSearch interfaz de usuario: asocie su OpenSearch dominio a la aplicación de OpenSearch interfaz de usuario y regístrelo como fuente de datos en el espacio de trabajo. Los patrones de índice de los objetos importados hacen referencia a esta fuente de datos.

  4. Importar objetos guardados a la OpenSearch interfaz de usuario: utilice la OpenSearch interfaz de usuario de administración de objetos guardados o la API de importación para cargar el archivo NDJSON en el espacio de trabajo de destino.

  5. Valida los objetos importados: abre tus paneles y visualizaciones en la OpenSearch interfaz de usuario para comprobar que se muestran correctamente y que los datos fluyen desde el dominio o la colección asociados.

Requisitos previos

Antes de la migración, compruebe los siguientes requisitos previos:

nota

OpenSearch La interfaz de usuario solo es compatible con OpenSearch la versión 1.3 y posteriores. Comprueba que tu OpenSearch dominio ejecute la versión 1.3 o superior antes de intentar migrar los objetos guardados.

Paso 1: Exportar los objetos guardados desde los OpenSearch paneles

Exporte los objetos guardados desde los OpenSearch paneles mediante la interfaz de usuario de administración o la API de exportación. La exportación produce un archivo JSON (NDJSON) delimitado por líneas nuevas que contiene todos los tipos de objetos guardados seleccionados y sus dependencias.

OpenSearch Exporte manualmente en paneles

Para exportar los objetos guardados mediante la interfaz de usuario de administración de los OpenSearch paneles
  1. Abre tu instancia de OpenSearch Dashboards.

  2. En el panel de navegación de la izquierda, selecciona Administración.

  3. En Administración de paneles, seleccione Objetos guardados.

  4. Selecciona los objetos guardados que deseas exportar. Para exportar todos los objetos de un tipo específico, filtre por tipo mediante la barra de búsqueda. Para exportar todos los objetos, seleccione la casilla de verificación del encabezado de la tabla.

  5. Seleccione Exportar.

  6. En el cuadro de diálogo Exportar objetos guardados, asegúrese de que esté seleccionada la opción Incluir objetos relacionados. Esta opción incluye todos los objetos de los que dependen los objetos guardados seleccionados, como los patrones de índice a los que hacen referencia las visualizaciones. Desactive esta opción solo si tiene la intención de administrar las dependencias manualmente.

  7. Seleccione Exportar para descargar el .ndjson archivo a su máquina local.

sugerencia

Si elige Incluir objetos relacionados, el archivo NDJSON exportado contiene todos los objetos guardados necesarios para representar los paneles y visualizaciones seleccionados, incluidos los patrones de índice, las visualizaciones y los objetos de búsqueda dependientes. Esto simplifica el paso de importación y evita la omisión de errores de referencia.

Exportación mediante API

Puede usar la API de exportación de OpenSearch objetos guardados del panel para exportar objetos guardados mediante programación. Esto resulta útil para automatizar las migraciones o integrar la etapa de exportación en una canalización. CI/CD

nota

Si tu OpenSearch dominio tiene activado un control de acceso detallado, debes proporcionar las credenciales de autenticación junto con la solicitud de exportación. Usa la autenticación básica HTTP añadiendo la -u marca con tu nombre de usuario y contraseña. Para obtener más información acerca de las opciones de autenticación, consulte Fine-grained control de acceso en Amazon OpenSearch Service.

En el siguiente ejemplo, se exportan todos los paneles con sus objetos relacionados. Sustituya placeholder values por su propia información.

curl -X POST \ "https://dashboards-endpoint/_dashboards/api/saved_objects/_export" \ -u 'master-username:master-password' \ -H "Content-Type: application/json" \ -H "osd-xsrf: true" \ -d '{ "type": ["dashboard", "visualization", "index-pattern", "search"], "includeReferencesDeep": true, "excludeExportDetails": false }' \ -o saved-objects-export.ndjson

Si su dominio no tiene activado el control de acceso detallado, puede omitir la marca. -u

Para exportar objetos guardados específicos por ID, usa el objects parámetro en lugar de: type

curl -X POST \ "https://dashboards-endpoint/_dashboards/api/saved_objects/_export" \ -u 'master-username:master-password' \ -H "Content-Type: application/json" \ -H "osd-xsrf: true" \ -d '{ "objects": [ {"type": "dashboard", "id": "dashboard-id"}, {"type": "visualization", "id": "visualization-id"} ], "includeReferencesDeep": true }' \ -o saved-objects-export.ndjson
nota

Para buscar los ID de objetos guardados, puedes usar la API de objetos guardados para enumerar todos los objetos de un tipo específico. En el siguiente ejemplo se enumeran todos los paneles:

curl -X GET \ "https://dashboards-endpoint/_dashboards/api/saved_objects/_find?type=dashboard" \ -u 'master-username:master-password'

La respuesta incluye el ID de cada objeto guardado. También puede encontrar el ID en la URL del navegador al ver el objeto en los OpenSearch paneles.

Paso 2: Importa los objetos guardados a la interfaz de usuario OpenSearch

Tras exportar los objetos guardados, puede importar el archivo NDJSON a la OpenSearch interfaz de usuario manualmente o mediante la API.

Importar manualmente en la interfaz de usuario OpenSearch

Para importar objetos guardados mediante la OpenSearch interfaz de usuario de administración de la interfaz de usuario
  1. Abre tu aplicación de OpenSearch interfaz de usuario y navega hasta el espacio de trabajo de destino.

  2. En el espacio de trabajo, selecciona Recursos en la barra de navegación superior o ve a la página de activos del espacio de trabajo.

  3. Seleccione Importar para abrir el cuadro de diálogo Importar activos.

  4. Seleccione Seleccionar archivo y seleccione el .ndjson archivo que ha exportado desde los OpenSearch paneles.

  5. Para la gestión de conflictos, elija una de las siguientes opciones:

    • Crear nuevos activos con identificadores únicos (predeterminado): genera nuevos identificadores para todos los objetos importados, lo que evita conflictos con los activos existentes.

    • Verificar los activos existentes: comprueba si hay conflictos con los objetos existentes. Cuando esté seleccionada, elija una de las siguientes subopciones:

      • Sobrescribir automáticamente los conflictos: los activos existentes con el mismo identificador se reemplazan automáticamente.

      • Solicitar una acción en caso de conflicto: se le pedirá que resuelva cada conflicto de forma individual.

  6. Seleccione Importar.

  7. Revisa el resumen de la importación.

Importación mediante API

Para importar objetos guardados mediante la API con la autenticación AWS Signature Version 4, primero debes obtener el ID de la fuente de datos y, a continuación, usarlo en la solicitud de importación. Sustituya placeholder values por su propia información.

Paso 1: Obtén el ID de la fuente de datos para tu espacio de trabajo:

curl -X GET \ "https://opensearch-ui-endpoint/w/workspace-id/api/saved_objects/_find?type=data-source" \ --aws-sigv4 "aws:amz:region:opensearch" \ --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \ -H "x-amz-security-token: $AWS_SESSION_TOKEN" \ -H "osd-xsrf: true"
nota

La respuesta incluye el ID de la fuente de datos. También puede encontrar el ID de la fuente de datos en la URL del navegador al ver la fuente de datos en la OpenSearch interfaz de usuario.

Paso 2: Importe los objetos guardados utilizando el ID de la fuente de datos del paso 1:

curl -X POST \ "https://opensearch-ui-endpoint/w/workspace-id/api/saved_objects/_import?overwrite=true&dataSourceId=data-source-id" \ --aws-sigv4 "aws:amz:region:opensearch" \ --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \ -H "x-amz-security-token: $AWS_SESSION_TOKEN" \ -H "osd-xsrf: true" \ -F "file=@saved-objects-export.ndjson"
nota

En estos ejemplos, se usa la --aws-sigv4 opción integrada de curl (disponible en curl 7.75 o versiones posteriores) para firmar las solicitudes. Configura tus AWS credenciales como variables de entorno antes de ejecutar los comandos: AWS_ACCESS_KEY_IDAWS_SECRET_ACCESS_KEY, y AWS_SESSION_TOKEN (si usas credenciales temporales).