Volver a guíasGuía

Monitorizar controller-runtime sin fundir el API server de Kubernetes

Un flujo práctico para detectar LIST storms, caches desincronizadas, colas de reconciliación y alertas de control plane antes de que el operador se convierta en el incidente. Qué detallazo.

Aprende a vigilar controladores Kubernetes hechos con controller-runtime usando Prometheus, métricas de workqueue, apiserver, informers, reglas promtool y validación canary.

Creada: 27 de agosto de 2026

Publicada: 27 de agosto de 2026

Tiempo estimado45 min
NivelAvanzado
Antes de empezarPrometheus scrapeando el API server y los controladores propios
PlataformasLinux / Docker
WhatsAppXLinkedIn

Linux

Diagnóstico desde una estación Linux con kubectl, curl contra Prometheus y promtool.

kubectlcurlpromtool
Revisar estado del controlador
kubectl get pods -n platform -l app=checkout-operator -o wide
Ver errores recientes
kubectl logs deploy/checkout-operator -n platform --tail=120 | egrep -i 'reconcile|watch|cache|timeout|throttle|error'
Consultar colas de reconciliación
curl -G 'http://localhost:9090/api/v1/query' --data-urlencode 'query=max by (controller)(workqueue_depth{job="checkout-operator"})'
Probar reglas
promtool test rules tests/controller-runtime-cache-pressure.test.yaml

Contenido bloqueado

Esta guía requiere completar ambos pasos para leer el contenido completo.

  • Dale a “Me gusta” en la guía.
  • Comparte en WhatsApp, X, LinkedIn o copia el enlace.

Cuando se cumplan ambos pasos, el acceso se desbloquea automáticamente.