Assign a request ID
A stable request identifier lets frontend reports, API logs and background jobs be correlated.
Log events, not prose
Names such as retrieval_started, model_timeout or artifact_saved are easier to query than free-form log messages.
Redact secrets by design
Sensitive URLs, tokens and user content need explicit handling before they reach logs.
Connect logs to product quality
Failure rates by route, model or workflow stage can inform roadmap priorities and reliability work.