Guía de migración: Transición de v1 a v3

Esta guía proporciona instrucciones paso a paso para migrar su servicio IBM Cloud Logs Routing de la versión 1 ( v1 ) a la versión 3 ( v3 ). Mientras que v1 proporciona un concepto regional, v3 ofrece un enfoque global con rutas y filtros para ajustar el enrutamiento de los registros de la plataforma a sus necesidades. El proceso de migración consiste en configurar el nuevo entorno v3 y, a continuación, pasar de v1 a v3.

Tenga en cuenta que se producirá una breve interrupción del servicio (aproximadamente unos minutos) durante el paso final de la migración, en el que no se recibirán los registros de la plataforma.

ADVERTENCIA: Esta migración es irreversible. Una vez que haya migrado a v3, no podrá volver a v1.

Escenarios comunes de migración

Antes de iniciar la migración, es importante saber qué escenario se adapta mejor a su arquitectura de registro actual. Los tres escenarios siguientes representan las configuraciones de registro más comunes y le ayudarán a determinar la configuración adecuada para su entorno v3.

Escenario 1: Registro centralizado

En una configuración de registro centralizado, todos los registros de la plataforma de toda su cuenta se consolidan en una única instancia de IBM Cloud Logs.

Este enfoque simplifica la gestión de registros al proporcionar una vista unificada de todas las actividades de la plataforma en toda su cuenta.

Para implementar este escenario en v3, necesitará crear un objetivo que apunte a su instancia centralizada de IBM Cloud Logs y configurar una ruta con una regla comodín para capturar todos los registros de la plataforma independientemente de su región de origen.

Escenario 2: Registro geográfico

El escenario de registro geográfico está diseñado para organizaciones que mantienen múltiples instancias de registro distribuidas en diferentes ubicaciones geográficas.

En esta configuración, los registros de la plataforma de varias regiones se dirigen a la instancia regional IBM Cloud Logs más cercana o designada en función de la proximidad geográfica o de los requisitos de residencia de los datos. Este enfoque equilibra la visibilidad centralizada con la distribución geográfica, permitiéndole dirigir los registros de varias regiones a un número menor de instancias de IBM Cloud Logs estratégicamente situadas.

Para implementar este escenario, necesitará crear múltiples destinos (uno para cada instancia geográfica de IBM Cloud Logs ) y configurar rutas con filtros apropiados basados en regiones para dirigir los registros al destino geográfico correcto.

Escenario 3: Explotación forestal regional

El registro regional representa el enfoque más distribuido, en el que cada región de IBM Cloud tiene su propia instancia dedicada a IBM Cloud Logs.

Esta configuración garantiza el aislamiento regional completo de los datos de registro y se utiliza a menudo para cumplir estrictos requisitos de residencia de datos o de conformidad. En este escenario, los registros de la plataforma generados en una región específica se enrutan exclusivamente a la instancia IBM Cloud Logs desplegada en esa misma región.

Para implementar este escenario en v3, necesitará crear un objetivo y una ruta separados para cada región en la que opere, asegurándose de que cada ruta regional incluya filtros que restrinjan el enrutamiento de registros sólo a la instancia IBM Cloud Logs de esa región.

Enfoques migratorios

Existen dos enfoques para migrar de v1 a v3. Elija el enfoque que mejor se adapte a sus necesidades.

  1. Migración automatizada (recomendada):

    El enfoque de migración automatizada se recomienda para la mayoría de los usuarios, ya que simplifica el proceso de migración y reduce el riesgo de errores de configuración.

    Utilice las API de migración para generar automáticamente destinos y rutas de v3 basados en sus inquilinos existentes de v1.

    Para más información, consulte Migración automatizada.

  2. Configuración manual:

    Configure manualmente su entorno v3 desde cero antes de completar la migración.

    Elija una de estas opciones:

Comprender los estados de migración

El proceso de migración pasa por varios estados:

  • ANTES: El estado inicial antes de que la migración haya comenzado. Si un intento de migración anterior falló, se incluirá el mensaje de error.
  • IN_PROGRESS: El proceso de migración se está ejecutando activamente. Esto puede tardar varios minutos dependiendo de su configuración.
  • PENDING_COMPLETION: Sus rutas y destinos v3 se han creado correctamente. Debe verificar la configuración antes de completar la migración.
  • COMPLETO: La migración se ha completado con éxito y su cuenta utiliza ahora la configuración de v3.

Permisos IAM para la migración

El proceso de migración requiere permisos IAM específicos. Las siguientes acciones globales están disponibles para gestionar la migración:

  • logs-router.migration.post: Configura e inicia la migración. Se trata de un proceso de dos pasos para configurar los metadatos de la cuenta y, a continuación, iniciar la actualización real de todas las regiones. Requiere rol de Administrador.
  • logs-router.migration.get: Recupera el estado de la migración. Disponible para los roles de Administrador, Editor, Operador y Visualizador.
  • logs-router.migration.delete: Elimina el plan de migración generado, incluidos todos los destinos y rutas creados automáticamente en v3. Requiere rol de Administrador.

Debe tener el rol de administrador de plataforma para migrar de V1 a V3.

Para obtener más información sobre las funciones y permisos de IAM, consulte Funciones de IAM.