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
monacoinstalada (binario del repositorioDynatrace/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-servery--get-tenantdeben 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.