Argo CD GitOps Kubernetes: el repositorio argoproj/argo-cd se presenta como «a declarative GitOps continuous delivery tool for Kubernetes». Su principio cabe en dos frases del README: las definiciones de aplicaciones y de entornos deben ser declarativas y estar versionadas, y su despliegue debe ser automatizado, auditable y fácil de entender. El proyecto se publica con licencia Apache 2.0.
Para un SRE o un equipo de plataforma, Argo CD responde a una pregunta sencilla: ¿lo que se ejecuta en el clúster es lo que describe Git? El controlador compara de forma continua el estado real con el estado deseado. También expone métricas de Prometheus y puede exportar trazas de OpenTelemetry. Veamos qué dice el repositorio, cómo instalarlo y cómo observar el propio despliegue.
Una precisión de honestidad: span.observer no ha instalado ni ejecutado Argo CD. Los comandos y los ajustes proceden del README, de la carpeta docs/ del repositorio (rama principal) y de la documentación oficial, leídos el 5 de noviembre de 2026. Las capturas reproducen esos textos. No pudimos releer el número de estrellas en la fuente ese día, así que no lo citamos, como tampoco la última release publicada.
Argo CD GitOps Kubernetes: qué dice el repositorio
- Licencia: el archivo LICENSE es el de Apache License 2.0, con la mención «Copyright 2017-2018 The Argo Authors».
- Objetivo: una herramienta declarativa de entrega continua para Kubernetes. El README remite a la documentación completa en argo-cd.readthedocs.io, a una demostración en línea y a la lista oficial de usuarios (
USERS.md). - Versión: el archivo
VERSIONde la rama principal contiene 3.7.0. Es la versión en desarrollo, no necesariamente la última release.
La página «Architectural Overview» describe tres componentes. El servidor de API atiende la interfaz web, la CLI y los sistemas de CI/CD. El repo server almacena en caché el repositorio Git y genera los manifiestos. El controlador de aplicaciones detecta el estado OutOfSync y puede corregirlo.
Los conceptos que conviene conocer antes de empezar
La página «Core Concepts» define el vocabulario útil para lo que sigue:
- Target state: el estado deseado, representado por archivos en Git.
- Live state: lo que realmente está desplegado (pods y otros recursos).
- Sync status: ¿el estado real coincide con Git?
- Sync operation status: ¿la última sincronización tuvo éxito?
- Health: ¿la aplicación funciona correctamente y puede atender solicitudes?
Estos tres estados distintos (sync, operación, salud) son la base de cualquier supervisión. Un despliegue puede estar Synced y, aun así, en mal estado de salud.
Instalación paso a paso
La captura siguiente reúne los comandos de la guía «Getting Started» y la salida de ejemplo de argocd app get, abreviada (se omiten las líneas URL y Target). Muestra un estado OutOfSync y Missing: la aplicación está declarada, pero todavía no hay nada desplegado.

Paso 1: instalar Argo CD
kubectl create namespace argocd
kubectl apply -n argocd --server-side --force-conflicts -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml
La guía explica que --server-side es necesario porque algunos CRD (como ApplicationSet) superan el límite de 262 KB de las anotaciones que impone kubectl apply del lado del cliente. También recomienda, en producción, fijar una versión (cita v3.2.0 como ejemplo) en lugar de la rama stable. Los manifiestos contienen ClusterRoleBinding que hacen referencia al espacio de nombres argocd: adáptalos si cambias de espacio de nombres.
Paso 2: acceder a la interfaz e iniciar sesión
Por defecto, Argo CD no se expone fuera del clúster. La guía propone un servicio de tipo LoadBalancer, un Ingress o un simple port-forward:
kubectl port-forward svc/argocd-server -n argocd 8080:443
argocd admin initial-password -n argocd
argocd login <ARGOCD_SERVER>
La contraseña inicial de la cuenta admin se guarda en texto plano en el secreto argocd-initial-admin-secret. La documentación pide eliminar ese secreto después de cambiar la contraseña (argocd account update-password).
Paso 3: crear y sincronizar una aplicación
argocd app create guestbook --repo https://github.com/argoproj/argocd-example-apps.git --path guestbook --dest-server https://kubernetes.default.svc --dest-namespace default
argocd app get guestbook
Al principio la aplicación está OutOfSync, porque todavía no existe ningún recurso. La sincronización (argocd app sync guestbook en la guía) despliega los recursos y pasa el estado a Synced. Para apuntar a un clúster distinto del de Argo CD, argocd cluster add CONTEXTNAME crea una cuenta de servicio argocd-manager vinculada, según la documentación, a un ClusterRole de administrador.
Observar Argo CD y el despliegue
Aquí es donde el proyecto interesa a la fiabilidad. La página «Observability» indica que los componentes exponen métricas de Prometheus y pueden exportar trazas de OpenTelemetry.
Métricas de Prometheus
La página «Metrics» enumera los puntos de acceso: argocd-metrics:8082/metrics para el controlador de aplicaciones, argocd-server-metrics:8083/metrics para el servidor de API y argocd-repo-server:8084/metrics para el repo server. Entre las métricas del controlador:
argocd_app_info: un indicador (gauge) cuyas etiquetas incluyensync_statusyhealth_status;argocd_app_sync_total: un contador del historial de sincronizaciones, con la etiquetaphase(Error, Failed, Running, Succeeded, Terminating);argocd_app_reconcile: un histograma de la duración de la reconciliación, en segundos;argocd_git_fetch_fail_total(repo server): los fallos al obtener datos de Git.
Con Prometheus Operator, la documentación proporciona un ServiceMonitor que hay que adaptar (espacio de nombres y etiqueta release):

