让日志留下足够的线索

排查问题时，常见的困难并不是没有日志，而是日志里的信息无法拼成一条完整的时间线。调整几处记录习惯，往往比增加大量输出更有效。

从一个请求开始

为请求或任务分配稳定的标识，并在关键步骤中保留它。记录开始时间、耗时、结果和错误类别，便于把入口、业务处理和外部依赖串起来。跨机器查询时，统一时区也能减少误判。

把字段写清楚

结构化日志适合筛选和聚合。字段名称保持一致，例如同一个耗时字段不要同时使用毫秒和秒。需要采样时，优先保留错误和慢请求，并明确普通请求的采样比例。

少留敏感信息

访问令牌、密码和完整的个人数据不应进入日志。URL 查询参数和请求头也可能包含凭据，不能因为它们是调试信息就全部打印。通常记录经过脱敏的标识、状态码和错误类型已经足够。

最后给日志设置合理的保留周期和容量限制。能够稳定地留下关键线索，比偶尔获得一份特别详细的输出更有用。