跳到正文
D14-05可观测与运维1 分钟更新于 2026-11

日志规范

一句话

日志要带渠道原始返回,否则排查只能靠猜。

本文目录8 节

日志规范

它解决什么

日志要带渠道原始返回,否则排查只能靠猜。结构化日志 + 关键字段(订单号、渠道、错误码)+ 脱敏,是基本要求。日志的质量决定了排查的速度,缺字段就等于没有日志。日志的字段设计,决定了排查能不能自动化。日志里没有渠道原始返回,排查就只能靠猜。

怎么用

  • 结构化字段
  • 保留渠道原始返回
  • 敏感字段脱敏

一个判断

只打「支付失败」四个字,等于没打日志。

边界

日志的边界是「隐私」:卡号、身份证号、密码绝对不能进日志,否则日志系统变成最大的泄露源。

一个反例

某平台只打「支付失败」四个字,排查时无法判断是渠道拒绝还是超时。现在日志带渠道原始返回与错误码。把它写进设计评审清单,比事后补便宜。架构上的欠账,最后都要用事故来还。

常见误判

  • 只打「支付失败」。

自查清单

  • 知道这个模块的边界在哪
  • 知道它的状态机有哪几个状态
  • 知道它出错时的兜底路径
  • 知道它的数据存在哪张表

依据

  • 支付日志的字段规范。

相关:支付系统怎么观测

相关阅读