Migrar de Managed a SaaS: plan, herramientas y trampas del cambio en Dynatrace

Migrar de Managed a SaaS sin perder visibilidad: inventario, exportación con Monaco, cambio de OneAgent y Operator por oleadas, controles y trampas.
Migrer Managed vers SaaS : plan, outils et pièges de la bascule Dynatrace

Tu clúster lleva años funcionando, las actualizaciones se suceden y el equipo dedica más tiempo a operar Dynatrace que a operar sus propios servicios. La decisión está tomada: migrar de Managed a SaaS. Falta hacerlo sin huecos de visibilidad, sin perder las alertas y sin despertar a la guardia (on-call) a las tres de la madrugada.

Una migración fallida sale cara: hosts que dejan de enviar datos, perfiles de alerta olvidados, SLO que vuelven a empezar de cero. Cada hora sin datos es una hora en la que el MTTR de un incidente real se dispara. La clave es tratar la migración como un cambio de infraestructura: inventario, configuración en código, cambio por oleadas y control en cada paso.

Objetivo de esta guía: un plan concreto en seis pasos, las herramientas que usar (Monaco, oneagentctl, Dynatrace Operator) y las trampas más frecuentes. Afecta a los dos mundos: Dynatrace Managed como origen y Dynatrace SaaS como destino. El programa comercial de migración y sus posibles herramientas de acompañamiento dependen de tu contrato: valídalos con tu interlocutor de Dynatrace.

Qué migra y qué no

Antes de cualquier comando, fija las expectativas con los equipos. Tres familias de objetos se comportan de manera distinta.

Elemento Enfoque Comentario
Configuración (perfiles de alerta, management zones, reglas de etiquetado, detección de anomalías) Exportar y luego importar como código (Monaco o Terraform) Hay que revisarla: algunos objetos clásicos tienen un equivalente distinto en SaaS
Agentes (OneAgent, ActiveGate, Operator) Redirección o reinstalación hacia el nuevo entorno Se hace por oleadas, con un plan de vuelta atrás
Datos históricos (métricas, trazas, logs) No contar con ellos Prever un periodo de doble conservación en el clúster Managed
Usuarios, grupos, tokens Recreación en la cuenta SaaS Los tokens están ligados a su entorno: ninguno sobrevive a la migración

El último punto suele sorprender. Un token de API de un entorno Managed no funciona en un entorno SaaS: cada integración (CI/CD, Collector de OpenTelemetry, scripts) deberá recibir un token nuevo.

Requisitos previos

  • Un entorno Dynatrace SaaS aprovisionado y acceso de administrador a la cuenta.
  • En Managed: un token de API por entorno de origen con los scopes de lectura de configuración (ReadConfig, settings.read).
  • En SaaS: un token de API (WriteConfig, settings.write) y, para los objetos de la plataforma (documentos, workflows), un cliente OAuth o un platform token.
  • La CLI monaco instalada (binario del repositorio Dynatrace/dynatrace-configuration-as-code) y un repositorio Git para versionar la exportación.
  • Un inventario de los hosts, de los clústeres de Kubernetes y de los ActiveGate, con su responsable.

Migrar de Managed a SaaS en seis pasos

Paso 1: inventariar y dividir en oleadas

Lista lo que envía datos al clúster. La API de Cluster y la API de entorno dan la lista de hosts y de versiones de agentes; la guía Automatizar la administración con la API de Cluster muestra cómo consultarla. Agrupa después por oleada: primero un entorno de pruebas, luego los servicios no críticos y por último la producción. Cada oleada tiene un responsable, una fecha y un criterio de éxito medible (por ejemplo: el 100 % de los hosts de la oleada visibles en SaaS en menos de 30 minutos).

Paso 2: exportar la configuración con Monaco

Declara el entorno Managed en un manifiesto. La URL de un entorno Managed contiene la ruta /e/<env-id>.

manifestVersion: 1.0
projects:
  - name: export
environmentGroups:
  - name: source
    environments:
      - name: managed-prod
        url:
          type: environment
          value: MANAGED_URL
        auth:
          token:
            name: MANAGED_TOKEN

Aquí, type: environment indica que el valor es el nombre de una variable de entorno, y token.name designa la variable que contiene el token. No se escribe nada secreto en el archivo.

export MANAGED_URL="https://<votre-domaine>/e/<env-id>"
export MANAGED_TOKEN="dt0c01.XXXX"
monaco download --manifest manifest.yaml --environment managed-prod --output-folder export-managed

Haz commit del resultado tal cual. Ese primer commit sirve de referencia: cualquier modificación posterior será visible en un diff.

Paso 3: limpiar antes de importar

Una migración es el mejor momento para eliminar deuda. Revisa la exportación:

  • elimina los perfiles de alerta y las notificaciones que ya no apuntan a nadie;
  • sustituye los identificadores de entidades escritos a mano (HOST-…, SERVICE-…) por reglas de etiquetas: cambiarán en SaaS;
  • agrupa las management zones redundantes (consulta Management zones y etiquetado automático);
  • anota los objetos que no existen con la misma forma en SaaS, como algunos dashboards clásicos o SLO, que habrá que recrear con las herramientas de la plataforma.

Paso 4: desplegar la configuración en SaaS

Añade el entorno de destino al manifiesto y lanza primero una prueba en seco:

environmentGroups:
  - name: target
    environments:
      - name: saas-prod
        url:
          type: environment
          value: SAAS_URL
        auth:
          token:
            name: SAAS_TOKEN
export SAAS_URL="https://<env-id>.live.dynatrace.com"
monaco deploy manifest.yaml --environment saas-prod --dry-run
monaco deploy manifest.yaml --environment saas-prod

