Docker
stdout, logging drivers, métricas, eventos y trazabilidad.
Los contenedores son reemplazables; la telemetría debe sobrevivir a su reemplazo. Una estrategia de observabilidad útil combina para responder cuatro preguntas:
¿Qué ocurrió?
¿Dónde ocurrió?
¿Por qué ocurrió?
¿Desde qué cambio comenzó?docker logs es una herramienta de diagnóstico local, no una plataforma completa de observabilidad. En producción, la información debe salir del contenedor, conservarse fuera del host cuando el riesgo lo exige y correlacionarse con service, versión, digest y request.
Eventos discretos con contexto:
{
"timestamp": "2026-07-25T05:00:00.000Z",
"level": "error",
"service": "api",
"version": "1.8.2",
"requestId": "req_01",
"message": "Database query timed out",
"durationMs": 5000
}Valores agregables en el tiempo:
Relacionan una operación a través de proxy, API, worker, database y proveedores externos.
request
→ proxy span
→ API span
→ PostgreSQL span
→ payment provider spanCambios de lifecycle del Engine:
docker events --since 30mPermiten correlacionar:
Una aplicación debe escribir logs de proceso en stdout y stderr.
console.log(JSON.stringify({ level: 'info', message: 'Server started' }));
console.error(JSON.stringify({ level: 'error', message: 'Request failed' }));Ventajas:
No significa que stdout sea almacenamiento durable. Si el host se pierde o la retención local termina, el log desaparece.
docker logs api
docker logs --follow api
docker logs --since 10m --tail 200 api
docker logs --timestamps apidocker logs lee según el logging driver configurado y sus capacidades. No asumas que todos los drivers permiten exactamente la misma experiencia local.
Para Compose:
docker compose logs -f --tail 200 api workerEl daemon utiliza un logging driver por defecto o uno configurado por container.
Inspección:
docker info --format '{{.LoggingDriver}}'
docker inspect api --format '{{json .HostConfig.LogConfig}}'Drivers pueden:
La elección cambia disponibilidad, rendimiento, buffering, backpressure y experiencia de docker logs.
Un servicio que escribe continuamente puede llenar el disco del host.
Ejemplo conceptual:
docker run \
--log-opt max-size=10m \
--log-opt max-file=3 \
my-apiLas opciones dependen del driver. Configura y verifica la política efectiva.
Sin rotación:
log crece
→ filesystem lleno
→ database/builds fallan
→ daemon y host se degradanRotación local tampoco reemplaza centralización. Solo limita el daño y conserva una ventana corta.
Prefiere JSON o un formato estable.
Campos útiles:
Evita depender de parsing por regex de mensajes humanos variables.
No escribas:
La observabilidad puede convertirse en la mayor copia de datos sensibles de una organización.
Define:
Un error útil conserva contexto técnico sin exponer secretos.
{
"level": "error",
"errorType": "DatabaseTimeoutError",
"message": "Query exceeded timeout",
"requestId": "req_01",
"durationMs": 5000
}En entornos internos puede conservarse stack trace en el sistema central. En respuestas públicas no debe enviarse automáticamente.
Genera o propaga una identidad por request:
client request ID
→ proxy
→ API
→ worker/job
→ database logSi un proveedor externo devuelve su propio ID, regístralo también. Esto permite buscar una transacción completa sin depender de timestamps aproximados.
El container ID es efímero. Registra metadata durable:
Ejemplo con labels:
services:
api:
image: registry.example.com/api@sha256:...
labels:
com.nicoo.service: api
com.nicoo.version: "1.8.2"
com.nicoo.commit: "abc1234"docker stats --no-streamMuestra señales básicas:
Limitaciones:
Un container puede usar poca CPU y aun estar devolviendo errores por una dependencia externa.
Para una API:
Evita cardinalidad no controlada. No uses user ID, URL completa o request ID como label métrica.
Un healthcheck responde una condición binaria o limitada.
healthy ≠ rápido
healthy ≠ sin errores
healthy ≠ dependencias establesCombina health con SLOs y métricas.
Tracing es útil cuando una operación cruza varios servicios.
Captura:
No adjuntes payloads sensibles indiscriminadamente. Sampling debe conservar errores y operaciones lentas sin generar costes imposibles.
docker events \
--filter container=api \
--since 1hCorrelaciona un error con:
Los eventos también necesitan recolección externa si deben sobrevivir al host.
El container comparte recursos del host. Monitorea:
Un problema que parece de un service puede ser saturación global.
Enviar logs puede fallar o bloquear.
Preguntas:
Una aplicación no debe caer porque el collector estuvo indisponible unos segundos, pero tampoco puede acumular logs infinitos.
Stack traces multilínea pueden fragmentarse. JSON en una línea simplifica ingestión.
Débil:
Error occurred
at function A
at function BMejor:
{"level":"error","message":"Error occurred","stack":"Error...\n at function A..."}Utiliza timestamps UTC y sincroniza el host.
Un desfase de reloj rompe:
Registra timezone de negocio solo donde sea relevante; la telemetría base debe normalizarse.
Síntoma: p99 sube de 200 ms a 5 s.
Proceso:
docker stats muestra CPU normal;Conclusión: no era CPU del container; era I/O de storage.
docker ps -a
docker inspect api --format '{{json .State}}'
docker logs --since 15m --timestamps api
docker stats --no-stream api
docker events --since 15m --filter container=api
docker system df -vDespués revisa métricas y traces externos.
Los logs locales pueden desaparecer según driver y limpieza. Centraliza antes.
Puede bloquear, bufferizar o perder eventos. Prueba el comportamiento.
Serializar payloads enormes o stack traces repetidos también consume recursos.
Una métrica etiquetada por request ID vuelve inutilizable el backend.
Un token puede aparecer dentro de URL, body o error de librería.
Usa stderr básico y captura de startup.
Se pierden al recrear y rompen rootfs read-only.
El host se llena.
No hay historial central ni correlación multi-host.
Filtra datos y aumenta costes.
No puedes identificar qué cambio introdujo el problema.
Un service healthy puede incumplir SLO.
docker logs no es suficiente en producción?Supply chain, SBOM y escaneo, donde la identidad y seguridad de la imagen se extienden desde source y builder hasta registry y despliegue.