← Volver a guíasGuía

Golden signals para controller-runtime: detectar caché lenta antes de culpar al API server

Una guía práctica para separar retraso de informers, colas saturadas, throttling del cliente REST y problemas reales del API server en controladores Kubernetes.

Aprende a instrumentar y diagnosticar controladores Kubernetes con métricas de controller-runtime, workqueue, caché y cliente REST antes de tocar concurrencia o reiniciar pods a ciegas.

Creada: 30 de julio de 2026

Publicada: 30 de julio de 2026

Tiempo estimado40 min

NivelAvanzado

Antes de empezarAcceso kubectl de lectura al namespace del controlador

PlataformasLinux

WhatsApp X LinkedIn

Linux

Flujo con kubectl, Prometheus y ServiceMonitor para validar controladores controller-runtime en Kubernetes.

kubectlcurlPrometheus Operator opcional

List recent controller and API events

kubectl get events -n platform-controllers --sort-by=.lastTimestamp | tail -40

Check controller resource pressure

kubectl top pods -n platform-controllers

Inspect recent reconciler errors

kubectl logs deploy/orders-controller -n platform-controllers --tail=120 | egrep 'reconcile|cache|throttle|too old resource version|error'

Read controller metrics locally

kubectl port-forward -n platform-controllers deploy/orders-controller 8080:8080 &
curl -s localhost:8080/metrics | egrep 'workqueue|controller_runtime|rest_client'

Leer también enController-runtime golden signals: catch cache lag before blaming the API server

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.