En un entorno Dynatrace Managed, la actualización nunca es algo que «ocurre solo». El clúster funciona en tus servidores, en tus centros de datos, al ritmo de tus ventanas de mantenimiento. Cada nueva versión aporta correcciones de seguridad, mejoras de la interfaz y compatibilidad con nuevas tecnologías monitorizadas, pero también implica un reinicio progresivo de servicios, una comprobación del espacio en disco y coordinación con los equipos de aplicaciones. La actualización del clúster Managed se planifica, por tanto, como cualquier otra operación de explotación.
La verdadera trampa es la acumulación. Un clúster que se salta varias versiones acaba teniendo que ponerse al día en varios pasos, mientras los OneAgent desplegados en cientos de hosts envejecen a su vez y salen de la ventana de compatibilidad. Te encuentras entonces con un proyecto de varias semanas donde una rutina mensual habría bastado.
Este artículo propone un método para planificar las actualizaciones del clúster Managed y de los OneAgent: entender qué se actualiza y en qué orden, preparar los requisitos previos, dirigir la operación desde la Cluster Management Console (CMC) y la API, y después industrializarlo todo.
Qué se actualiza (y en qué orden)
Un despliegue Managed tiene varias capas, cada una con su propio ciclo de vida:
- Los nodos del clúster: servidor Dynatrace, Cassandra, Elasticsearch, almacenamiento de transacciones, componentes web. Se actualizan juntos, nodo a nodo.
- Los Cluster ActiveGate y Environment ActiveGate: dialogan con el clúster y deben mantenerse en un rango de versiones compatible.
- Los OneAgent: instalados en los hosts monitorizados, se gestionan por entorno, por grupo de hosts o individualmente.
- Dynatrace Operator en Kubernetes, que gestiona por sí mismo los OneAgent y ActiveGate declarados en el recurso
DynaKube.
La regla de oro: primero el clúster, después los ActiveGate y por último los OneAgent. Este orden se deduce del funcionamiento de Managed: los paquetes de OneAgent, ActiveGate y RUM los distribuye el propio clúster, junto con sus actualizaciones. Las ventanas de compatibilidad entre versiones deben comprobarse en la documentación oficial; la CMC señala, por ejemplo, los Cluster ActiveGate con un retraso de más de cinco versiones.
¿Actualizaciones automáticas o manuales?
Cuando el clúster está conectado a Mission Control, la CMC puede descargar las nuevas versiones y proponer una instalación automática en una ventana de mantenimiento que tú defines. En modo sin conexión (offline), los paquetes recibidos por correo electrónico se cargan en la CMC, que los distribuye a todos los nodos. Una actualización automática solo se ejecuta en la primera ventana de mantenimiento que se produce 24 horas después de la descarga del paquete. En ambos casos, eres tú quien decide el momento.
| Modo | Ventajas | Puntos de atención |
|---|---|---|
| Automático (ventana de mantenimiento) | Clúster siempre al día, poco esfuerzo | Ventana que alinear con los congelamientos de cambios; vigilar las notificaciones |
| Manual lanzado desde la CMC | Control total de la fecha, validación previa posible | Hace falta disciplina para no acumular retraso |
| Offline (paquete transferido) | Compatible con entornos air-gapped | Procedimiento de transferencia y verificación de integridad que documentar |
Preparar la actualización del clúster Managed
La mayoría de los incidentes de actualización vienen de un requisito previo descuidado. Antes de cada operación, repasa esta lista:
- Salud del clúster: todos los nodos están en estado «Healthy» en la CMC y no hay ninguna alerta de almacenamiento en curso.
- Espacio en disco: la actualización descomprime los nuevos binarios bajo
/opt/dynatrace-managedy puede desencadenar migraciones de datos bajo/var/opt/dynatrace-managed. La documentación exige al menos 5 GB libres en la partición de instalación y 24 horas de separación entre dos actualizaciones del clúster. - Copia de seguridad reciente: comprueba que la última copia de seguridad del clúster en el almacenamiento NFS terminó correctamente.
- Notas de la versión: lee los cambios de comportamiento, las tecnologías obsoletas y la versión mínima requerida de OneAgent y ActiveGate.
- Comunicación: avisa a los usuarios; con menos de tres nodos, el clúster es inaccesible durante la actualización; con más, la interfaz sigue disponible, pero pueden producirse desconexiones puntuales.
Tutorial paso a paso
Paso 1 — Comprobar el estado del clúster y de los nodos
En la CMC, abre la página de vista general del clúster y confirma que cada nodo está operativo. En el sistema, en cada nodo:
systemctl list-units --type=service | grep -i dynatrace
df -h /opt/dynatrace-managed /var/opt/dynatrace-managed
sudo /opt/dynatrace-managed/utils/cassandra-nodetool.sh status
También puedes consultar la API de Cluster para listar los nodos y su estado, con un Cluster API token que tenga el permiso Service Provider API (Cluster API v1):
curl -s -H "Authorization: Api-Token {token-cluster}" \
"https://{votre-domaine}/api/v1.0/onpremise/cluster" | python3 -m json.tool
Paso 2 — Controlar la última copia de seguridad
En la CMC, en la sección de ajustes de copia de seguridad, comprueba la fecha y el estado de la última copia. En el almacenamiento compartido:
ls -lh {point-de-montage-nfs}/
df -h {point-de-montage-nfs}
Si la última copia ha fallado, corrige la causa antes de cualquier actualización.
Paso 3 — Definir la ventana de mantenimiento
En Settings > Automatic update de la CMC, elige entre instalación automática y manual, y define una ventana (por ejemplo, el martes entre las 22:00 y las 2:00). Aliníala con tu calendario de congelamiento de cambios y documéntala en tu herramienta ITSM.
Paso 4 — Lanzar la actualización del clúster
Cuando la nueva versión esté disponible, lanza la instalación desde Settings > Automatic update de la CMC, o mediante la API Cluster v1:
curl -s -X POST -H "Authorization: Api-Token {token-cluster}" \
"https://{votre-domaine}/api/v1.0/upgradeManagement/triggerUpgrade"
Después, sigue el progreso en Deployment Status.
En modo offline, carga el paquete mediante Upload installation package. En una actualización totalmente manual, copia dynatrace-managed-{version}.sh en /opt/dynatrace-managed/installer/upgrade en cada nodo y ejecútalo como root con --upgrade, un nodo cada vez, esperando a que termine cada uno.
Paso 5 — Validar tras la actualización
- La versión que muestra la CMC corresponde a la versión objetivo en todos los nodos.
- Los entornos siguen recibiendo datos (comprueba un host y un servicio clave).
- Los ActiveGate están conectados y no aparece ningún evento de error de conexión.
Paso 6 — Actualizar los ActiveGate
Una vez estabilizado el clúster, actualiza los ActiveGate, ya sea mediante la actualización automática desde la interfaz del entorno, ya sea reinstalando el paquete descargado desde tu clúster. Empieza por un ActiveGate no crítico.
Paso 7 — Desplegar los OneAgent por oleadas
En cada entorno, los ajustes de actualización de los OneAgent permiten elegir una versión objetivo y una ventana de mantenimiento, a nivel global, de grupo de hosts o de host. Estrategia recomendada:
- Oleada 1: grupo de hosts de pruebas (
--set-host-group=recetteen la instalación). - Oleada 2: producción no crítica, unos días después.
- Oleada 3: producción crítica, tras la validación.
Para un host aislado, comprueba la versión instalada con oneagentctl:
sudo /opt/dynatrace/oneagent/agent/tools/oneagentctl --version
sudo /opt/dynatrace/oneagent/agent/tools/oneagentctl --get-host-group
Para obtener el último instalador desde tu clúster (caso de los hosts reinstalados por automatización):
curl -o oneagent.sh -H "Authorization: Api-Token {token}" \
"https://{votre-domaine}/e/{id-environnement}/api/v1/deployment/installer/agent/unix/default/latest?arch=x86"
sudo /bin/sh oneagent.sh --set-host-group={groupe} --set-monitoring-mode=fullstack
Ten en cuenta que la mayoría de las actualizaciones de OneAgent requieren reiniciar los procesos de aplicación para activar la nueva versión de la instrumentación: planifícalo con los equipos de aplicaciones.
Paso 8 — Kubernetes: Dynatrace Operator
En Kubernetes, actualiza primero el Operator con tu método habitual (Helm o manifiestos) y deja que él alinee los OneAgent declarados en la DynaKube (cuyo apiUrl apunta a https://{votre-domaine}/e/{id-environnement}/api). Después, comprueba:
kubectl -n dynatrace get dynakube
kubectl -n dynatrace get pods -o wide
Buenas prácticas
- Una cadencia fija: una actualización del clúster por ciclo de publicación, sin saltarse versiones, vale más que una puesta al día masiva.
- Un clúster de pruebas: si tu licencia lo permite, un pequeño clúster Managed de preproducción que reciba cada versión una o dos semanas antes que producción.
- Grupos de hosts pensados para la actualización: nómbralos por criticidad y por entorno para poder dirigir las oleadas.
- Un runbook versionado: comprobaciones previas, comandos, criterios de validación y procedimiento de vuelta atrás documentados y revisados después de cada operación.
- Vigilar la compatibilidad: un dashboard que liste las versiones de OneAgent por grupo de hosts ayuda a localizar los hosts olvidados.
Preguntas frecuentes
¿En qué orden se actualizan los componentes?
Primero el clúster, después los ActiveGate y por último los OneAgent: es el clúster quien distribuye los paquetes de los agentes. Comprueba las ventanas de compatibilidad en la documentación oficial.
¿Se pueden saltar versiones del clúster?
A veces: solo una versión instalada divisible por 4 (1.300, 1.304…) permite saltarse la siguiente, una vez publicada la versión objetivo; en caso contrario, hay que pasar por cada versión. Desde la 1.324, una opción de la CMC impone actualizaciones secuenciales. Una actualización por ciclo sigue siendo la rutina más sencilla.
¿La nueva versión de un OneAgent se activa de inmediato?
No siempre: la mayoría de las actualizaciones de OneAgent requieren reiniciar los procesos de aplicación para activar la nueva instrumentación. Planifica esos reinicios con los equipos de aplicaciones.
Conclusión
Actualizar Dynatrace Managed no tiene nada de arriesgado si respetas el orden clúster → ActiveGate → OneAgent, compruebas salud, disco y copia de seguridad antes de actuar, y despliegas los agentes por oleadas. La ganancia real viene de la regularidad: una rutina corta y repetida convierte una operación temida en un no-evento y mantiene tu plataforma de observabilidad tan fiable como las aplicaciones que vigila.
span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC. Dynatrace es una marca de Dynatrace LLC. Comprueba siempre los valores (puertos, versiones, tamaños) en la documentación oficial correspondiente a tu versión de Managed.