El --dry-run valida los archivos y las referencias sin escribir nada. Corrige cada error en el repositorio, no en la interfaz: la configuración en código debe seguir siendo la fuente de verdad.

Paso 5: redirigir los agentes, oleada a oleada

En un host, oneagentctl cambia el punto de comunicación sin reinstalar. Obtén el environment ID, el tenant token y la URL de comunicación en el entorno SaaS y después:

sudo /opt/dynatrace/oneagent/agent/tools/oneagentctl \
  --set-server=https://<env-id>.live.dynatrace.com/communication \
  --set-tenant=<env-id> \
  --set-tenant-token=<tenant-token> \
  --restart-service

La URL debe terminar en /communication. Los procesos instrumentados en profundidad deben reiniciarse para reportar al nuevo entorno: planifícalo con los equipos de aplicaciones. Una reinstalación limpia mediante tu herramienta de despliegue (Ansible, por ejemplo) sigue siendo una opción más sencilla de auditar para parques grandes.

En Kubernetes, la URL de API de un DynaKube no se modifica in situ en las versiones recientes de Dynatrace Operator: elimina el DynaKube y el secreto, recrea el secreto con los tokens de SaaS y vuelve a aplicar el DynaKube con la nueva apiUrl. El despliegue inicial se detalla en Conectar Dynatrace Operator a un clúster.

kubectl delete dynakube dynakube -n dynatrace
kubectl delete secret dynakube -n dynatrace
kubectl -n dynatrace create secret generic dynakube \
  --from-literal="apiToken=<OPERATOR_TOKEN>" \
  --from-literal="dataIngestToken=<DATA_INGEST_TOKEN>"
kubectl apply -f dynakube-saas.yaml

Paso 6: cambiar las integraciones

Sustituye URL y token en cada cliente: exportadores OTLP, pipelines de CI/CD, scripts de API, webhooks entrantes. Hazlo con secretos versionados en tu gestor, nunca escritos a mano. Mantén el clúster Managed en modo lectura durante el periodo de comparación y de la retención histórica que necesites.

Cómo comprobar que funciona

  • Agentes: en el host, oneagentctl --get-server y --get-tenant deben devolver los valores de SaaS. En el entorno SaaS, el host aparece en la lista de hosts en pocos minutos.
  • Configuración: vuelve a lanzar monaco deploy --dry-run; no debe aparecer ninguna diferencia. Compara el número de perfiles de alerta y de management zones entre origen y destino.
  • Datos: en un Notebook de SaaS, cuenta los hosts que envían métricas:
timeseries cpu = avg(dt.host.cpu.usage), by:{dt.entity.host}
| summarize hotes = count()

Compara ese número con el inventario de la oleada. Una diferencia señala un host olvidado o bloqueado por un firewall de salida.

  • Alertas: dispara una alerta de prueba y comprueba que llega al canal correcto. Una alerta que no llega es peor que una alerta ruidosa.

Buenas prácticas y trampas frecuentes

  • Firewall: los hosts deben alcanzar el entorno SaaS (o un ActiveGate que lo alcance) por HTTPS de salida. Abre los flujos antes de la oleada, no durante.
  • Identificadores de entidades: todo lo que referencia un ID escrito a mano se rompe. Las etiquetas y los selectores de entidades sobreviven.
  • Doble envío: un host solo reporta a un único entorno. Para comparar, deja hosts testigo en Managed en lugar de intentar un doble envío.
  • Licencia: el modelo de consumo de SaaS difiere del de tu contrato Managed. Haz validar la estimación antes de la oleada de producción.
  • Calendario: evita los congelamientos de cambios y los picos de actividad. Los ciclos de actualización del clúster Managed continúan durante la migración.
  • Comunicación: publica el estado de cada oleada. Una migración sin culpables se documenta como un incidente: lo que funcionó, lo que sorprendió, lo que se cambia para la oleada siguiente.

Preguntas frecuentes

¿Se puede recuperar el historial de datos de Managed en SaaS?

No construyas tu plan sobre esa hipótesis. Prevé mantener accesible el clúster Managed durante la retención que necesites e infórmate en Dynatrace sobre las opciones propias de tu contrato.

¿Hay que reinstalar OneAgent?

No necesariamente. oneagentctl basta para redirigir un agente compatible. Una reinstalación sigue siendo útil si el agente es antiguo o si quieres aprovechar la migración para normalizar las opciones de instalación.

¿Monaco o Terraform para la configuración?

Los dos saben exportar y desplegar. Monaco suele ser más rápido para una exportación masiva; Terraform conviene si tus equipos ya gestionan su infraestructura con él. Elige una sola herramienta como fuente de verdad para evitar conflictos.

Conclusión

Migrar de Managed a SaaS se dirige como un proyecto de infraestructura: inventario, configuración en código, cambio por oleadas, control medible. Exporta con Monaco, limpia, despliega en seco y después redirige los agentes por lotes. Mantén Managed en modo lectura el tiempo necesario: la visibilidad nunca debe caer durante el cambio.

span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC. Dynatrace es una marca de su propietario. Las condiciones de migración, las herramientas ofrecidas y los nombres de las pantallas evolucionan: compruébalos en la documentación oficial y con Dynatrace.

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
OpenTelemetry Python FastAPI : instrumenter une API vers Dynatrace sans OneAgent

OpenTelemetry Python FastAPI: instrumenta una API hacia Dynatrace sin OneAgent

Next Post
Pods en CrashLoopBackOff OOMKilled : diagnostiquer avec Dynatrace

Pods en CrashLoopBackOff OOMKilled: diagnóstico con Dynatrace

Related Posts