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.
Temas
Información general sobre la migración
El proceso de migración consta de los siguientes pasos de alto nivel:
-
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.
-
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.
-
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.
-
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.
-
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:
-
Tienes los permisos de IAM necesarios para llamar al OpenSearch servicio y OpenSearch a las API de Amazon. Para obtener más información, consulte Permisos necesarios para crear aplicaciones OpenSearch de Amazon Service.
-
Puedes acceder al dominio o la colección y a los OpenSearch paneles que deseas migrar.
-
Ha creado una aplicación de OpenSearch interfaz de usuario. Para obtener información sobre la creación de una aplicación y un espacio de trabajo, consultePrimeros pasos con la interfaz OpenSearch de usuario de Amazon Service OpenSearch.
-
Ha asociado el mismo dominio o colección a la aplicación de OpenSearch interfaz de usuario. Para obtener información sobre la asociación de fuentes de datos, consulteAdministración de las asociaciones de orígenes de datos y los permisos de acceso a la nube privada virtual.
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
-
Abre tu instancia de OpenSearch Dashboards.
-
En el panel de navegación de la izquierda, selecciona Administración.
-
En Administración de paneles, seleccione Objetos guardados.
-
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.
-
Seleccione Exportar.
-
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.
-
Seleccione Exportar para descargar el
.ndjsonarchivo 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 }' \ -osaved-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 }' \ -osaved-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
-
Abre tu aplicación de OpenSearch interfaz de usuario y navega hasta el espacio de trabajo de destino.
-
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.
-
Seleccione Importar para abrir el cuadro de diálogo Importar activos.
-
Seleccione Seleccionar archivo y seleccione el
.ndjsonarchivo que ha exportado desde los OpenSearch paneles. -
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.
-
-
-
Seleccione Importar.
-
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).