En un despliegue de Dynatrace Managed, el ActiveGate de Dynatrace se instala a menudo «porque hace falta uno», sin saber realmente cuál. Sin embargo, Managed ofrece dos variantes, el Environment ActiveGate y el Cluster ActiveGate, que no se instalan en el mismo sitio, no responden a las mismas necesidades y no tienen el mismo perímetro de seguridad. De ahí una pregunta recurrente: ActiveGate de entorno vs de clúster, ¿cuál elegir?
Esta distinción no existe con esta forma fuera de Managed: se deriva de que eres tú quien opera el clúster y su exposición de red. Equivocarse de tipo lleva a agentes que no se conectan, a aperturas de firewall innecesarias o a funcionalidades no disponibles.
Este artículo aclara el papel de cada uno, propone una matriz de decisión y muestra cómo instalar y verificar un Environment ActiveGate.
Recordatorio: para qué sirve un ActiveGate
Un ActiveGate es un componente intermedio que se sitúa entre los OneAgent (u orígenes de datos remotos) y el clúster, como muestra el flujo de datos descrito en la arquitectura Dynatrace Managed. Puede:
- concentrar, comprimir y reenviar el tráfico de los agentes;
- servir de punto de salida único para una zona de red aislada;
- consultar API remotas (nube, virtualización, Kubernetes);
- ejecutar extensiones y monitores sintéticos privados.
Por defecto, escucha en el puerto 9999 el tráfico de los agentes.
Environment ActiveGate
Un Environment ActiveGate está asociado a un entorno concreto. Se instala generalmente lo más cerca posible de los hosts monitorizados: en un centro de datos remoto, una DMZ, una VPC en la nube o un clúster de Kubernetes. Sus usos principales:
- Enrutamiento: los OneAgent de un segmento de red le envían sus datos y él los reenvía al clúster.
- Monitorización de nube y plataformas: consulta de las API de AWS, Azure, VMware, Kubernetes… (para Kubernetes, consulta también Dynatrace Operator con un clúster Managed).
- Extensiones: ejecución remota de extensiones (bases de datos, equipos de red…).
Su instalador se descarga desde el entorno y usa un token de ese entorno.
Cluster ActiveGate
Un Cluster ActiveGate está asociado al clúster en su conjunto y sirve a todos los entornos. Se instala normalmente en el borde de la red del clúster, a menudo en una DMZ. Sus usos:
- Acceso externo: permitir que agentes situados fuera de la red interna (Internet, sitios de socios, navegadores para RUM) alcancen el clúster sin exponer directamente los nodos.
- Synthetic privado: un Cluster ActiveGate puede instalarse con el objetivo «ejecutar monitores sintéticos desde una ubicación privada»; con el objetivo de enrutamiento, reenvía además el tráfico de RUM, móvil, synthetic público y API REST.
- Punto de entrada común para varios entornos.
Se instala y se gestiona desde la CMC (Home, menú …, Add new Cluster ActiveGate). En la jerarquía de conexión, un Environment ActiveGate envía a un Cluster ActiveGate, que envía al ActiveGate integrado de los nodos, nunca al revés.
Matriz de decisión: ActiveGate de entorno vs de clúster
| Necesidad | Tipo aconsejado |
|---|---|
| Agentes en una red interna aislada, asociados a un entorno | Environment ActiveGate |
| Monitorización de AWS, Azure, VMware o Kubernetes | Environment ActiveGate |
| Ejecución de extensiones remotas | Environment ActiveGate |
| Agentes o navegadores en Internet que deben alcanzar el clúster | Cluster ActiveGate |
| Exponer el clúster sin abrir los nodos | Cluster ActiveGate |
| Punto de entrada compartido entre varios entornos | Cluster ActiveGate |
Los dos tipos suelen coexistir: Cluster ActiveGate en la DMZ para el acceso externo y Environment ActiveGate en cada zona de red interna. El alcance exacto de las funcionalidades cambia con las versiones: compruébalo para tu versión.
Tutorial paso a paso: instalar un Environment ActiveGate
Paso 1: preparar el servidor
Prevé un servidor Linux dedicado, con al menos un procesador de doble núcleo y 2 GB de RAM (se recomiendan 4 GB) para un uso de enrutamiento sencillo, y más para la monitorización de nube, las extensiones o los entornos grandes.
nproc; free -g; df -h /opt /var
curl -sI --connect-timeout 5 https://{votre-domaine}/ | head -1
El servidor debe poder alcanzar el clúster por HTTPS.
Paso 2: crear un token
En el entorno, crea un token con el scope PaaS integration – Installer download (InstallerDownload), requerido por la API de descarga del instalador de ActiveGate. Guárdalo en un gestor de secretos.
Paso 3: descargar el instalador
Lo más sencillo es copiar el comando que propone el asistente de despliegue de ActiveGate del entorno. Tiene este aspecto:
wget -O Dynatrace-ActiveGate.sh \
--header="Authorization: Api-Token {token}" \
"https://{votre-domaine}/e/{id-environnement}/api/v1/deployment/installer/gateway/unix/latest?arch=x86"
Paso 4: instalar
sudo /bin/sh Dynatrace-ActiveGate.sh --set-network-zone={zone-reseau}
Comprueba con --help los parámetros que acepta tu versión, en particular para la network zone y el grupo de ActiveGate.
Paso 5: verificar el servicio
systemctl list-units --type=service | grep -i gateway
ss -tlnp | grep 9999
journalctl -u "dynatracegateway*" --since "15 min ago" --no-pager | tail -20
El ActiveGate debe aparecer en la lista de ActiveGate del entorno pasados unos minutos.
Paso 6: asociar los OneAgent
Abre el puerto 9999 desde los hosts afectados hacia el ActiveGate y coloca después los agentes en la misma network zone:
sudo /opt/dynatrace/oneagent/agent/tools/oneagentctl --set-network-zone={zone-reseau} --restart-service
sudo /opt/dynatrace/oneagent/agent/tools/oneagentctl --get-server
La lista de puntos de conexión debe incluir ahora el ActiveGate. La instalación del propio agente se detalla en desplegar OneAgent en Linux.
¿Y para un Cluster ActiveGate?
El método es parecido, pero el instalador y el token se obtienen desde la CMC. Colócalo en la DMZ, expón únicamente su puerto HTTPS hacia el exterior y autoriza por su lado los flujos hacia los nodos del clúster. Comprueba después en la CMC que está registrado y operativo.
ActiveGate de Dynatrace: requisitos, puertos, grupos y logs
Antes de instalar un ActiveGate de Dynatrace en Managed, sea un Environment o un Cluster ActiveGate, revisa estos puntos de la documentación de Managed:
- Requisitos de hardware (ActiveGate de enrutamiento y de monitorización en Linux): una máquina dedicada, 2 GB de RAM (se recomiendan 4 GB), un procesador de doble núcleo y 4 GB de espacio libre en disco para la instalación, la configuración y los logs. Los ActiveGate Synthetic y los que alojan el módulo zRemote exigen más y tienen sus propias páginas de requisitos.
- Sistemas y versiones: la lista de distribuciones Linux compatibles (Amazon Linux, Oracle Linux, Red Hat Enterprise Linux, etc.) y de sus versiones cambia; consúltala antes de cada instalación.
- Puertos: tanto un Environment ActiveGate como un Cluster ActiveGate reciben las conexiones en el puerto 9999; el ActiveGate integrado en el clúster Managed las recibe en el puerto 443. El 9999 es el valor por defecto del parámetro
port-sslde la sección[com.compuware.apm.webserver]. - Grupos: un ActiveGate pertenece a un solo grupo,
defaultsi no se indica otro. Se asigna durante la instalación con--set-group=mon-groupe, o después conagctl group set mon-groupe(ActiveGate 1.333+) o con la clavegroupde la sección[collector]decustom.properties, seguido de un reinicio. Un ActiveGate que ejecuta una extensión remota debe pertenecer a un grupo. - Configuración y logs: los ajustes personalizados van en
custom.properties, que tiene prioridad sobreconfig.propertiesy se conserva en las actualizaciones; en Linux, los logs están en/var/log/dynatrace/gateway(se prevén 1,2 GB).
Buenas prácticas
- Despliega los ActiveGate por parejas en cada zona para evitar un punto único de fallo.
- Usa las network zones para controlar el enrutamiento en lugar de configuraciones manuales por host.
- Separa los roles: un ActiveGate de enrutamiento muy cargado no debería soportar además extensiones pesadas.
- No expongas nunca directamente los nodos del clúster en Internet: pasa por Cluster ActiveGate.
- Mantén los ActiveGate actualizados junto con el clúster (consulta planificar las actualizaciones) y vigila su carga como la de cualquier servidor crítico.
Preguntas frecuentes
¿Se pueden usar los dos tipos de ActiveGate a la vez?
Sí, e incluso es habitual: Cluster ActiveGate en la DMZ para el acceso externo y Environment ActiveGate en cada zona de red interna.
¿Qué ActiveGate elegir para monitorizar AWS, Azure o VMware?
Un Environment ActiveGate: está asociado al entorno correspondiente y consulta las API de las plataformas de nube y de virtualización.
¿Cómo pueden alcanzar el clúster los agentes situados en Internet?
A través de un Cluster ActiveGate situado en la DMZ, que solo expone su puerto HTTPS. Los nodos del clúster no deben exponerse nunca directamente en Internet.
Conclusión
Quédate con una regla sencilla: el Environment ActiveGate sirve a un entorno y acerca el clúster a los hosts monitorizados; el Cluster ActiveGate sirve a todo el clúster y controla su exposición hacia el exterior. Eligiendo el tipo adecuado para cada necesidad y combinando los dos con criterio, obtienes una topología clara, segura y resiliente.
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.