跳转到内容

Troubleshooting Playbook Template(问题排查手册模板)

知识库位置:FDE Knowledge Base/99 Templates/Troubleshooting-Playbook-Template.md

适合问题排查类(Troubleshooting,问题排查)知识条目,即 03 Engineering/Troubleshooting/ 下的 Playbook(问题排查手册)。

复制下方模板正文,替换 [Problem Name](问题名称)等占位符。

# [Problem Name](问题名称)
## Problem(问题)
一句话描述问题。
## Symptoms(症状)
用户或监控看到什么?
## Impact(影响)
这个问题影响什么?
## Expected Behavior(期望行为)
正确行为应该是什么?
## Scope(影响范围)
哪些用户、系统、环境受到影响?
## Recent Changes(最近变更)
最近有哪些变化?
## Possible Causes(可能原因)
### Cause 1(原因 1)
### Cause 2(原因 2)
### Cause 3(原因 3)
## Diagnostic Steps(诊断步骤)
### Step 1
检查什么?
### Step 2
如何缩小范围?
### Step 3
如何验证 Hypothesis(假设)?
## Diagnostic Flow(诊断流程)
Problem(问题)
↓
Check A(检查 A)
├─ Yes → ...
└─ No → ...
## Fixes(修复方式)
### Immediate Mitigation(临时缓解)
如何先恢复业务?
### Permanent Fix(永久修复)
如何解决根因?
## Validation(验证)
如何确认问题已经解决?
## Prevention(预防措施)
增加:
- Test(测试)
- Alert(告警)
- Validation(校验)
- Guardrail(护栏)
- Runbook(运维手册)
## Escalation Criteria(升级条件)
什么情况下需要升级给:
- Platform Team(平台团队)
- Security(安全团队)
- Data Team(数据团队)
- Vendor(供应商)
- Customer IT(客户 IT 团队)
## Related Topics(关联知识)
相关 Concept(概念)/ Decision Guide(决策指南)/ Checklist(检查清单)。