四类记录
| 记录 | 内容 | 用途 |
|---|---|---|
| 路由记录 | 调用方、目标、候选节点、最终节点 | 核对路径选择 |
| 切换记录 | 原节点、备选节点、原因、时间 | 核对故障切换 |
| 错误记录 | 错误类型、请求编号、节点 | 排查失败 |
| 策略记录 | 策略版本、生效时间、变更内容 | 核对策略变化 |
日志包含哪些字段
- 请求编号:一次请求的唯一编号。
- 调用方标识:发起请求的主体或节点。
- 目标标识:请求指向的对象。
- 路径:最终选择的节点和路径。
- 结果:成功、失败或切换,用于区分处理结果。字段按接入约定保留,不额外扩展业务内容。
- 时间:请求开始和结束时间,用于对齐请求与策略变化。
如何查询一次请求
用请求编号查询可以取得该次请求的路由记录、切换记录与错误记录;只知道时间范围时,先按时间缩小范围,再用调用方与目标标识定位。
核对一次请求时,把最终节点、选择原因与策略版本一起看,避免只看结果不看依据。
- 取得请求编号,确认调用方与目标标识,明确查询范围。
- 按请求编号查询路由记录,查看候选节点、最终节点与选择原因。
- 如发生切换,查看切换记录中的原节点、备选节点、原因与时间,确认切换条件。
- 如返回失败,查看错误记录中的错误类型与涉及节点,判断失败发生在哪一步。
- 需要核对策略时,按策略版本与生效时间查询策略记录,确认变更与请求时间的关系。查询结果与切换、错误记录一起核对,形成完整过程。
观测的使用边界
日志用于核对与排查,不用于评价业务效果。日志保存期限按接入约定执行,到期后按规则处理。查询范围按授权执行,超出范围的请求不提供结果。
日志不保存业务正文与完整凭据。需要业务数据时,由调用方与服务节点自行记录;涉及个人信息时,接入方应在提交前完成脱敏。脱敏由接入方在提交前完成,站点不保存业务正文。查询时按请求编号定位。
记录如何支持故障处理
出现路径异常时,路由记录可以说明候选集与最终节点,切换记录可以说明为何改用备选路径,错误记录可以说明失败类型。三类记录结合,能缩短定位时间。记录之间可以用请求编号关联,减少在不同入口之间反复查找。查询时按请求编号关联,不需要重复说明背景。
策略问题则看策略记录:版本、生效时间与变更内容。把策略变化与请求时间对齐,可以判断异常是否由配置变更引起。
安全与保存
- 凭据按主体与用途签发,设置有效期;不同用途不共用凭据。
- 凭据不写入前端代码、公开仓库与日志。
- 日志字段按接入约定保留,到期按规则处理。
- 查询范围按授权执行,超出范围的请求不提供结果;日志访问按角色控制,避免越权查看。访问记录按用途区分。