观测要回答的三个问题
请求经过哪些节点:路由记录给出候选节点与最终节点,说明路径的实际走向。候选集与最终节点不一致时,差异来自权限过滤或状态排除,记录中可以看到过滤后的结果。
为什么这样选择:选择原因、策略版本与节点状态共同解释排序结果。只看最终节点,无法判断是策略排序还是状态变化导致,也就无法决定后续改哪里。
结果是什么:状态区分成功、切换与失败,错误记录补充失败类型。三个问题对应不同记录,查询时按顺序取用,避免在多处反复查找。
四类记录的关联方式
四类记录各自记录一个环节,字段不同,关联方式一致。请求编号是主线,策略版本用于连接配置变化,节点标识用于连接状态变化。
记录之间不做业务判断,只保留路由所需字段。需要还原业务内容时,由调用方与服务节点各自记录,两边按请求编号对照。
| 记录 | 关键内容 | 关联字段 | 用途 |
|---|---|---|---|
| 路由记录 | 调用方、目标、候选节点、最终节点 | 请求编号 | 核对路径选择 |
| 切换记录 | 原节点、备选节点、原因、时间 | 请求编号 | 核对切换过程 |
| 错误记录 | 错误类型、涉及节点 | 请求编号 | 判断失败环节 |
| 策略记录 | 策略版本、生效时间、变更内容 | 策略版本 | 核对配置变化 |
一次核对的完整路径
核对从请求编号开始,再按发生顺序取记录。请求编号是关联四类记录的主线,时间范围用于缩小范围;不知道编号时,先用调用方与目标标识定位,再取编号。
核对结论要能说明三个问题:路径是什么、依据是什么、结果是什么。缺少任何一项,结论只能停留在现象描述,无法用于后续调整。
- 取得请求编号,确认调用方、目标标识与发生时间。
- 查路由记录,核对候选节点、过滤结果、最终节点与选择原因。
- 如发生切换,查切换记录,核对原节点、备选节点、原因与时间。
- 如返回失败,查错误记录,确认错误类型与涉及节点。
- 需要判断配置影响时,按策略版本与生效时间查策略记录。
- 把最终节点、选择原因与策略版本放在一起,形成完整结论。
查询条件的取用
查询条件决定取到的记录范围。条件过宽,结果中混入无关请求;条件过窄,可能漏掉同一原因的相邻请求。先按请求编号定位,再用时间范围观察同类情况。
查询范围按授权执行,超出范围时不提供结果。需要扩大范围时,按接入约定说明用途,不通过拆分请求绕过范围限制。
- 请求编号优先,适用于单次请求的完整核对。
- 时间范围适用于观察同类请求是否集中出现偏差。
- 调用方与目标标识用于在时间范围内定位具体请求。
- 策略版本用于核对某次变更前后的选择差异。
- 节点标识用于确认某次状态变化影响了哪些请求。
- 查询结果与切换记录、错误记录一起看,避免只取一段。
常见异常的信号组合
单条记录只能说明一个环节,异常判断需要组合。把现象与记录对应起来,可以减少无效排查;同一现象可能由状态或配置引起,记录的时间顺序可以帮助区分。
切换集中出现时,先看时间分布,再看节点状态是否在可用与不可用之间反复变化。状态频繁变化而策略不变,问题通常在健康检查或节点本身。
| 记录显示的现象 | 先查 | 判断方向 |
|---|---|---|
| 路径与预期节点不符 | 路由记录与策略记录 | 状态变化还是版本变化 |
| 同一请求出现备选节点 | 切换记录 | 切换条件是否被触发 |
| 请求返回失败且无最终节点 | 错误记录 | 候选集为空还是节点失败 |
| 同类请求集中切换 | 切换记录的时间分布 | 是否与某次状态变化同时发生 |
| 变更后选择结果变化 | 策略记录 | 生效时间与请求时间的先后 |
日常核对与交接
日常核对按固定抽样:变更后抽查一次,故障后核对涉及请求,周期核对覆盖不同区域与授权范围。抽样不必覆盖全部请求,但每类场景都要有记录可查。
交接时把请求编号、策略版本与处理结论一并移交,接收方可以按同一路径复核,不需要重新描述背景。只交结论不交记录,下一次核对仍要从头开始。
- 节点状态变化后,核对新请求是否避开维护节点。
- 策略变更后,核对同类请求是否按新版本选择。
- 切换发生后,核对备选节点是否仍在授权范围内。
- 失败返回后,核对错误类型是否与处理动作一致。
- 交接时保留记录编号与查询条件,便于复现。
保存、访问与使用边界
记录保存期限按接入约定执行,到期后按规则处理。查询范围按授权执行,日志不保存业务正文与完整凭据;需要业务数据时,由调用方与服务节点自行记录。
记录用于核对与排查,不用于评价业务效果。涉及个人信息时,接入方在提交前完成脱敏,查询方在授权范围内使用结果。
访问记录同样需要控制。查询、导出与交接都留下操作痕迹,人员变动时及时收回权限,避免记录在授权范围外流转。
- 记录能否还原业务内容
- 不能。记录只保留路由字段,业务正文由服务节点处理。
- 没有请求编号还能查吗
- 可以按时间范围结合调用方与目标标识定位,再取请求编号。
- 策略变更在记录中如何体现
- 策略记录包含版本、生效时间与变更内容,可与请求时间对齐。