Módulo 2: desplegar OneAgent y Dynatrace Operator en hosts y Kubernetes

Desplegar OneAgent en Linux y Dynatrace Operator en Kubernetes con DynaKube: modos de monitorización, pasos, trampas comunes, ejercicio y cuestionario.
Module 2 — Déployer OneAgent et Dynatrace Operator sur hôtes et Kubernetes

Ruta de aprendizaje: Dynatrace SaaS · Módulo 2/8: desplegar OneAgent y Dynatrace Operator · Duración: ~60 min · Nivel: principiante

Objetivos:

  • Entender qué recoge OneAgent y qué modos de monitorización hay disponibles.
  • Instalar OneAgent en un host Linux de prueba y comprobar que llega al entorno.
  • Desplegar Dynatrace Operator en Kubernetes con un recurso DynaKube.
  • Saber diagnosticar los fallos de despliegue más habituales.

Requisitos previos: módulo 1, una máquina Linux de prueba con permisos de root, un clúster de Kubernetes de prueba y kubectl; se recomienda Helm.

Un entorno de Dynatrace sin datos no muestra nada. Este módulo explica cómo desplegar OneAgent y Dynatrace Operator, los dos medios principales de recogida automática: OneAgent para los hosts clásicos y el Operator para los clústeres de Kubernetes. Forma parte de la ruta de aprendizaje de Dynatrace SaaS y prepara los módulos de análisis que siguen.

El objetivo no es cubrir todas las opciones de instalación, que son muchísimas, sino lograr un primer despliegue limpio y entender qué ocurre.

¿Qué hace OneAgent?

OneAgent es un agente que se instala una sola vez por host. Descubre automáticamente los procesos, inyecta una instrumentación en las tecnologías compatibles (Java, .NET, Node.js, PHP, Go, servidores web…) y envía al entorno métricas, trazas distribuidas, logs y la topología. No hace falta modificar el código de la aplicación para obtener las trazas de las tecnologías compatibles.

OneAgent puede funcionar con varios niveles de monitorización. Los nombres exactos varían según las versiones, pero la idea es la misma:

Nivel Qué se recoge Caso de uso
Full-stack Infraestructura, procesos, trazas de aplicación, logs Servidores de aplicaciones que se quieren monitorizar en profundidad
Infraestructura Host, procesos, red, sin instrumentación de aplicación Bases de datos, servidores de infraestructura
Descubrimiento Inventario y métricas básicas Cobertura amplia a bajo coste

El nivel tiene un impacto directo en el consumo de licencia: elígelo host por host, según el valor esperado.

El papel de ActiveGate

OneAgent puede enviar sus datos directamente al entorno SaaS. Un ActiveGate resulta útil cuando los hosts no tienen acceso directo a Internet (hace entonces de relé) o para ciertas integraciones que consultan API remotas. En Kubernetes, el Operator despliega por sí mismo un ActiveGate, entre otras cosas para monitorizar la API del clúster.

¿Cómo desplegar OneAgent en un host Linux?

El despliegue se lanza desde el entorno: busca el asistente de despliegue de OneAgent (con la búsqueda «Deploy OneAgent» o desde la aplicación de infraestructura). Genera un comando de descarga que contiene la dirección del entorno y un token de instalación. Cópialo tal cual: no construyas la URL a mano.

La instalación en sí se parece a esto, una vez descargado el instalador:

sudo /bin/sh Dynatrace-OneAgent-Linux-<version>.sh --set-host-group=formation-saas

El parámetro --set-host-group asocia el host a un grupo de hosts, práctico para aplicar ajustes comunes y filtrar más adelante. Tras la instalación, los procesos que ya estaban en ejecución no se instrumentan: reinicia las aplicaciones para que se tracen.

Para comprobar el estado local del agente, la herramienta de línea de comandos oneagentctl se instala junto con OneAgent:

sudo /opt/dynatrace/oneagent/agent/tools/oneagentctl --get-host-group

Si ya has instalado OneAgent en un contexto Managed, la lógica es parecida; el artículo Desplegar OneAgent en Linux en Managed detalla las opciones silenciosas. Solo cambia el destino: aquí, el entorno SaaS.

Desplegar OneAgent y Dynatrace Operator en Kubernetes

En Kubernetes, OneAgent no se instala nodo por nodo. Se despliega Dynatrace Operator, un operador de Kubernetes que lee un recurso personalizado llamado DynaKube y crea por sí mismo los componentes necesarios: OneAgent, ActiveGate e inyección en los pods.

Elegir un modo de despliegue

  • Cloud-native full-stack: monitorización de la infraestructura de los nodos e inyección de la instrumentación en los pods de aplicación. Es el modo más completo y el más habitual.
  • Application monitoring: inyección en los pods sin monitorización del host, útil cuando no controlas los nodos.
  • Host monitoring: monitorización solo de los nodos.

Los pasos

Lo más sencillo es seguir el asistente de la aplicación Kubernetes, que genera los tokens y un archivo dynakube.yaml adaptado. Normalmente hacen falta dos tokens: uno para el Operator y otro para la ingesta de datos. La instalación del Operator con Helm tiene este aspecto:

helm install dynatrace-operator oci://public.ecr.aws/dynatrace/dynatrace-operator \
  --create-namespace --namespace dynatrace --atomic

Con Helm 4.0 o superior, sustituye --atomic por --rollback-on-failure.

Después se aplica el recurso DynaKube generado. Su estructura general se parece a este extracto simplificado (la versión de la API y los campos exactos dependen de la versión del Operator: usa los del archivo generado):

