Módulo 3 del curso de Dynatrace Managed: OneAgent y ActiveGate, instalar el agente en un host y elegir el tipo de ActiveGate de Dynatrace adecuado.
Curso: Dynatrace Managed · Módulo 3/8 · Duración: ~45 min · Nivel: Principiante
Objetivos:
- Instalar OneAgent en un host Linux y verificar su conexión
- Elegir el modo de monitorización y el grupo de hosts
- Entender cuándo hace falta un ActiveGate y cuál elegir
- Conocer las opciones para Windows y Kubernetes
Requisitos previos: módulo 2; un clúster o un entorno de pruebas; una VM Linux para monitorizar.
Un clúster sin agentes no muestra nada. Este módulo te enseña a desplegar OneAgent y ActiveGate en un entorno de Dynatrace Managed: instalación del agente en un host, ajustes que conviene decidir desde el principio y, después, el papel de los ActiveGate y la elección entre sus dos variantes propias de Managed.
OneAgent y ActiveGate: empezar por el agente en Linux
En el entorno, la pantalla de despliegue de OneAgent genera por ti el comando de descarga y el token necesario. En esencia, el comando se parece a esto:
wget -O Dynatrace-OneAgent-Linux.sh \
"https://{votre-domaine}/e/{id-environnement}/api/v1/deployment/installer/agent/unix/default/latest?arch=x86" \
--header="Authorization: Api-Token {jeton}"
sudo /bin/sh Dynatrace-OneAgent-Linux.sh \
--set-monitoring-mode=fullstack \
--set-host-group=recette-commandes
Tres puntos de atención:
- El token da derecho a descargar el instalador. Usa el que genera la pantalla de despliegue, no lo guardes en claro en un repositorio y anota su fecha de caducidad.
- El modo de monitorización: full-stack activa la monitorización profunda de los procesos (trazas, servicios); existe un modo limitado a la infraestructura para los hosts en los que solo interesan las métricas del sistema. Esta elección influye en el consumo de licencia.
- El grupo de hosts (
--set-host-group) agrupa hosts que desempeñan el mismo papel. Influye en cómo Dynatrace agrupa los procesos y sirve de base para las reglas de tags del módulo 6. Decide una convención de nombres antes de desplegar a gran escala.
Verificar que el agente funciona
Una vez instalado, OneAgent se ejecuta como servicio del sistema. La herramienta oneagentctl permite leer y modificar su configuración a posteriori:
systemctl status oneagent
sudo /opt/dynatrace/oneagent/agent/tools/oneagentctl --get-server
sudo /opt/dynatrace/oneagent/agent/tools/oneagentctl --get-host-group
En la interfaz, el host aparece en unos minutos en la lista de hosts. Los procesos iniciados antes de la instalación son visibles pero no están instrumentados: reiníciales (servidor de aplicaciones, servidor web) para ver aparecer sus servicios y sus trazas. Es el error de principiante más frecuente.
El detalle de las opciones, de los casos con proxy y de los despliegues a gran escala se trata en Desplegar OneAgent en Linux en un entorno Managed.
Windows y Kubernetes
En Windows Server, el instalador se usa en modo gráfico o silencioso con parámetros equivalentes; consulta Instalar OneAgent en Windows Server en modo silencioso. En Kubernetes y OpenShift no se instala nodo por nodo: Dynatrace Operator y un recurso DynaKube que apunta a https://{votre-domaine}/e/{id-environnement}/api se encargan del despliegue, como explica Kubernetes y OpenShift: conectar Dynatrace Operator a un clúster Managed.
¿Qué es un ActiveGate y cuándo hace falta?
Un ActiveGate es un componente Java instalado en una máquina dedicada, que hace de intermediario entre fuentes de datos y el clúster. Por defecto escucha en el puerto 9999. Hace falta en varias situaciones:
- los OneAgent están en una red que no puede alcanzar directamente el clúster (DMZ, otro sitio): el ActiveGate concentra y retransmite su tráfico;
- se quieren monitorizar recursos sin agente: plataformas cloud, extensiones remotas, equipos consultados por API;
- se quieren ejecutar tests sintéticos desde una ubicación privada;
- se quiere limitar el número de flujos que atraviesan un cortafuegos.
¿Environment ActiveGate o Cluster ActiveGate?
Managed distingue dos tipos de ActiveGate:
| Environment ActiveGate | Cluster ActiveGate | |
|---|---|---|
| Vinculación | Un entorno concreto | El clúster entero |
| Usos típicos | Enrutamiento de los agentes de una red, extensiones, monitorización cloud | Acceso desde el exterior (agentes fuera de la red, datos RUM procedentes de internet), ubicaciones Synthetic privadas |
| Se instala desde | La interfaz del entorno | La Cluster Management Console |
En la práctica: empieza por un Environment ActiveGate para tus necesidades internas y reserva el Cluster ActiveGate para los flujos que llegan desde fuera de la red del clúster. La lista exacta de funciones de cada tipo evoluciona con las versiones; el artículo ActiveGate en Managed: ¿Environment ActiveGate o Cluster ActiveGate? detalla los criterios.
Las network zones
Cuando existen varios ActiveGate en varios sitios, la opción --set-network-zone de OneAgent indica al agente qué zona de red debe preferir. Así, los agentes de un centro de datos pasan por los ActiveGate de ese centro de datos. Es innecesaria para una primera prueba y útil en cuanto la infraestructura está repartida.
ActiveGate de Dynatrace: requisitos, puertos, grupos y logs
Antes de instalar un ActiveGate de Dynatrace en Managed, sea un Environment o un Cluster ActiveGate, comprueba 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 (4 GB recomendados), 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 requieren 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 evoluciona; 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 en 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(1,2 GB previstos).
Ejercicio práctico
Paso 1 — Instalar OneAgent
Desde la pantalla de despliegue de tu entorno de pruebas, copia el comando de Linux, añade un grupo de hosts a tu elección y ejecútalo en una VM. Resultado esperado: el servicio oneagent activo y el host visible en la lista de hosts con su grupo.
Paso 2 — Instrumentar una aplicación
Instala un servidor web sencillo (nginx o Apache) o arranca una aplicación Java de demostración y reiníciala. Genera tráfico con curl en bucle. Resultado esperado: aparece un servicio web, con peticiones y tiempos de respuesta.
Paso 3 — Leer la configuración
Usa oneagentctl --get-server y --get-host-group. Resultado esperado: la dirección del clúster o del ActiveGate utilizado, y el grupo definido en el paso 1.
Paso 4 — Diseñar la ubicación de los ActiveGate
En papel, dibuja tu red real (sitios, DMZ, acceso a internet) y coloca los ActiveGate necesarios indicando su tipo. Resultado esperado: un esquema que justifique cada ActiveGate con un flujo concreto.
Cuestionario
- ¿Por qué no aparece un servicio tras instalar OneAgent? a) El token ha caducado b) El proceso no se ha reiniciado c) Falta un ActiveGate d) El modo full-stack está desactivado por defecto
- ¿Para qué sirve la opción –set-host-group? a) Elegir el clúster b) Agrupar hosts del mismo papel c) Definir la zona de red d) Limitar la licencia
- ¿Qué ActiveGate elegir para recibir datos procedentes de internet? a) Environment ActiveGate b) Cluster ActiveGate c) Ninguno d) Un OneAgent en modo infraestructura
- ¿Cómo se despliega OneAgent en Kubernetes? a) En cada nodo a mano b) Con Dynatrace Operator y un recurso DynaKube c) Mediante la CMC d) Con un ActiveGate
Soluciones
- b) La inyección ocurre al arrancar el proceso; un proceso anterior a la instalación debe reiniciarse.
- b) El grupo de hosts reúne hosts que desempeñan el mismo papel y sirve para las reglas de configuración.
- b) El Cluster ActiveGate procesa los flujos externos a la red del clúster.
- b) El Operator gestiona el ciclo de vida de los agentes a partir del recurso DynaKube.
Para ir más lejos
- Desplegar OneAgent en Linux en un entorno Managed
- ActiveGate en Managed: ¿Environment o Cluster?
- Conectar Dynatrace Operator a un clúster Managed
- Documentación oficial de Dynatrace Managed (OneAgent y ActiveGate)
← Módulo 2: Arquitectura de un clúster Managed e instalación · Índice del curso · Módulo 4: Explorar los datos →
Preguntas frecuentes
¿Hace falta un ActiveGate para empezar?
No. Si los hosts alcanzan directamente el clúster, OneAgent puede conectarse sin intermediario. El ActiveGate pasa a ser necesario para atravesar zonas de red, monitorizar sin agente o lanzar tests sintéticos privados.
¿OneAgent reinicia mis aplicaciones?
No. La instalación no detiene ningún proceso. Te corresponde a ti planificar el reinicio de las aplicaciones que quieras instrumentar, idealmente en una ventana de mantenimiento.
¿Se puede cambiar el grupo de hosts después de la instalación?
Sí, con oneagentctl, pero el cambio puede modificar la agrupación de los procesos y, por tanto, el historial de las entidades. Fija la convención antes del despliegue masivo.
Tus hosts ya envían datos. El módulo 4 te enseña a recorrerlos: de los hosts a los servicios, hasta las trazas PurePath y los problemas abiertos por Davis.
span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC. Este curso no sustituye a las formaciones y certificaciones oficiales de Dynatrace University. Comprueba siempre las funcionalidades en la documentación oficial correspondiente a tu versión.