DM
Engineering journal
Production LessonUsed personallyAll levels

Logs need context to be useful

A message saying “request failed” rarely answers the responder's next question.

Last reviewed July 2026

What useful logs contain

Structured events should help correlate a failure without exposing secrets or sensitive personal data.

  • Request, trace, job, and safe tenant identifiers
  • Operation and result rather than arbitrary prose
  • Duration, attempt number, dependency, and stable error code
  • Enough context to connect logs, metrics, and traces
  • Explicit redaction of tokens, passwords, payments, and health data
#observability#debugging