Logs & Observability

Source: content/manual/02-12factor/chapters/06-logs-and-observability.md

Purpose and scope

Standardize logging and tracing so debugging is fast and consistent.

Outcomes

  • JSON logs with correlation IDs.
  • Golden dashboards per template.
  • Trace sampling tailored to risk.

Signals of trouble

  • Grepping ad-hoc logs without correlation.
  • Missing readiness/liveness probes.
  • No ownership on broken dashboards.

Remediation steps

  1. Enforce log schema in CI; inject correlation IDs.
  2. Ship defaults for metrics/traces with templates.
  3. Add SLOs and alerting tied to user journeys.

Checklists and assets

References

  • Observability standards; tracing libraries.