View a markdown version of this page

Migración de objetos guardados desde OpenSearch Paneles a OpenSearch UI - Amazon OpenSearch Servicio

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 desde OpenSearch Paneles a OpenSearch UI

Si ya tiene paneles, visualizaciones, patrones de índice y otros objetos guardados en OpenSearch Los paneles de control se pueden migrar y reutilizar en OpenSearch UI.

Beneficios de migrar a OpenSearch INTERFAZ DE USUARIO:

  • Alta disponibilidad — OpenSearch La interfaz de usuario está alojada en Nube de AWS y permanece disponible durante las actualizaciones y el mantenimiento del dominio, mientras OpenSearch Los paneles están alojados en el dominio y no estarán disponibles temporalmente.

  • Fuente de datos múltiple — OpenSearch La interfaz de usuario puede proporcionar un panel de vidrio único y consolidado en varias fuentes de datos, que incluyen OpenSearch dominios, recopilaciones sin servidor y conexiones de datos con Amazon S3 y Amazon CloudWatch; mientras que cada OpenSearch Los paneles solo pueden funcionar con un dominio o colección.

  • Funciones adicionales — El asistente de IA y los espacios de trabajo están disponibles en OpenSearch UI. Para obtener más información sobre OpenSearch UI, consulte Uso OpenSearch Interfaz de usuario en Amazon OpenSearch Servicio.

Información general sobre la migración

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

  1. Exporte los objetos guardados desde OpenSearch Paneles — Usa el OpenSearch La interfaz de usuario de administración de objetos guardados de paneles 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. Crea un OpenSearch Aplicación de interfaz de usuario y espacio de trabajo — Si aún no lo ha hecho, cree un OpenSearch Una aplicación de interfaz de usuario y un espacio de trabajo para recibir los objetos importados.

  3. Registre la fuente de datos en OpenSearch UI — Asocia tu OpenSearch dominio con el OpenSearch aplicación de 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.

  4. Importe los objetos guardados a OpenSearch UI — Usa el OpenSearch La interfaz de usuario, la interfaz de usuario, la interfaz de usuario de gestión de objetos guardados o la API de importación para cargar el archivo NDJSON en el espacio de trabajo de destino.

  5. Valide los objetos importados — Abra sus paneles y visualizaciones en OpenSearch Interfaz de usuario para verificar 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 OpenSearch versión 1.3 y posteriores. Compruebe que su OpenSearch el dominio ejecuta la versión 1.3 o superior antes de intentar migrar los objetos guardados.

Paso 1: Exporta los objetos guardados desde OpenSearch Paneles

Exporta tus objetos guardados desde OpenSearch Paneles que utilizan 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.

Exporta manualmente en OpenSearch Tableros

Para exportar objetos guardados mediante OpenSearch Interfaz de usuario de administración de paneles
  1. Abre tu OpenSearch Instancia de dashboards.

  2. En el panel de navegación izquierdo, elige Administración.

  3. Bajo Administración de tableros, elige Objetos guardados.

  4. Seleccione los objetos guardados que desea 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 Exportar objetos guardados cuadro de diálogo, asegúrese de que Incluya objetos relacionados está seleccionado. 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. Elige Exportar para descargar el .ndjson archivo a su máquina local.

sugerencia

Cuando eliges Incluya objetos relacionados, el archivo NDJSON exportado contiene todos los objetos guardados necesarios para renderizar 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 utilizar el OpenSearch La API de exportación de objetos guardados de Dashboards para exportar los objetos guardados mediante programación. Esto es útil para automatizar las migraciones o integrar el paso de exportación en un CI/CD canalización.

nota

Si tu OpenSearch el dominio tiene control de acceso detallado habilitada, debe proporcionar las credenciales de autenticación junto con la solicitud de exportación. Utilice la autenticación básica HTTP añadiendo el -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 el -u bandera.

Para exportar objetos guardados específicos por ID, utilice 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 encontrar 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 puedes encontrar el ID en la URL del navegador al ver el objeto en OpenSearch Tableros de mandos.

Paso 2: Importe los objetos guardados a OpenSearch UI

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

Importar manualmente en OpenSearch UI

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

  2. En el espacio de trabajo, elija Activos desde la barra de navegación superior o ve a la página de activos del espacio de trabajo.

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

  4. Elige Seleccione un archivo y seleccione el .ndjson archivo desde el que exportó OpenSearch Tableros de mandos.

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

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

    • Compruebe 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.

      • Solicita 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 AWS Para la autenticación con Signature Version 4, primero debe 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: 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 OpenSearch UI.

Paso 2: Importe los objetos guardados con 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 función integrada de curl --aws-sigv4 opción (disponible en curl 7.75 o posterior) para firmar las solicitudes. Configura tu AWS las credenciales como variables de entorno antes de ejecutar los comandos: AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, y AWS_SESSION_TOKEN (si utiliza credenciales temporales).

Uso de la herramienta de migración integrada en la aplicación

Usa la herramienta de migración integrada en la aplicación cuando quieras llevar los objetos guardados de un dominio existente a un espacio de trabajo sin tener que exportar ni importar archivos tú mismo. Con OpenSearch La interfaz de usuario permite copiar los objetos guardados de una fuente de datos asociada a un espacio de trabajo, de modo que no es necesario exportarlos e importarlos manualmente. La migración copia los objetos en OpenSearch Interfaz de usuario; nunca borra ni modifica nada de la fuente.

Para abrir la herramienta, elija Migre los paneles desde las fuentes de datos en el OpenSearch página de inicio de la interfaz de usuario, o elija Administración de paneles y luego Migre a OpenSearch UI. En esa página se enumeran las fuentes de datos desde las que puede migrar y un historial de las migraciones anteriores con enlaces a los espacios de trabajo que crearon.

La migración escanea la fuente de datos en busca de objetos guardados, los organiza por arrendatario, crea o actualiza un espacio de trabajo como destino e importa los objetos en él, enlazados a la fuente de datos correcta. Se ejecuta en el servidor. En función del número de objetos guardados, la migración puede tardar varios minutos en finalizar.

En la tabla siguiente se muestra lo que incluye la migración y lo que deja en el dominio.

Qué incluye la migración
Incluido No incluido
Paneles Configuraciones de fuentes de datos
Visualizaciones, que incluyen VisBuilder y TSVB Application settings
Patrones de índice Monitores de alertas
Búsquedas guardadas Indexe las políticas de gestión estatal
Consultas guardadas Configuraciones de seguridad
URL abreviadas Cuadernos

Los elementos excluidos permanecen en el dominio. Tras asociar el dominio como fuente de datos, puede acceder a ellos a través de OpenSearch Interfaz de usuario sin migrarlos.

Se aplican los siguientes límites:

  • Puede migrar hasta 10 000 objetos guardados en una sola migración.

  • Solo puede ejecutar una migración para una fuente de datos a la vez.

  • Una migración es idempotente. Repitirla con los mismos parámetros devuelve el resultado existente.

Tras una migración, abra el espacio de trabajo de destino y confirme que los paneles se renderizan, que los patrones de índice están asociados a la fuente de datos correcta y que las búsquedas guardadas arrojan los resultados esperados. Para obtener más información sobre los pasos para cada tipo de fuente, consulte Escenarios de migración para OpenSearch UI.