Observabilidad — logs, métricas y trazas

Las señales

• Logs: eventos discretos con contexto; útiles para explicar casos concretos.
• Métricas: series agregadas para tendencias, dashboards y alertas.
• Trazas: recorrido de una operación entre servicios y dependencias.

Comparte requestId o traceId, versión, ambiente y ruta normalizada. No uses URLs con identificadores como etiqueta de métrica: la alta cardinalidad eleva el costo y degrada consultas.

Golden signals

Mide tráfico, errores, latencia y saturación. En latencia observa percentiles p50/p95/p99; el promedio esconde usuarios lentos. Para jobs añade antigüedad de cola, throughput y tasa de reintentos.

De una request a una explicación

requestId/traceId
  → span HTTP
  → span de base de datos
  → span de proveedor
  → logs con el mismo contexto
  → métricas agregadas por ruta normalizada

El trace explica un caso; la métrica muestra si es tendencia. Un log aporta detalle. Evita duplicar el body en las tres señales.

Logs útiles

{
  "level": "error",
  "event": "payment_failed",
  "requestId": "req_123",
  "userId": "usr_456",
  "provider": "example",
  "durationMs": 820,
  "errorCode": "timeout"
}

No registres contraseñas, tokens, cookies, bodies completos ni PII innecesaria. Redacta en la fuente y define retención.

Alertas

Alerta por impacto accionable, no porque “la CPU pasó 70% una vez”. Cada alerta debe tener severidad, dueño, dashboard y runbook. Correlaciona con deploys y mantén una señal externa que confirme si el sitio es alcanzable.

Para aprender y recordar

Instrumenta una operación crítica de extremo a extremo y provoca timeout, error y éxito. Para consulta rápida: ¿puedes conocer release, ruta, latencia, dependencia y resultado sin acceder a datos sensibles? Si no, falta contexto o sobran datos sin estructura.