日志级别的取舍:从调试到长期留存
本文要点
- 级别不是情绪分级
- 哪些信息必须进日志
- 留存周期与存储成本
- 采样与降噪的平衡
- 团队落地的最小约定
级别不是情绪分级
很多项目的日志级别是被随手写出来的:调试期全开,上线后一刀切到警告,结果真出问题时什么也看不到。级别本身不是重点,重点是每条日志要回答什么问题。
哪些信息必须进日志
比较稳妥的做法是按“谁来看”分层。错误级别留给需要人介入的异常,信息级别记录业务关键节点,调试级别只服务于开发期复现,这样各级别才有明确的读者。
留存周期与存储成本
必进日志的字段通常是五项:时间、请求标识、耗时、结果状态、以及出错时的关键入参。缺了请求标识,多条并发日志就无法串成一条链路,排障只能靠猜。
采样与降噪的平衡
耗时字段尤其容易被省略。线上慢请求往往不是报错,而是某一环变慢,没有分段耗时就只能整段重放,成本极高。
团队落地的最小约定
留存周期要按用途反推。用于定位当天故障的日志,保留七到十四天足够;用于审计或趋势分析的,应落到结构化存储里单独管理,不要和历史日志混在一处。
采样是控制成本的有效手段。高频正常请求可以按比例采样,异常请求全量保留,这样既压住体量,又不会漏掉真正需要的样本。
还要注意日志里的敏感信息。手机号、地址、证件号这类内容应在写入前脱敏,规则最好统一在框架层做,避免每个业务各写一套。
团队落地只需要三条最小约定:级别定义写进文档、关键链路必须有请求标识、日志格式保持可解析。做到这三点,后续的检索与分析工具才有发挥空间。
读者留言 共 3 条
吴吴工2026-11-21
我们把日志全量保留,结果存储费比服务器还贵,这篇说的问题太真实了。
何何同学2026-11-21
请求标识这条建议很实用,明天就在项目里加上。
郑郑先生2026-11-21
脱敏放在框架层确实省事,各写一套迟早出问题。