D14-05可观测与运维1 分钟更新于 2026-11
日志规范
一句话
日志要带渠道原始返回,否则排查只能靠猜。
日志规范
它解决什么
日志要带渠道原始返回,否则排查只能靠猜。结构化日志 + 关键字段(订单号、渠道、错误码)+ 脱敏,是基本要求。日志的质量决定了排查的速度,缺字段就等于没有日志。日志的字段设计,决定了排查能不能自动化。日志里没有渠道原始返回,排查就只能靠猜。
怎么用
- 结构化字段
- 保留渠道原始返回
- 敏感字段脱敏
一个判断
只打「支付失败」四个字,等于没打日志。
边界
日志的边界是「隐私」:卡号、身份证号、密码绝对不能进日志,否则日志系统变成最大的泄露源。
一个反例
某平台只打「支付失败」四个字,排查时无法判断是渠道拒绝还是超时。现在日志带渠道原始返回与错误码。把它写进设计评审清单,比事后补便宜。架构上的欠账,最后都要用事故来还。
常见误判
- 只打「支付失败」。
自查清单
- 知道这个模块的边界在哪
- 知道它的状态机有哪几个状态
- 知道它出错时的兜底路径
- 知道它的数据存在哪张表
依据
- 支付日志的字段规范。
相关:支付系统怎么观测
相关阅读