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

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

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


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


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


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


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


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


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


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


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


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


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


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


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




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

目录
相关文章
|
3月前
|
移动开发 JavaScript C#
分享53戏源代码总有一个是你想要的(亲测每一个均可用)
分享53戏源代码总有一个是你想要的(亲测每一个均可用)
24 0
|
3月前
|
存储 Unix Shell
Python 自动化指南(繁琐工作自动化)第二版:十七、计时、安排任务和启动程序
Python 自动化指南(繁琐工作自动化)第二版:十七、计时、安排任务和启动程序
59 1
|
4月前
|
程序员 API 开发者
自动化脚本如何编写?打算写个自动发布文章的脚本教程
作为一名程序员/开发者,我们经常需要处理重复性的任务,比如发布文章到多个媒体平台。为了提高效率,我们可以编写自动化脚本来完成这些任务。本文将介绍如何使用万媒易发多平台内容同步助手来自动发布文章。
|
5月前
|
JSON C++ 数据格式
《C++避坑神器·二十二》VS能正常运行程序,但运行exe程序无响应解决办法
《C++避坑神器·二十二》VS能正常运行程序,但运行exe程序无响应解决办法
68 0
|
11月前
|
运维 监控 Shell
太牛了!100个Shell脚本实例,代码清晰拿来就能用,再也不怕写不对了!
太牛了!100个Shell脚本实例,代码清晰拿来就能用,再也不怕写不对了!
|
边缘计算 JSON Kubernetes
k8s+kubeedge+sedna安装全套流程+避坑指南+解决办法
最近在学习边缘计算要用到kubeedge,安装了好多次总会遇到各种各样的问题,因此在这里一一列出,以方便下次安装。则里面可能出错的地方太多,如果有问题,请私信联系。
1802 0
|
Web App开发 小程序 开发者
三分钟创建一个小程序-每天三分钟玩转小程序 1
三分钟创建一个小程序-每天三分钟玩转小程序 1
三分钟创建一个小程序-每天三分钟玩转小程序 1
|
Oracle IDE Java
最详细的Android开发环境配置经验分享(包含配置过程中可能出现的问题及解决办法。繁琐的配置步骤是否是你头疼呢,详细配置步骤你值得拥有!)
最详细的Android开发环境配置经验分享(包含配置过程中可能出现的问题及解决办法。繁琐的配置步骤是否是你头疼呢,详细配置步骤你值得拥有!)
271 0
最详细的Android开发环境配置经验分享(包含配置过程中可能出现的问题及解决办法。繁琐的配置步骤是否是你头疼呢,详细配置步骤你值得拥有!)
|
自然语言处理 小程序 JavaScript
开发知识竞赛答题活动小程序过程中使用到的实用工具库介绍
开发知识竞赛答题活动小程序过程中使用到的实用工具库介绍
开发知识竞赛答题活动小程序过程中使用到的实用工具库介绍
|
移动开发 小程序 IDE
小程序测试全攻略,还学不会你来找我(含实操代码)
小程序测试全攻略,还学不会你来找我(含实操代码)
424 0