日志规范落地：让排查不再靠猜

一、日志的作用被低估

日志是最便宜的可观测手段，但很多团队的日志只写了"出错了"，没有上下文。真正有用的日志应该能回答三个问题：谁触发的、做了什么、结果是什么。

二、结构化日志

用 JSON 或键值对格式输出，而不是拼接字符串。结构化日志便于检索与聚合，也能直接进日志平台做统计。关键字段建议统一：trace_id、user_id、action、duration、status、error_code。

三、分级与采样

ERROR 只用于需要人介入的问题，业务预期内的失败用 WARN 或 INFO。日志量大的接口要做采样，否则存储成本和检索性能都会崩。关键链路不采样，保证可回溯。

四、不打敏感信息

手机号、身份证、密码、token 一律脱敏或不打。日志往往被多人访问，泄露风险比想象中大。建议在日志组件里做统一的脱敏处理，而不是依赖每个人自觉。

五、与告警联动

ERROR 日志应该能触发告警，并且告警里带上足够定位的信息。日志、指标、链路三者关联起来，才能快速从现象定位到根因。