记录与观测指南

观测回答请求走了哪条路径、为何这样选择、结果如何。把路由、切换、错误与策略四类记录按请求编号串起来,核对才有顺序;只看结果不看依据,容易把节点状态变化误判为配置问题。记录是复核的依据。

观测要回答的三个问题

请求经过哪些节点:路由记录给出候选节点与最终节点,说明路径的实际走向。候选集与最终节点不一致时,差异来自权限过滤或状态排除,记录中可以看到过滤后的结果。

为什么这样选择:选择原因、策略版本与节点状态共同解释排序结果。只看最终节点,无法判断是策略排序还是状态变化导致,也就无法决定后续改哪里。

结果是什么:状态区分成功、切换与失败,错误记录补充失败类型。三个问题对应不同记录,查询时按顺序取用,避免在多处反复查找。

四类记录的关联方式

四类记录各自记录一个环节,字段不同,关联方式一致。请求编号是主线,策略版本用于连接配置变化,节点标识用于连接状态变化。

记录之间不做业务判断,只保留路由所需字段。需要还原业务内容时,由调用方与服务节点各自记录,两边按请求编号对照。

记录关键内容关联字段用途
路由记录调用方、目标、候选节点、最终节点请求编号核对路径选择
切换记录原节点、备选节点、原因、时间请求编号核对切换过程
错误记录错误类型、涉及节点请求编号判断失败环节
策略记录策略版本、生效时间、变更内容策略版本核对配置变化

一次核对的完整路径

核对从请求编号开始,再按发生顺序取记录。请求编号是关联四类记录的主线,时间范围用于缩小范围;不知道编号时,先用调用方与目标标识定位,再取编号。

核对结论要能说明三个问题:路径是什么、依据是什么、结果是什么。缺少任何一项,结论只能停留在现象描述,无法用于后续调整。

  1. 取得请求编号,确认调用方、目标标识与发生时间。
  2. 查路由记录,核对候选节点、过滤结果、最终节点与选择原因。
  3. 如发生切换,查切换记录,核对原节点、备选节点、原因与时间。
  4. 如返回失败,查错误记录,确认错误类型与涉及节点。
  5. 需要判断配置影响时,按策略版本与生效时间查策略记录。
  6. 把最终节点、选择原因与策略版本放在一起,形成完整结论。

查询条件的取用

查询条件决定取到的记录范围。条件过宽,结果中混入无关请求;条件过窄,可能漏掉同一原因的相邻请求。先按请求编号定位,再用时间范围观察同类情况。

查询范围按授权执行,超出范围时不提供结果。需要扩大范围时,按接入约定说明用途,不通过拆分请求绕过范围限制。

  • 请求编号优先,适用于单次请求的完整核对。
  • 时间范围适用于观察同类请求是否集中出现偏差。
  • 调用方与目标标识用于在时间范围内定位具体请求。
  • 策略版本用于核对某次变更前后的选择差异。
  • 节点标识用于确认某次状态变化影响了哪些请求。
  • 查询结果与切换记录、错误记录一起看,避免只取一段。

常见异常的信号组合

单条记录只能说明一个环节,异常判断需要组合。把现象与记录对应起来,可以减少无效排查;同一现象可能由状态或配置引起,记录的时间顺序可以帮助区分。

切换集中出现时,先看时间分布,再看节点状态是否在可用与不可用之间反复变化。状态频繁变化而策略不变,问题通常在健康检查或节点本身。

记录显示的现象先查判断方向
路径与预期节点不符路由记录与策略记录状态变化还是版本变化
同一请求出现备选节点切换记录切换条件是否被触发
请求返回失败且无最终节点错误记录候选集为空还是节点失败
同类请求集中切换切换记录的时间分布是否与某次状态变化同时发生
变更后选择结果变化策略记录生效时间与请求时间的先后

日常核对与交接

日常核对按固定抽样:变更后抽查一次,故障后核对涉及请求,周期核对覆盖不同区域与授权范围。抽样不必覆盖全部请求,但每类场景都要有记录可查。

交接时把请求编号、策略版本与处理结论一并移交,接收方可以按同一路径复核,不需要重新描述背景。只交结论不交记录,下一次核对仍要从头开始。

  • 节点状态变化后,核对新请求是否避开维护节点。
  • 策略变更后,核对同类请求是否按新版本选择。
  • 切换发生后,核对备选节点是否仍在授权范围内。
  • 失败返回后,核对错误类型是否与处理动作一致。
  • 交接时保留记录编号与查询条件,便于复现。

保存、访问与使用边界

记录保存期限按接入约定执行,到期后按规则处理。查询范围按授权执行,日志不保存业务正文与完整凭据;需要业务数据时,由调用方与服务节点自行记录。

记录用于核对与排查,不用于评价业务效果。涉及个人信息时,接入方在提交前完成脱敏,查询方在授权范围内使用结果。

访问记录同样需要控制。查询、导出与交接都留下操作痕迹,人员变动时及时收回权限,避免记录在授权范围外流转。

记录能否还原业务内容
不能。记录只保留路由字段,业务正文由服务节点处理。
没有请求编号还能查吗
可以按时间范围结合调用方与目标标识定位,再取请求编号。
策略变更在记录中如何体现
策略记录包含版本、生效时间与变更内容,可与请求时间对齐。

让每次核对都有顺序

按请求编号串起路由、切换、错误与策略记录,先定位环节,再判断原因。

查看路由质量说明