也许是时候停止编写详细的操作手册了

简介: 也许是时候停止编写详细的操作手册了

详细的操作手册意味着系统缺乏自动化的支持,应该尽量把编写详细手册的精力放在优化系统自动化能力上。原文: Stop Writing Great Runbooks


别再编写细致的手册了,相反,解决生产问题。


当出现生产问题,就会有人需要在线提供帮助。在生产环境中处理问题的常见方法如下:


  • 确保每一像问题都有清晰的操作手册
  • 确保每个人都接受过如何根据手册操作的培训


操作手册是一组手动任务,支持团队通常遵循"任何告警都应该有手册"之类的东西,操作手册被奉为圣经。


问题是操作手册意味着失败: 无法正确修复问题、无法提供自动化解决方案、无法提供优先级划分。此外,操作手册经常因其清晰和易于使用而受到称赞。实际上,操作手册越清晰、越容易操作,就越不能原谅没有自动化解决方案的问题。


操作手册的第 22 条军规是: 任何容易执行的操作手册都不应该存在。


如果操作手册上说按某个按钮,那就在出问题时自动完成。如果操作手册上说要读取某个图表,然后按下一个按钮,那么当出问题时,就让某些程序自动执行该操作。在支持团队的工作中,应该几乎没有什么是既容易执行又不能自动化的。


那有什么地方需要操作手册吗?


操作手册应该是一种培训,而不应该将手册视为反应性的剧本,好的手册是一种训练,能给你信心和知识,从而在不可预见的生产问题发生时快速有效的解决问题。


这是有道理的。其他需要随时待命的工作,比如医生、消防员、侦探等,在时间紧迫时不会拿出一摞剧本。


最后,有五个关于健康的值班轮转的想法:


  • 手册不是了解系统的一种方式,而是行动的号召。如果你在手册的某个页面上没有采取行动,那就把它删掉。
  • 通过降低阈值、引入产品限制、修复 bug、自动处理问题,通过这些方式避免对已知问题的支持。
  • 如果需要覆盖缺乏轮值支持的团队,可以修改非工作时间的支持容量,同时团队在工作时也应该做出更快的反应,可以将这一点编入规范。
  • PM 应该知道支持团队容量并进行优先级排序。
  • 管理者应该参与轮换支持工作。




你好,我是俞凡,在 Motorola 做过研发,现在在 Mavenir 做技术工作,对通信、网络、后端架构、云原生、DevOps、CICD、区块链、AI 等技术始终保持着浓厚的兴趣,平时喜欢阅读、思考,相信持续学习、终身成长,欢迎一起交流学习。为了方便大家以后能第一时间看到文章,请朋友们关注公众号"DeepNoMind",并设个星标吧,如果能一键三连(转发、点赞、在看),则能给我带来更多的支持和动力,激励我持续写下去,和大家共同成长进步!

目录
相关文章
|
4月前
|
Oracle 安全 关系型数据库
Oracle安装部署再也不用头疼了,分享一个实用的一键部署脚本,建议收藏!
Oracle安装部署再也不用头疼了,分享一个实用的一键部署脚本,建议收藏!
172 0
|
4月前
|
机器学习/深度学习 Ubuntu 数据挖掘
揭秘:Ubuntu系统下部署Anaconda环境及Python语言的终极指南!跟随这一步步神秘流程,解锁编程大师的秘密武器!
【8月更文挑战第19天】在Ubuntu中部署Anaconda环境与Python相当直观。首先需从官网下载Linux版安装包。接着,在终端依次执行命令:添加Anaconda清华镜像源至软件源列表,更新软件包信息,然后安装Anaconda。安装后可通过`anaconda --version`验证。使用`anaconda create -n myenv python=3.8`创建名为“myenv”的环境并指定Python 3.8版本。
294 0
|
存储 编译器 C语言
还在为每次打开程序的输入烦恼吗,这篇文章让你不在迷茫
在之前我们编写的程序中,我们总要录入一些数据给予程序用于计算,但是当我们退出程序后录入的数据会销毁,因为此时数据都是存放在内存中。等到下次再运行程序时,数据又得从新录入,这样就非常的难受。
70 0
还在为每次打开程序的输入烦恼吗,这篇文章让你不在迷茫
|
程序员 API 开发者
自动化脚本如何编写?打算写个自动发布文章的脚本教程
作为一名程序员/开发者,我们经常需要处理重复性的任务,比如发布文章到多个媒体平台。为了提高效率,我们可以编写自动化脚本来完成这些任务。本文将介绍如何使用万媒易发多平台内容同步助手来自动发布文章。
|
7月前
|
JSON 开发工具 数据格式
基于Python开发的开心麻花影视作品分析系统(源码+可执行程序+程序配置说明书+程序使用说明书)
基于Python开发的开心麻花影视作品分析系统(源码+可执行程序+程序配置说明书+程序使用说明书)
|
JSON C++ 数据格式
《C++避坑神器·二十二》VS能正常运行程序,但运行exe程序无响应解决办法
《C++避坑神器·二十二》VS能正常运行程序,但运行exe程序无响应解决办法
181 0
|
运维 监控 Shell
太牛了!100个Shell脚本实例,代码清晰拿来就能用,再也不怕写不对了!
太牛了!100个Shell脚本实例,代码清晰拿来就能用,再也不怕写不对了!
|
边缘计算 JSON Kubernetes
k8s+kubeedge+sedna安装全套流程+避坑指南+解决办法
最近在学习边缘计算要用到kubeedge,安装了好多次总会遇到各种各样的问题,因此在这里一一列出,以方便下次安装。则里面可能出错的地方太多,如果有问题,请私信联系。
2521 0
|
Oracle IDE Java
最详细的Android开发环境配置经验分享(包含配置过程中可能出现的问题及解决办法。繁琐的配置步骤是否是你头疼呢,详细配置步骤你值得拥有!)
最详细的Android开发环境配置经验分享(包含配置过程中可能出现的问题及解决办法。繁琐的配置步骤是否是你头疼呢,详细配置步骤你值得拥有!)
427 0
最详细的Android开发环境配置经验分享(包含配置过程中可能出现的问题及解决办法。繁琐的配置步骤是否是你头疼呢,详细配置步骤你值得拥有!)
|
自然语言处理 小程序 JavaScript
开发知识竞赛答题活动小程序过程中使用到的实用工具库介绍
开发知识竞赛答题活动小程序过程中使用到的实用工具库介绍
开发知识竞赛答题活动小程序过程中使用到的实用工具库介绍
下一篇
DataWorks