Dynatrace Operator Kubernetes y OpenShift: conectarse a un clúster Managed

Dynatrace Operator Kubernetes en un clúster Managed: DynaKube, certificados internos, registros privados y restricciones de OpenShift, paso a paso.
Kubernetes et OpenShift : connecter Dynatrace Operator à un cluster Managed

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 DynaKube y 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.write y activeGateTokenManagement.create (entities.read ya 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.

Total
0
Shares
Leave a Reply

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

Previous Post
Installer OneAgent sur Windows Server en mode silencieux

Instalar OneAgent Windows en modo silencioso en Windows Server

Next Post
Gérer des environnements multi-tenant et des quotas de licence dans la CMC

Gestionar entornos multi-tenant y cuotas de licencia en la CMC

Related Posts