Tema 4: Logging
Base oficial: (The Kubernetes Authors, 2026a, 2026b). Mi versión de trabajo: Logs son evidencia distribuida. Kubernetes te da streams; tú decides retención, routing y búsqueda.
Modelo mental
Logs son evidencia distribuida. Kubernetes te da streams; tú decides retención, routing y búsqueda.
Notas
- stdout/stderr de contenedores es solo el inicio.
- Logs de nodo y control plane importan cuando la app no es culpable.
- Pods de vida corta necesitan envio de logs antes de desaparecer.
Ángulo homelab
Un setup pequeno con Loki o archivos basta si responde preguntas reales de debugging.
Cómo verificarlo
- Lee el status del objeto antes de cambiar el manifest.
- Revisa events para encontrar el controlador o nodo que realmente se queja.
- Confirma que la fuente oficial abajo todavía coincide con la versión del cluster que corres.
Modos de falla comunes
- Tratar el objeto YAML como el sistema, en vez de verlo como una entrada a un loop de reconciliación.
- Debuggear desde fuera del cluster cuando la falla solo existe dentro de networking o estado de nodo.
- Olvidar que versión de Kubernetes, versión de addon y comportamiento de runtime están conectados.
Fuentes
- Logging Architecture - ruta fuente:
content/en/docs/concepts/cluster-administration/logging.md, commit 8cc9e19b8eec8d5cf49eacd66f86a81648edb1a0. - System Logs - ruta fuente:
content/en/docs/concepts/cluster-administration/system-logs.md, commit 8cc9e19b8eec8d5cf49eacd66f86a81648edb1a0. - La documentación de Kubernetes usa licencia CC BY 4.0; estas notas son comentario original y enlazan a la fuente oficial.
The Kubernetes Authors. (2026a). Logging Architecture. https://kubernetes.io/docs/concepts/cluster-administration/logging/
The Kubernetes Authors. (2026b). System Logs. https://kubernetes.io/docs/concepts/cluster-administration/system-logs/