Actualización del clúster Managed: planificar el clúster, los ActiveGate y los OneAgent

Actualización del clúster Managed sin estrés: orden clúster, ActiveGate y OneAgent, requisitos previos que revisar y método de despliegue por oleadas.
Mises à jour cluster Managed : planifier le cluster, les ActiveGate et les OneAgent

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-managed y 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:

  1. Oleada 1: grupo de hosts de pruebas (--set-host-group=recette en la instalación).
  2. Oleada 2: producción no crítica, unos días después.
  3. 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.

Total
0
Shares
Leave a Reply

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

Previous Post
Sauvegarde/restauration d'un cluster Dynatrace Managed

Copia de seguridad y restauración de un clúster Dynatrace Managed

Next Post
Rétention des données et gestion du stockage en Managed

Retención y almacenamiento de datos en Dynatrace Managed

Related Posts