Los clústeres de Kubernetes y OpenShift han dejado obsoleta la instalación de agentes «a mano» en cada host. Los nodos nacen y mueren con el autoescalado, los pods se mueven, y los equipos de plataforma quieren que todo sea declarativo, versionado y reconciliado automáticamente. Para la observabilidad, eso significa que el ciclo de vida de OneAgent y de ActiveGate también debe gobernarlo Kubernetes. Es el trabajo de Dynatrace Operator Kubernetes: Kubernetes despliega y actualiza los agentes por sí mismo.
Ese es el papel de Dynatrace Operator y de su recurso personalizado DynaKube. Pero la mayoría de los ejemplos disponibles suponen un entorno SaaS accesible desde Internet. En un contexto de Dynatrace Managed, las preguntas son distintas: la URL de la API apunta a tu propio dominio, el certificado del clúster suele emitirlo una PKI interna, los registros de imágenes públicos no siempre son accesibles y los flujos de red entre el clúster de Kubernetes y el clúster Managed atraviesan cortafuegos que administras tú.
Este artículo explica cómo conectar Dynatrace Operator Kubernetes a un entorno Managed, tanto en Kubernetes estándar como en OpenShift, con una configuración DynaKube adaptada a estas restricciones.
Arquitectura: qué despliega el Operator
- El propio Operator, que vigila los recursos
DynaKubey reconcilia el estado deseado. - El webhook, que inyecta los módulos de código en los pods de aplicación (modo cloud-native) y valida los recursos DynaKube.
- El controlador CSI (según el modo), que guarda en caché los binarios de OneAgent en cada nodo para evitar descargas repetidas.
- OneAgent como DaemonSet, un pod por nodo, para la visibilidad del host y la inyección.
- Un ActiveGate como StatefulSet, que se encarga de la monitorización de la API de Kubernetes y puede enrutar el tráfico de los agentes hacia el clúster Managed.
Todos estos componentes se comunican con la API del entorno, que en Managed se expone en https://{votre-domaine}/e/{id-environnement}/api.
Elegir el modo de despliegue
| Modo DynaKube | Principio | Cuándo usarlo |
|---|---|---|
cloudNativeFullStack |
OneAgent en el host + inyección en los pods mediante webhook | Opción recomendada por defecto para la mayoría de los clústeres |
applicationMonitoring |
Solo inyección en los pods, sin agente en el host | Plataformas donde los DaemonSets privilegiados están prohibidos |
hostMonitoring |
Agente en el host sin inyección en las aplicaciones | Monitorización de infraestructura de los nodos |
classicFullStack |
Enfoque histórico, inyección a nivel de host | Compatibilidad con despliegues antiguos |
Los modos disponibles y su comportamiento evolucionan con las versiones del Operator y de la API de DynaKube: comprueba la matriz de compatibilidad entre tu versión de Managed y la versión del Operator antes de elegir.
Requisitos previos en Managed
- Un entorno dedicado o compartido, y su identificador, visible en la URL
/e/{id-environnement}. - Un token del Operator (token de API) creado con la plantilla Kubernetes: Dynatrace Operator:
InstallerDownload,DataExport,settings.read,settings.writeyactiveGateTokenManagement.create(entities.readya no es necesario desde el Operator 1.7.0). - Un token de ingesta de datos (plantilla Kubernetes: Data Ingest:
metrics.ingest,logs.ingest,openTelemetryTrace.ingest). - Un flujo HTTPS abierto desde los nodos de Kubernetes hacia los nodos de Managed o hacia un ActiveGate.
- El certificado de la autoridad raíz de tu PKI en formato PEM (consulta certificados SSL y dominio del clúster) si el clúster Managed no usa un certificado público.
- Una versión del clúster Managed lo bastante reciente para la versión del Operator elegida.
Tutorial paso a paso: Dynatrace Operator Kubernetes
Paso 1 — Validar el acceso a la API desde el clúster
Lanza un pod efímero para probar la ruta de red desde el interior del clúster:
kubectl run nettest --rm -it --restart=Never --image=curlimages/curl -- \
curl -sS -o /dev/null -w "%{http_code}\n" \
-H "Authorization: Api-Token {token}" \
https://{votre-domaine}/e/{id-environnement}/api/v1/time
El token del Operator incluye el scope DataExport que exige esta llamada: un código 200 confirma la red y el token. Un error de certificado significa que tendrás que proporcionar tu autoridad raíz a DynaKube (paso 4).
Paso 2 — Instalar el Operator
Crea el espacio de nombres e instala el Operator con el chart de Helm oficial o con los manifiestos publicados para tu versión:
kubectl create namespace dynatrace
helm install dynatrace-operator oci://public.ecr.aws/dynatrace/dynatrace-operator \
--namespace dynatrace --version {version-operator} --atomic
kubectl -n dynatrace get pods
En OpenShift se aplica el mismo comando de Helm: la plataforma se detecta automáticamente durante la instalación (OperatorHub sigue siendo una alternativa). Las Security Context Constraints son necesarias para cloudNativeFullStack y applicationMonitoring con controlador CSI. En un entorno desconectado, copia antes las imágenes a tu registro interno y sobrescribe las referencias de imagen en los valores de Helm.
Paso 3 — Crear el secreto de los tokens
kubectl -n dynatrace create secret generic {nom-dynakube} \
--from-literal="apiToken={token-operator}" \
--from-literal="dataIngestToken={token-ingestion}"
El secreto debe llamarse igual que el recurso DynaKube, salvo que lo referencies explícitamente en la especificación.
Paso 4 — Proporcionar el certificado de tu PKI
kubectl -n dynatrace create configmap dynatrace-trusted-ca \
--from-file=certs=/chemin/vers/ca-interne.pem
La clave certs es la que espera el Operator. Este ConfigMap se referenciará en el campo trustedCAs.
Paso 5 — Declarar el recurso DynaKube
apiVersion: dynatrace.com/{version-api-dynakube}
kind: DynaKube
metadata:
name: {nom-dynakube}
namespace: dynatrace
spec:
apiUrl: https://{votre-domaine}/e/{id-environnement}/api
trustedCAs: dynatrace-trusted-ca
networkZone: {zone-reseau}
oneAgent:
hostGroup: {cluster-k8s}_{environnement}
cloudNativeFullStack: {}
activeGate:
capabilities:
- kubernetes-monitoring
- routing
resources:
requests:
cpu: 500m
memory: 1Gi
limits:
cpu: 1000m
memory: 2Gi
El valor de apiVersion (por ejemplo v1beta2, v1beta3…) y algunos campos cambian entre versiones: hostGroup se coloca bajo spec.oneAgent, y los Operator recientes sustituyen la capacidad kubernetes-monitoring por la sección spec.kubernetesMonitoring (ambas se excluyen entre sí). Parte siempre del ejemplo que acompaña a la versión del Operator instalada. Los recursos del ActiveGate son órdenes de magnitud que debes ajustar según el tamaño del clúster.
kubectl apply -f dynakube.yaml
kubectl -n dynatrace get dynakube
kubectl -n dynatrace get pods -o wide
Paso 6 — Verificar la conexión
kubectl -n dynatrace describe dynakube {nom-dynakube}
kubectl -n dynatrace logs deploy/dynatrace-operator --tail=100
El recurso debe alcanzar la fase Running. En el entorno, el clúster de Kubernetes aparece en la vista de Kubernetes, y los nodos en la lista de hosts con el grupo definido.
Paso 7 — Comprobar la inyección
Reinicia una aplicación de prueba y comprueba la presencia de las anotaciones o volúmenes que añade el webhook:
kubectl -n {namespace-app} rollout restart deployment/{application}
kubectl -n {namespace-app} get pod -l app={application} -o yaml | grep -i dynatrace
Para limitar la inyección a determinados espacios de nombres, usa un namespaceSelector en la DynaKube en lugar de instrumentar todo el clúster de golpe.
Buenas prácticas
- Versiona la DynaKube y los valores de Helm en Git y aplícalos mediante tu herramienta de GitOps.
- Alinea la versión del Operator con la matriz de compatibilidad de tu versión de Managed antes de cada actualización.
- Usa un registro interno para las imágenes en entornos restringidos y prueba la descarga de la imagen en un nodo.
- Excluye de la inyección los espacios de nombres del sistema (
kube-system,openshift-*). - Dimensiona el ActiveGate según el número de objetos de Kubernetes monitorizados y vigila su consumo de memoria.
- Renueva los tokens con regularidad simplemente actualizando el secreto.
Preguntas frecuentes
¿Qué modo DynaKube elegir con un clúster Managed?
cloudNativeFullStack es la opción por defecto para la mayoría de los clústeres. Si los DaemonSets privilegiados están prohibidos, applicationMonitoring se limita a la inyección en los pods. En cualquier caso, comprueba la matriz de compatibilidad entre tu versión de Managed y la del Operator.
¿Qué hacer si la prueba de la API devuelve un error de certificado?
Es la señal de que el clúster Managed usa un certificado emitido por una PKI interna. Crea un ConfigMap con la autoridad raíz en formato PEM bajo la clave certs y referénciala en el campo trustedCAs de la DynaKube.
¿Cómo evitar instrumentar todo el clúster de una vez?
Usa un namespaceSelector en la DynaKube para limitar la inyección a los espacios de nombres deseados, y excluye los espacios del sistema como kube-system y openshift-*.
Conclusión
Conectar Dynatrace Operator a un clúster Managed no requiere ningún mecanismo especial, pero obliga a tratar de forma explícita lo que el SaaS oculta: URL de API en tu dominio, certificados internos, registros privados y flujos de red. Con una DynaKube declarativa, versionada y adaptada a tu PKI, Kubernetes y OpenShift pasan a ser ciudadanos de primera clase de tu plataforma de observabilidad on-premise.
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.