用途:为某个服务生成一份完整的值班运行手册,让值班工程师在半夜被呼叫时无需向他人求助即可自信响应。资料称其目标是通过消除“先做什么”的困惑来降低平均修复时间(MTTR),面向刚被呼叫、需要立即行动的人,而非从容阅读文档的人。
必要输入:需提供或询问——服务名称及其作用、团队与技术负责人姓名、当前会呼叫值班的告警列表、监控方案(Datadog / Grafana / CloudWatch / PagerDuty 等)、常见故障模式及其修复方式、升级联系人、部署方案(值班能否回滚及方法)、服务依赖(它依赖什么、什么依赖它)。
输出内容结构:手册以“On-Call Runbook: [服务名]”开头,含团队、技术负责人、PagerDuty 服务与升级策略链接、更新与复查日期;快速参考(仪表盘、日志、回滚命令、30 分钟未解决升级);升级矩阵与联系人表;服务架构简图;按告警逐条编写运行手册(含义、严重级别、SLO 影响、分步排查与修复);诊断速查命令;仪表盘链接;事件通报模板;值班交接模板;质量检查与反模式清单。
用法:按模板逐告警填写具体命令、仪表盘链接或查询,避免“查看日志”之类模糊步骤。每个会呼叫值班的告警都要有对应条目,回滚命令需准确并近期测试过,升级联系人要有电话和 Slack 句柄。
限制与反模式:不要收录没有明确值班动作的告警;不要把未记录或未测试的回滚流程留在手册中;不要只留邮箱升级路径;手册不能一次写完就当作永久有效,每次事件后应触发相关条目复查。资料未提供具体服务的命令、链接、联系方式与数值,需由使用者自行补充。