apiVersion: dynatrace.com/<version>
kind: DynaKube
metadata:
  name: formation
  namespace: dynatrace
spec:
  apiUrl: https://<environnement>/api
  oneAgent:
    cloudNativeFullStack: {}
  activeGate:
    capabilities:
      - routing
  kubernetesMonitoring:      # Operator 1.11.0+
    registration: {}
kubectl apply -f dynakube.yaml
kubectl get dynakube -n dynatrace
kubectl get pods -n dynatrace

Como en un host, los pods de aplicación que ya estaban en marcha deben reiniciarse para recibir la inyección.

¿Cuáles son las trampas más frecuentes?

  • Aplicaciones sin instrumentar: no se reiniciaron tras la instalación.
  • Agente que no se conecta: un proxy o un cortafuegos bloquea la salida hacia el entorno; hace falta un ActiveGate de relé o un ajuste de proxy.
  • DynaKube en error: token no válido, permisos de token insuficientes o URL de API incorrecta. Lee el estado del recurso y los logs del pod del Operator.
  • Coste inesperado: full-stack activado en todas partes por defecto. Decide el modo antes de desplegar a gran escala.

Para ir más allá de lo básico en Kubernetes, el artículo peticiones de CPU efectivas de los pods de Kubernetes muestra lo que se puede obtener de los datos recogidos por el Operator.

Ejercicio práctico

Paso 1: instalar OneAgent en la máquina Linux

Desde el asistente de despliegue, descarga el instalador de Linux y ejecútalo con el grupo de hosts formation-saas. Arranca después una pequeña aplicación (por ejemplo un servidor web) o reinicia la que esté en marcha.

Resultado esperado: pasados unos minutos, el host aparece en la aplicación de infraestructura, con sus procesos.

Paso 2: comprobar los datos en Grail

En un notebook, ejecuta:

fetch dt.entity.host
| fields entity.name, id

Resultado esperado: tu host aparece en la lista.

Paso 3: desplegar el Operator

En el clúster de prueba, sigue el asistente de la aplicación Kubernetes en modo cloud-native full-stack, instala el Operator y aplica el DynaKube. Comprueba que los pods del namespace dynatrace pasan al estado Running.

Resultado esperado: el clúster aparece en la aplicación Kubernetes, con sus nodos y sus namespaces.

Paso 4: observar un workload

Despliega una aplicación de demostración en un namespace dedicado y reinícialo si ya existía. Busca su servicio en la aplicación Services.

Resultado esperado: el servicio se detecta y muestra peticiones y tiempos de respuesta.

Cuestionario

  1. ¿Por qué hay que reiniciar una aplicación tras instalar OneAgent? A) Para activar la licencia B) Para que la instrumentación se inyecte en el proceso C) Para vaciar la caché de DNS D) Nunca es necesario
  2. ¿Qué recurso personalizado configura Dynatrace Operator? A) OneAgentConfig B) DynaKube C) HostGroup D) ActiveGateSet
  3. ¿Qué modo de Kubernetes combina monitorización de los nodos e inyección en los pods? A) Host monitoring B) Application monitoring C) Cloud-native full-stack D) Descubrimiento
  4. ¿En qué caso es útil un ActiveGate para hosts clásicos? A) Siempre, OneAgent no puede enviar por sí solo B) Cuando los hosts no tienen acceso directo al entorno C) Para instalar DQL D) Para sustituir a OneAgent

Soluciones

  1. B. La instrumentación se carga al arrancar el proceso; un proceso ya lanzado no se traza.
  2. B. El Operator lee el recurso DynaKube y crea los componentes que describe.
  3. C. El modo cloud-native full-stack monitoriza los nodos e inyecta la instrumentación en los pods.
  4. B. OneAgent puede enviar directamente; el ActiveGate sirve de relé cuando la red lo exige.

Para ir más lejos

← Módulo 1: la plataforma Dynatrace SaaS, Grail y conceptos clave · Índice de la ruta · Módulo 3: los fundamentos de DQL →

Preguntas frecuentes

¿Se puede instalar OneAgent en los nodos de Kubernetes sin el Operator?

Técnicamente es posible en algunos casos, pero el Operator es el método recomendado: gestiona las actualizaciones, la inyección en los pods y el ActiveGate de forma declarativa.

¿Cuánto tiempo hace falta para ver los primeros datos?

Normalmente unos minutos después de arrancar el agente. Si no aparece nada pasado un cuarto de hora, comprueba la conectividad de red y el estado del agente con oneagentctl o el estado del DynaKube.

¿Hace falta un token distinto para cada clúster?

No es obligatorio, pero es una buena práctica: tokens distintos limitan el impacto de una fuga y facilitan su rotación.

Tu entorno recibe ya datos de un host y de un clúster. Toca aprender el lenguaje que permite consultarlos.

span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC. Dynatrace es una marca de Dynatrace LLC. Esta ruta no sustituye a las formaciones y certificaciones oficiales de Dynatrace University. Comprueba las funcionalidades en la documentación oficial correspondiente a tu versión.

Total
0
Shares
Leave a Reply

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

Previous Post
Module 1 — Plateforme Grail : Dynatrace SaaS, ses apps et ses concepts clés

Módulo 1: plataforma Grail, Dynatrace SaaS, sus apps y conceptos clave

Next Post
Module 3 — Les fondamentaux de DQL : fetch, filter, summarize et timeseries

Módulo 3: fundamentos de DQL con fetch, filter, agregaciones y timeseries

Related Posts