撰写运行手册应回答的六个问题

一份好的运行手册针对特定服务撰写，应该回答：这是什么服务、做什么用；谁负责它；它有哪些依赖；它的基础设施长什么样；它产生哪些指标和日志、含义是什么；该为它设置哪些告警、为什么设置。每条告警都应链接到对应服务的运行手册，响应者翻开手册就能理解发生了什么、告警含义和恢复步骤，这在团队规模扩大、不是所有人都熟悉每套系统时尤其关键。但运行手册容易被滥用——如果恢复步骤退化成”复制粘贴命令”式清单，说明这一步该被自动化或直接删除告警，运行手册只该留给真正需要人类判断和诊断能力的场景，这一点与[[手动配置是自动化缺失的信号]]是同一枚硬币的两面。