工作机制
运行手册从具体触发条件开始,例如告警名称或维护任务,先列出前置条件和权限,再给出带确切命令、预期输出和验证方法的编号步骤。手册要注明负责人、最近测试日期和升级路径。能脚本化的步骤应写成脚本,手册只负责链接而不是重复命令。
适用场景与取舍
已知故障模式、重复性维护和凌晨三点也必须可靠执行的值班流程适合使用运行手册;全新的未知事故更需要调查能力,而不是清单。与口口相传的经验相比,手册缩短缓解时间,也能在人员流动后保留知识。代价是系统变化会让手册腐化,过期命令可能引发第二次事故;因此应从告警链接手册,并在低峰期定期演练。
具体示例
消费积压告警链接到一份手册:先在仪表盘确认积压,把消费者扩容到六个,验证积压正在下降;若十分钟内未缓解,升级到平台团队。每条命令都写明预期输出,工程师能立刻发现连错了集群。
常见误解与关联概念
运行手册不是写一次就遗忘的 wiki 页面,而是需要版本化和测试的运维知识;它不替代对系统的理解,自动化也不会让手册过时,因为脚本失败时仍要有人诊断。事故指挥决定由谁执行,复盘催生新的手册和修复,优雅关闭这类流程通常也值得一份手册。