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

Operador noturno com um cartão de passos curto e um alarme, abrindo a gaveta certa

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.

Cartão de falha ligado a um único cartão de ação nomeada
A falha aponta para uma ação. O turno não precisa redescobrir o fluxo.

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.

SintomaAção do turnoPara e chama
Destino fora, circuito abertoAcompanhar a prova e a filaSe passar do prazo combinado
Um caso com dado inválidoNão reprocessar em massaDono do cadastro no expediente
Fila crescendo com erro novoParar a prova e avisarQuem publica a versão
Efeito duplicado suspeitoNão repetir a açãoQuem 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.

Perguntas frequentes

▸Todo fluxo precisa de runbook?

Todo fluxo que pode falhar fora do expediente de quem o construiu, ou que segura caso de cliente. Um experimento supervisionado, que ninguém usa de noite, pode viver com o dono por perto. No dia em que o alerta toca sozinho, a folha deixou de ser opcional.

▸O runbook pode mandar reprocessar?

Pode mandar reprocessar um caso, quando a causa já passou e a chave impede duplicar o efeito. Não manda reprocessar a fila inteira como primeiro gesto. Massa sem diagnóstico repete a falha e pode repetir cobrança.

▸Quem escreve?

Quem desenha o fluxo, no mesmo ciclo da publicação, com revisão de quem opera o turno. Texto só do time técnico usa o vocabulário de quem não vai estar lá. O ensaio com outra pessoa mostra o buraco.

▸Onde o texto mora?

No lugar que o alerta abre, não num drive paralelo. Se o alarme chega sem o link da folha, o tempo se perde procurando. A versão do fluxo e a data da folha aparecem no topo.

▸E se a ação exigir acesso que o turno não tem?

Ou o acesso existe para o papel, ou a ação não está no runbook. Escrever um passo impossível só transfere a frustração. O caminho noturno usa o que o plantão realmente consegue abrir.

▸Com que frequência revisar?

Na publicação que muda o comportamento e depois de cada incidente que a folha não cobriu. Revisão anual de prateleira não pega o botão que mudou de lugar no mês passado.