Dos ideas de alertas para adaptar y probar en tu entorno (span.observer no las ha ejecutado):
argocd_app_info{sync_status!="Synced"}
increase(argocd_app_sync_total{phase!="Succeeded"}[1h]) > 0
La primera señala una deriva entre Git y el clúster. La segunda señala sincronizaciones fallidas. Vincúlalas a un SLO de entrega, por ejemplo el porcentaje de tiempo en que las aplicaciones críticas permanecen Synced. Para conectar estas métricas a Dynatrace, consulta la recuperación de métricas de Prometheus en Kubernetes.
Trazas de OpenTelemetry
Según la documentación de la rama principal, el servidor de API, el controlador de aplicaciones, el repo server y el sidecar de los plugins exportan trazas en OTLP/gRPC. Sus service.name son argocd-server, argocd-controller, argocd-repo-server y argocd-cmp-server. Las llamadas gRPC entre componentes llevan el contexto W3C: una reconciliación iniciada por el controlador y la generación de manifiestos en el repo server forman una sola traza. Todo se configura en el ConfigMap argocd-cmd-params-cm:

Las líneas críticas: otlp.address activa la exportación (si está vacía, el rastreo queda desactivado), otlp.insecure vale "true" por defecto (texto sin cifrar) y otlp.sample.ratio fija la fracción de trazas que se registran. El muestreador sigue al padre: una traza iniciada por el controlador se registra completa o no se registra. Reinicia los componentes tras la modificación.
La misma página describe el envío de métricas por OTLP (otlp.metrics.enabled, intervalo de 30 s por defecto). Atención: esta opción aparece en la documentación de la rama principal, y la página «stable» leída ese día no la mencionaba. Comprueba que existe en tu versión. Si un Collector ya recoge /metrics, activarla duplica cada serie.
¿Y Dynatrace?
Argo CD no documenta ninguna integración propia con Dynatrace, y no inventamos ninguna. Las trazas OTLP pueden pasar por un Collector, que se presenta en la guía del Collector de OpenTelemetry en Kubernetes hacia Dynatrace. El comportamiento en Dynatrace SaaS o Managed depende de la documentación de Dynatrace. Para comparar con otro proyecto del mismo registro, lee KEDA y el autoescalado por eventos.
Límites y puntos abiertos
- Permisos amplios: registrar un clúster crea una cuenta de servicio con un ClusterRole de administrador. La documentación indica que se pueden restringir los permisos de escritura, pero que
get,listywatchsiguen siendo necesarios a nivel de clúster. - Cardinalidad: exponer etiquetas de Application mediante
controller.metrics.application.labelscrea una serie por cada valor distinto. La documentación recomienda etiquetas de baja cardinalidad. - Rama principal: algunas páginas leídas describen funciones recientes. Compáralas siempre con la documentación de tu versión.
- Alta disponibilidad: con varias réplicas del controlador, la documentación aconseja un
ServiceMonitoro un descubrimiento por pod, porque un ClusterIP devuelve una sola réplica por solicitud. - No verificado: las estrellas, la última release y el estado exacto respecto a la CNCF no figuran en lo que pudimos releer.
Buenas prácticas
- Fija la versión en la URL del manifiesto de instalación y prueba cada actualización fuera de producción.
- Elimina
argocd-initial-admin-secretdespués del primer cambio de contraseña. - Alerta sobre la deriva (
sync_status) y sobre los fallos de sincronización, no solo sobre la salud de los pods. - Elige un único modo por componente, recogida o envío OTLP de las métricas, para evitar duplicados.
- Guarda también tus ajustes de supervisión en Git, como en el módulo GitOps de Dynatrace SaaS.
Preguntas frecuentes
¿Qué aporta Argo CD frente a un pipeline de CI clásico?
Según el README, busca despliegues automatizados, auditables y declarativos. El controlador compara de forma continua Git y el clúster, en lugar de empujar una sola vez desde la CI. La CI puede seguir aguas arriba para construir las imágenes.
¿Cómo saber si un despliegue está fallando?
Tres señales se complementan: sync_status y health_status en argocd_app_info, el contador argocd_app_sync_total por phase y las trazas de reconciliación si la exportación OTLP está activada.
¿Se pueden enviar las trazas de Argo CD a Dynatrace?
Argo CD exporta en OTLP/gRPC a la dirección definida en otlp.address. Coloca un Collector entre ambos y sigue después la documentación de Dynatrace para la parte de recepción. span.observer no ha probado este montaje.
Conclusión
Argo CD convierte a Git en la fuente de verdad del despliegue en Kubernetes, y sus métricas y trazas hacen observable esa entrega. El punto de entrada más rentable sigue siendo la deriva y el fallo de sincronización. Relee la documentación de tu versión antes de poner en marcha la exportación OTLP.
span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC ni al proyecto Argo CD. Las marcas citadas pertenecen a sus propietarios. Las herramientas evolucionan rápido: comprueba los comandos y las opciones en su documentación oficial.