已知错误记录要同时服务两个目的:让一线在故障复现时能直接找到并套用临时解决办法,让问题管理侧掌握影响范围、责任人和关闭条件。做法是把已知错误作为独立记录维护,用唯一编号关联问题单与受影响事件,写清触发条件、影响范围、临时办法的生效前提与回退方式,并标注状态、复核时间和关闭条件。下面给出可照填的字段结构、从事件识别到关闭的操作步骤、影响范围与临时办法的写法,以及一份完整示例和验收清单。
要点总览(TL;DR)
- 已知错误记录用唯一编号关联问题单与受影响事件单,字段覆盖现象、触发条件、影响范围、临时办法、状态、责任人与关闭条件。
- 从事件识别到关闭分六步:识别、建档、临时办法验证、发布告知、更新、关闭;现象可复现、根因未定位、已有可尝试的恢复动作三条同时成立即可建档。
- 影响范围按服务/功能、版本、用户群、时间窗、严重度分维度写,区分已确认受影响与可能受影响,并随新增事件和版本变更同步更新。
- 临时办法要写清适用条件、前置检查、编号步骤、副作用、回退方式、有效期与批准人,经小范围验证后再发布给一线。
- 发布前和复核时用检查清单逐项核对字段完整性、可执行性、回退、影响范围准确性与关联关系。
一条已知错误记录要写哪些字段
已知错误记录的价值在于“可检索、可执行、可判断”。字段设计围绕这三件事展开:一线能凭现象和触发条件快速命中记录,能按步骤执行恢复动作,问题经理能据此判断影响面和何时可以关闭。下表给出建议字段,可按组织实际裁剪,但标注为必填的字段建议保留。
| 字段 | 填写要求 | 是否必填 |
|---|---|---|
| 已知错误编号 | 全局唯一,建议采用“KE-年份-序号”格式,创建后不变 | 必填 |
| 关联问题单 | 填写根因分析所在的问题单编号,一条已知错误对应一个主问题单 | 必填 |
| 关联事件单 | 列出触发本记录的典型事件单编号,后续新增受影响事件时追加 | 必填 |
| 标题 | 用“现象+对象”描述,如“登录页偶发超时导致无法进入系统”,避免只写内部代号 | 必填 |
| 现象描述 | 用户或监控可观察到的表现,写清报错信息、界面表现、日志关键字 | 必填 |
| 触发条件 | 可复现或可推断的条件,如特定版本、特定时段、特定操作路径、并发量区间 | 必填 |
| 影响范围 | 按服务/功能、版本、用户群、时间窗、严重度分维度描述,区分已确认与可能受影响 | 必填 |
| 临时解决办法 | 操作步骤、生效前提、限制条件、回退方式,缺一不可 | 必填 |
| 状态 | 建议取值:待验证、已发布、已失效、已关闭 | 必填 |
| 责任人 | 记录维护人(通常为问题经理)与技术验证人分开填写 | 必填 |
| 复核时间 | 下一次确认临时办法是否仍有效的日期,到期未复核应触发提醒 | 必填 |
| 关闭条件 | 写明根因修复的判定标准,如补丁上线并观察一个发布周期无复现 | 必填 |
| 变更记录 | 记录每次修改的时间、修改人和修改内容摘要 | 建议填写 |
字段之间要保持引用关系:事件单是发现问题的入口,问题单是根因分析的载体,已知错误记录是把两者结论转成一线可用动作的中间层。缺少关联字段,记录就会变成孤立文档,后续无法回溯影响面。
从事件到已知错误:记录与更新的操作步骤
一条已知错误通常从反复出现的事件中产生。下面的流程说明每个环节的输入、动作、输出和完成标志,可按组织规模合并角色,但动作顺序建议保留。
| 步骤 | 输入 | 动作 | 输出 | 完成标志 |
|---|---|---|---|---|
| 1. 识别 | 同类事件单、监控告警、一线反馈 | 判断事件是否可复现、根因是否尚未定位;若同一现象在设定周期内重复出现且无确定修复方案,判定为候选已知错误 | 候选清单及关联事件单 | 问题经理确认候选成立 |
| 2. 建档 | 候选清单、事件单中的现象与日志 | 由问题经理创建已知错误记录,填写编号、标题、现象、触发条件,关联问题单与典型事件单 | 状态为“待验证”的记录 | 必填字段齐全,关联关系可跳转 |
| 3. 临时办法验证 | 技术负责人提出的恢复动作草案 | 在测试环境或小范围用户中验证步骤可执行、副作用可控,补充生效前提与回退方式 | 验证结论与修订后的临时办法 | 验证人签字确认,回退步骤经过演练或推演 |
| 4. 发布与告知 | 验证通过的记录 | 事件经理确认影响范围表述后,将状态改为“已发布”,通过服务台知识库、值班群或工单模板向一线告知检索方式 | 一线可检索到的记录 | 一线能在知识库按现象或报错关键字命中该记录 |
| 5. 更新 | 一线反馈、新增事件、版本变更 | 追加受影响事件单,修订影响范围与临时办法,更新复核时间,保留变更记录 | 更新后的记录与变更记录 | 变更记录可追溯,复核时间未过期 |
| 6. 关闭 | 根因修复上线、验证结果 | 确认关闭条件达成后,将临时办法标记为失效,状态改为“已关闭”,并在问题单中回填结论 | 关闭记录与问题单结论 | 关闭条件逐条核对通过,关联事件单已标注处理方式 |
识别环节最容易出现分歧:有人倾向等根因明确再建档,结果一线在等待期间反复摸索。较稳妥的判定是“现象可复现、根因未定位、已有可尝试的恢复动作”三条同时成立即可建档,后续随根因分析推进再修订。建档时点建议在第二次同类事件发生后,避免一次性偶发问题占用记录资源。
记录需要在工单与知识条目之间保持状态同步。以ONES为例,事件单、问题单与知识条目可以在同一平台内关联,问题经理在问题单中推进根因分析时,可将结论沉淀为知识条目供服务台检索,状态变更留痕,便于复核影响范围与关闭条件。具体字段和流转方式以组织实际配置为准。
影响范围怎么写才可用
影响范围的常见问题是写成“部分用户受影响”这类无法判断的表述。可用的写法要能回答三个问题:哪些服务或功能、哪些版本和用户群、从什么时候开始。建议按维度分列,并明确区分已确认与可能受影响。
| 维度 | 写法要求 | 正例 | 反例 |
|---|---|---|---|
| 服务/功能 | 写到具体功能点,而非整个系统 | 登录、单点登录回调、密码重置 | 系统受影响 |
| 版本 | 写明版本号或发布批次 | 客户端 5.2.0 至 5.2.3 | 新版本 |
| 用户群 | 用可统计的口径描述 | 使用企业账号登录的约 300 名用户 | 部分用户 |
| 时间窗 | 写明首次发现时间与复现时段规律 | 每日 9:00–10:00 高峰时段复现 | 偶发 |
| 严重度 | 与事件优先级口径一致 | P2,登录失败但可通过备用入口进入 | 比较严重 |
已确认受影响指有事件单、日志或复现记录支撑的部分;可能受影响指根据版本、配置推断但尚未验证的部分。两类分开写,能避免通知范围被夸大,也避免遗漏。影响范围在以下情况需要更新:新增同类事件、版本发布或回滚、临时办法生效后影响面变化、根因分析缩小或扩大范围。每次更新同步调整事件优先级和通知范围,例如影响面从单部门扩展到全公司时,应升级事件等级并扩大通知对象。
临时解决办法的写法与风险控制
临时办法的目标是恢复服务,同时不引入新的故障。写法上要满足“照着做能完成、做之前能判断是否适用、做完能撤回”。建议每条临时办法按以下结构编写:
- 适用条件:写明版本、角色权限、环境前提,例如“仅适用于 5.2.x 客户端且用户已绑定企业账号”。
- 前置检查:执行前需确认的事项,如备份当前配置、确认无正在进行的批量任务。
- 操作步骤:按顺序编号,每步写清操作对象、操作动作和预期结果,避免“联系相关人员处理”这类无法执行的表述。
- 副作用:说明执行后可能出现的影响,如“清除缓存后用户需重新登录一次”。
- 回退方式:写明撤回步骤和回退后的验证点,确保执行失败时能恢复原状。
- 有效期与失效条件:写明复核时间,以及版本升级、根因修复后自动失效的规则。
- 批准人:明确谁有权批准发布,通常由技术负责人验证、事件经理确认影响范围后发布。
风险控制的关键在于发布前的小范围验证和发布后的失效管理。未经小范围验证的步骤直接推给一线,容易在高峰期造成二次故障;缺少失效条件的临时办法,会在根因修复后继续被套用,掩盖真实问题。建议在记录中设置复核提醒,到期未复核的临时办法自动降级为“待验证”,一线检索时能看到状态提示。
角色分工与交付物
记录维护涉及四类角色,职责边界清晰才能保证记录质量和更新及时。
| 角色 | 主要职责 | 交付物 |
|---|---|---|
| 服务台/一线 | 按现象检索记录,套用临时办法,记录执行结果;发现步骤失效或现象不符时反馈 | 事件单中的处理记录、失效反馈 |
| 事件经理 | 确认影响范围表述,决定通知范围与事件等级,批准临时办法对一线发布 | 影响范围确认意见、发布通知 |
| 问题经理 | 创建与维护已知错误记录,保证字段完整、状态准确、复核按时,推动关闭 | 已知错误记录、变更记录、关闭结论 |
| 技术负责人 | 提出并验证临时办法,评估副作用与回退方式,推进根因修复 | 验证结论、根因修复方案 |
小团队中事件经理与问题经理可由同一人兼任,但验证与发布建议由不同人完成,形成基本复核。角色分工要落到记录字段上,责任人和验证人分开填写,避免出现无人复核的记录。
填写示例:一次登录超时故障的已知错误记录
以下为演示情景,用于说明字段如何落地,不代表真实案例。
背景与现象:某内部系统在每日上班高峰出现登录页加载超时,用户点击登录后等待较长时间后报错,刷新后部分用户可进入。监控显示认证服务响应时间在高峰时段明显上升,根因尚未定位。
记录填写:
- 已知错误编号:KE-2024-017;关联问题单:PRB-2024-052;关联事件单:INC-2024-1180、INC-2024-1193、INC-2024-1201。
- 标题:登录页高峰时段超时导致无法进入系统。
- 现象描述:登录页加载超过 30 秒后提示“请求超时”,日志出现认证服务连接等待关键字。
- 触发条件:工作日 9:00–10:00,客户端 5.2.0 至 5.2.3,使用企业账号登录。
- 影响范围:已确认受影响为登录与单点登录回调功能,涉及约 300 名使用企业账号的用户,时间窗为工作日高峰时段,严重度 P2;可能受影响为密码重置功能,尚未验证。
- 临时解决办法:适用条件为 5.2.x 客户端且用户已绑定企业账号;前置检查为确认用户未处于批量导入任务中;步骤为引导用户使用备用登录入口、清除本地会话缓存后重试;副作用为需重新登录一次;回退方式为恢复原登录入口并保留会话日志;有效期为两周,版本升级后失效;批准人为技术负责人验证、事件经理发布。
- 状态与复核:状态“已发布”,责任人问题经理,复核时间两周后。
状态流转与关闭:记录创建时为“待验证”,小范围验证通过后改为“已发布”并通知一线。两周内新增两条关联事件单,影响范围未扩大。认证服务扩容补丁上线并观察一个发布周期无复现后,核对关闭条件达成,临时办法标记失效,状态改为“已关闭”,问题单回填根因结论。
完成检查:记录是否可用
发布前和复核时可按以下清单逐项核对,任一项不通过则退回修订。
| 检查项 | 核对内容 | 通过标准 |
|---|---|---|
| 字段完整性 | 编号、关联问题单与事件单、现象、触发条件、影响范围、临时办法、状态、责任人、复核时间、关闭条件 | 必填字段无空缺,关联关系可跳转 |
| 临时办法可执行性 | 步骤是否编号、每步是否有预期结果、前置检查是否齐全 | 未参与分析的人员可按步骤完成操作 |
| 回退检查 | 是否写明回退步骤与回退后验证点 | 执行失败时能恢复原状并有验证方法 |
| 影响范围准确性 | 是否按服务、版本、用户群、时间窗、严重度分维度描述,已确认与可能受影响是否分开 | 可据此判断通知范围和事件等级 |
| 状态与复核时间 | 状态取值是否规范,复核时间是否在未来且有人负责 | 到期可触发提醒,失效条件明确 |
| 关联检查 | 事件单、问题单与记录是否双向可查 | 从任一入口能追溯到其余记录 |
检查清单建议固化为发布前的必过环节,并在每次复核时重复执行。记录可用性的最终标准是一线能否在故障复现时独立完成检索和恢复,问题经理能否据此判断影响面和关闭时机。
常见问题
临时解决办法发布后,一线反馈步骤无效或现象不符,应该怎么处理?
先由一线在事件单中记录执行结果和失败现象,问题经理据此判断是步骤描述不清、适用条件遗漏还是环境已变化。若属于记录问题,修订临时办法并保留变更记录;若现象已与记录不符,将记录状态降级为“待验证”,暂停向一线推荐,同时通知事件经理重新确认影响范围。修订后仍需经过小范围验证再恢复发布。
根因一直定位不到,已知错误记录可以长期保持“已发布”状态吗?
可以保持发布状态,但需要靠复核时间管理有效性。每次到期复核时确认临时办法是否仍可执行、影响范围是否变化、是否有新的关联事件,复核通过则顺延下一次复核时间。若临时办法已无法覆盖新现象,应降级为“待验证”并补充新的恢复动作。长期未定位根因的记录建议在问题管理侧定期回顾,评估是否需要升级处理优先级。
同一现象涉及多个服务或版本时,应该建一条记录还是多条?
建议以根因假设为单位建一条主记录,在影响范围字段中按服务、版本、用户群分维度列出,并关联各维度下的典型事件单。这样一线检索时能命中同一条记录,问题经理也能看到完整影响面。若后续根因分析确认是相互独立的两类问题,再拆分为多条记录,并在原记录中注明拆分去向,避免一线检索到已过时的合并记录。
临时解决办法的批准人应该由谁担任,小团队能否简化?
通常由技术负责人验证步骤可执行、副作用可控,事件经理确认影响范围后批准对一线发布。小团队中事件经理与问题经理可由同一人兼任,但验证与发布建议由不同人完成,形成基本复核。简化时至少保留验证记录和发布确认两个动作,并在记录中分别填写验证人与责任人,避免出现无人复核的记录。
记录关闭后,历史临时解决办法还需要保留吗?
建议保留并标记为“已关闭”,临时办法同时标注失效。保留的价值在于同类现象再次出现时,问题经理可以快速比对历史处理路径,一线也能看到该办法已不适用,避免误用。关闭时在问题单中回填根因结论,并与已知错误记录双向关联,便于后续追溯。
