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 tienes paneles, visualizaciones, patrones de indexación y otros objetos guardados en los OpenSearch paneles, puedes 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 está alojada en el dominio Nube de AWS y permanece disponible durante las actualizaciones y el mantenimiento, mientras que OpenSearch Dashboards se aloja en el dominio y no estará disponible temporalmente.
-
Varias fuentes de datos: la OpenSearch interfaz de usuario puede proporcionar un único panel de control consolidado para múltiples fuentes de datos, incluidos OpenSearch dominios, colecciones sin servidor y conexiones de datos con Amazon S3 y Amazon CloudWatch; mientras que cada OpenSearch panel solo puede funcionar con un dominio o colección.
-
La interfaz de usuario incluye funciones adicionales, como el asistente de inteligencia artificial y los espacios de trabajo. 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:
-
Exportación de objetos guardados desde OpenSearch paneles: utilice la interfaz de usuario de administración de objetos guardados de OpenSearch Dashboards o la API de exportación para descargar sus paneles, visualizaciones, patrones de indexación y otros objetos como un archivo JSON (NDJSON) delimitado por líneas nuevas.
-
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ístrela como fuente de datos en el espacio de trabajo. Los patrones de índice de los objetos importados hacen referencia a esta fuente de datos.
-
Importación de 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.
-
Valide los objetos importados: abra los paneles y las visualizaciones en la OpenSearch interfaz de usuario para comprobar que se muestran correctamente y que los datos provienen del 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 de Amazon y OpenSearch APIs. Para obtener más información, consulte Permisos necesarios para crear aplicaciones OpenSearch de Amazon Service.
-
Puede acceder al dominio o la colección y a los OpenSearch paneles de control que desee 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, consulteIntroducción a la interfaz OpenSearch de usuario de Amazon OpenSearch Service.
-
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: Exporte los objetos guardados desde los OpenSearch paneles
Exporte los objetos guardados desde los OpenSearch paneles de control mediante la interfaz de usuario de administración o la API de exportación. La exportación genera un archivo JSON (NDJSON) delimitado por líneas nuevas que contiene todos los tipos de objetos guardados seleccionados y sus dependencias.
OpenSearch Exporte manualmente a los paneles
Para exportar objetos guardados mediante la interfaz de usuario de administración de OpenSearch paneles
-
Abre tu instancia de OpenSearch Dashboards.
-
En el panel de navegación izquierdo, selecciona Administración.
-
En Administración de paneles, seleccione Objetos guardados.
-
Seleccione los objetos guardados que desee 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, active 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 pretende gestionar las dependencias manualmente.
-
Seleccione Exportar para descargar el
.ndjsonarchivo a su máquina local.
sugerencia
Si selecciona Incluir objetos relacionados, el archivo NDJSON exportado contiene todos los objetos guardados necesarios para renderizar los cuadros de mando y las visualizaciones seleccionados, incluidos los patrones de índice, las visualizaciones y los objetos de búsqueda que dependen de ellos. Esto simplifica el paso de importación y evita que falten errores de referencia.
Exportación mediante API
Puede utilizar la API de exportación de objetos guardados de OpenSearch Dashboards para exportar los objetos guardados mediante programación. Esto resulta útil para automatizar las migraciones o integrar el paso de exportación en una canalización. CI/CD
nota
Si tu OpenSearch dominio tiene habilitado un control de acceso detallado, debes proporcionar las credenciales de autenticación con tu 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 Control de acceso detallado en Amazon Service OpenSearch.
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 parámetro en lugar deobjects: 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 un objeto guardado IDs, 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
Después de exportar los objetos guardados, puede importar el archivo NDJSON a la OpenSearch interfaz de usuario manualmente o mediante la API.
Importe 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 la aplicación de OpenSearch interfaz de usuario y navega hasta el espacio de trabajo de destino.
-
En el espacio de trabajo, selecciona Activos 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.
-
Elija 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 elementos únicos IDs (predeterminado): genera nuevos IDs para todos los objetos importados, lo que evita conflictos con los activos existentes.
-
Comprobar si hay activos existentes: comprueba si hay conflictos con los objetos existentes. Cuando esté seleccionada, elija una de las siguientes subopciones:
-
Sobrescribe automáticamente los conflictos: los activos existentes con el mismo ID se sustituyen automáticamente.
-
Solicita que se tomen medidas en caso de conflicto: se te solicitará que resuelvas cada conflicto de forma individual.
-
-
-
Seleccione Importar.
-
Revise el resumen de la importación.
Importación mediante API
Para importar objetos guardados mediante la API con la autenticación AWS Signature versión 4, primero debe obtener el ID de la fuente de datos y, a continuación, utilizarlo en la solicitud de importación. Sustituya placeholder values por su propia información.
Paso 1: Obtenga el ID de la fuente de datos de su 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
Estos ejemplos utilizan 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 utilizas credenciales temporales).