Runbook de automação para quem está no turno

Runbook de automação é a folha que o turno abre quando o fluxo para de noite ou no fim de semana. Ela diz o sintoma, a primeira checagem, a ação permitida e quem chamar se a ação não bastar. Sem isso, o alerta depende de quem construiu o fluxo estar acordado.
Runbook de vinte páginas não se usa no incidente. O texto que funciona cabe numa tela: o que olhar, o que pode mexer e o que é proibido mexer. O resto é documentação de desenho, lida em outro dia.

O que a primeira tela precisa responder?
Qual fluxo, desde quando está parado, quantos casos esperam e qual foi o último erro repetido. Com isso o turno sabe se é queda de destino, erro de dado ou um caso só. Sem o erro repetido, a pessoa abre cinco sistemas para chegar na mesma frase.
A tela já traz o link do caso mais antigo e o da fila. Runbook que manda “verificar o log” sem dizer qual log empurra o tempo para fora do plantão. O caminho está clicado, não descrito em parágrafo.
Qual ação o turno pode executar sozinho?
Ação segura e reversível: confirmar que o destino voltou, soltar uma prova, recolocar um caso cuja causa já passou, avisar o dono. Ação que cobra, apaga ou manda mensagem ao cliente não é passo de plantão, a menos que a alçada esteja escrita com teto e com nome.
Cada ação diz o efeito esperado. “Reprocessar” sem dizer que a chave impede duplicata é convite a cobrar duas vezes. Se a ação não tem efeito previsível, ela não está no runbook. Está numa conversa com quem construiu.
| Sintoma | Ação do turno | Para e chama |
|---|---|---|
| Destino fora, circuito aberto | Acompanhar a prova e a fila | Se passar do prazo combinado |
| Um caso com dado inválido | Não reprocessar em massa | Dono do cadastro no expediente |
| Fila crescendo com erro novo | Parar a prova e avisar | Quem publica a versão |
| Efeito duplicado suspeito | Não repetir a ação | Quem responde pela cobrança ou pelo pedido |
Quem é o dono quando o construtor não está?
O runbook nomeia um papel, não uma pessoa só. Plantão, substituto e o canal. “Chamar a Maria” falha nas férias da Maria. O papel tem como ser encontrado fora do horário comercial, ou o fluxo não deveria depender de ação humana nesse horário.
Se ninguém pode agir de noite, o runbook diz isso com clareza: esperar o expediente, o caso fica na fila, o cliente não recebe mensagem automática de sucesso. Silêncio disfarçado de procedimento é pior do que o limite escrito.
Como o texto não apodrece?
Toda publicação de versão que muda erro, fila ou efeito atualiza o runbook no mesmo ciclo. Uma falha real que o texto não cobria vira linha nova na semana, não um comentário perdido no chamado. O runbook tem data de revisão.
Treino curto: alguém que não construiu o fluxo executa a checagem num incidente simulado. Se não acha o botão, o texto está errado, não a pessoa. Esse ensaio vale mais do que revisar o documento na reunião.
O que registrar depois do susto?
Qual sintoma, qual passo foi feito, qual versão estava no ar e se o caso voltou. Esse registro alimenta o próximo runbook e a decisão de abrir circuito, fila ou volta de versão. Incidente sem nota se repete com a mesma cara.
O registro não é um relatório longo. É o essencial para o expediente seguinte continuar, não recomeçar a investigação. O caso mais antigo da fila, se ainda espera, está no topo.
Um exemplo de fila parada de madrugada
O alerta diz que a idade do caso mais antigo passou do prazo. O turno abre o runbook, vê erro de timeout e circuito aberto, confirma que a prova está espaçada e que a fila guarda a chave. Não reprocessa tudo. Se o prazo de chamar o papel estourou, chama. De manhã, o dono encontra a nota e a fila intacta.
No desenho sem runbook, o turno ou ignora o alerta ou aperta reprocessar. Os dois pioram o incidente. A folha curta é o que torna o alerta executável.
Checklist prático
O runbook presta quando alguém de fora do projeto executa o primeiro passo sem perguntar.
- Sintoma, erro repetido e idade do caso mais antigo na primeira tela
- Link direto para a fila e para o caso, sem caça ao log
- Ações permitidas separadas das proibidas
- Reprocessar só com chave e quando a causa já passou
- Papel de escalação, com substituto, não um nome só
- Limite claro de quando esperar o expediente
- Atualização do texto na mesma publicação que muda o fluxo
- Ensaio com alguém que não construiu o fluxo
Erros comuns
O alerta falha na prática quando o texto não cabe no turno.
- Runbook de muitas páginas que ninguém abre de noite
- Mandar verificar o log sem dizer qual
- Botão de reprocessar tudo como primeiro passo
- Escalar para uma pessoa que está de férias
- Não dizer que de noite ninguém age, e deixar o turno inventar
- Deixar o texto velho depois de mudar a versão do fluxo
- Não ensaiar com gente de fora do projeto
- Incidente sem nota do que foi feito
Onde a folha entra na operação?
Em automações de processos, o runbook de automação faz parte do fluxo. O alerta só existe se houver um passo que o turno consegue executar.