Runbook

Visão geral

Runbooks são os procedimentos operacionais executáveis usados pelo time do Command Center durante um acionamento, os passos documentados (e, quando aplicável, automatizados) para diagnosticar e resolver um problema conhecido.

A execução de runbooks automatizados acontece dentro do Elven Operator. Ações ali têm efeito real no ambiente do cliente, o acesso é operacional, não é uma tela de simulação.

Papel no atendimento

Ao receber um acionamento, o Analista do Command Center verifica se existe um runbook aplicável ao tipo de evento antes de iniciar a análise do zero. Isso padroniza o diagnóstico e a mitigação de problemas conhecidos, tornando a resposta mais rápida e menos dependente do conhecimento individual de quem está de plantão naquele momento.

Quando existe um runbook aplicável, os passos nele descritos guiam a atuação do analista durante o acionamento.
Quando o runbook não resolve o incidente, ou não existe um runbook aplicável ao cenário, o atendimento é escalonado para o Incident Commander.

Runbooks também aparecem como filtro nos Reports do Command Center, permitindo acompanhar quais procedimentos foram mais executados em um período — um indicador útil para identificar problemas recorrentes no ambiente.

Acessando o Elven Operator

A execução de runbooks é feita a partir da aba Clientes do Elven Operator, que lista os ambientes com agente registrado — versão do agente, quantidade de scripts disponíveis, quando foi visto por último e um histórico recente de execuções. O botão Acessar abre a biblioteca de runbooks daquele cliente.

Tela de Clientes do Elven Operator, listando os ambientes com agente registrado (ex.: elven-observability, elven-plataform), com versão do agente, quantidade de scripts, quando foi visto por último e botão Acessar.

Biblioteca de runbooks

Dentro de um cliente, os runbooks aparecem como uma lista de scripts, organizados por área (ex.: Observabilidade, LGTM) e com a severidade do problema que tratam. É possível filtrar por texto e navegar entre as abas de área. Cada linha mostra o nome do script, uma descrição curta do que ele faz, e o botão Executar para rodá-lo imediatamente.

Execução

Ao executar um runbook, o Elven Operator abre um painel com o log em tempo real do que está sendo feito — comandos executados, status de cada verificação e o resultado final, com tempo de execução e exit code. O log pode ser copiado para documentar o atendimento ou anexar a um incidente.

Saiba mais

O catálogo completo de runbooks varia por cliente e é mantido pelo time do Command Center conforme os problemas conhecidos de cada ambiente.