Operations note

访问故障记录模板:一次请求应该留下什么证据

一份可复用的访问故障记录格式,覆盖时间、地区、DNS、TLS、HTTP、路由与业务影响。

排查跨境访问问题时,最耗时的往往不是修复,而是无法还原故障发生时看到的结果。统一记录格式,可以减少不同人员之间的信息缺口。

基础字段

  • 发生时间、持续时间和时区。
  • 访客地区、运营商和网络类型。
  • 设备、操作系统和浏览器。
  • 实际 URL、DNS 结果和缓存 TTL。
  • TCP、TLS、HTTP 各阶段结果。

链路字段

若有 traceroute 或 MTR,记录延迟、丢包和目标地址。不要只截取中间某跳出现星号的画面;需要区分中途节点不响应与目标路径异常。

业务字段

记录错误页、登录状态、接口返回、CDN 日志和源站日志。将请求 ID 或时间戳在两端对齐,才能确认是否同一请求。

结论字段

结论应区分“已确认”“可能相关”和“未验证”。例如,DNS 返回错误地址是已确认事实,是否由运营商拦截仍需更多证据。

保留匿名化后的记录,移除密码、Cookie、客户数据和完整私钥。证据应该够用,而不是越多越危险。