O que é um Runbook?
Um runbook é um procedimento documentado, passo a passo, para executar uma tarefa operacional específica ou responder a um tipo conhecido de incidente, de modo que qualquer pessoa possa executá-lo de forma confiável.
Quando algo quebra às 3 da manhã, você não quer que o responsável reinvente a resposta do zero. Um runbook captura os passos comprovados para diagnosticar e corrigir um problema conhecido, transformando o conhecimento de especialistas em uma checklist que qualquer pessoa de plantão pode seguir.
Para que serve um runbook
Um runbook documenta como lidar com uma situação operacional recorrente: reiniciar um serviço travado, fazer failover de um banco de dados ou responder a um alerta específico. Ele codifica o conhecimento institucional para que a resposta não dependa de um único especialista estar acordado e disponível.
O que faz um bom runbook
Bons runbooks são específicos, atualizados e acionáveis. Eles descrevem os sintomas que os disparam, os comandos ou passos exatos a serem executados e como verificar o sucesso. Conselhos vagos como "investigue o problema" são inúteis às 3 da manhã; o que importa são passos concretos que um responsável cansado possa seguir.
Runbook versus playbook
Os termos são frequentemente usados como sinônimos, mas muitas equipes tratam um runbook como os passos detalhados para uma tarefa específica e um playbook como a estratégia de mais alto nível para uma classe de incidentes. A distinção é menos importante do que ter tanto a estratégia quanto os passos concretos documentados.
Mantendo-os confiáveis
Um runbook desatualizado é pior do que nenhum, porque leva os responsáveis por caminhos errados. Os runbooks precisam ser testados e atualizados conforme os sistemas mudam - idealmente consultados durante incidentes reais e revisados depois no postmortem. Um runbook em que ninguém confia não será seguido.
Do runbook à automação
Um runbook bem definido é um projeto para automação. Se um procedimento é preciso o suficiente para ser escrito passo a passo, muitas vezes é preciso o suficiente para ser convertido em script. Muitas equipes automatizam progressivamente seus runbooks, transformando a recuperação manual em sistemas de autocorreção que agem antes mesmo de um humano ser acionado.
Principais conclusões
- Um runbook é um procedimento documentado para uma tarefa operacional ou incidente específico.
- Bons runbooks são concretos e atualizados; os desatualizados são ativamente prejudiciais.
- Runbooks precisos são o primeiro passo rumo à automação da recuperação.