Operação e resposta a incidentes do n8n

Este runbook resume as verificações comuns do ambiente de produção. Ele não substitui os scripts e checklists versionados no repositório privado 1Nort-Digital/n8n-workflows.

Sinais mínimos

Monitorar continuamente:

disponibilidade do editor e dos webhooks;
tamanho e idade da fila;
execuções com erro e duração;
CPU, memória, disco, reinícios e OOM por serviço;
conexões e saúde do PostgreSQL;
persistência e memória do Redis;
validade de certificados e erros do Traefik;
idade e verificação do último backup.

Alertas críticos devem chegar ao Discord por um caminho que não dependa do próprio n8n.

Triagem

Confirmar o impacto e o horário inicial.
Verificar editor, domínio de webhooks e um workflow canário.
Inspecionar serviços, tasks, reinícios e placement no Portainer/Swarm.
Conferir fila, worker disponível, PostgreSQL e Redis.
Correlacionar métricas e logs sem copiar payloads sensíveis.
Decidir entre limitar tráfego, suspender o workflow afetado ou executar rollback.

Rollback

O rollback de workflow deve restaurar exatamente o commit e a versão previamente aprovados. Mudanças de stack, proxy, banco ou fila usam seus próprios bundles e procedimentos. Nunca alterar a encryption key como tentativa de recuperação.

Backup e restore

O database de produção deve possuir dump periódico criptografado, checksum e retenção no R2. A existência do arquivo não basta: a verificação deve confirmar integridade e idade. O restore completo é realizado em database isolado, nunca por cima da produção, e precisa ser ensaiado dentro do RTO definido.

Registro do incidente

Registrar severidade, impacto, linha do tempo, causa, ações, responsáveis, evidências sanitizadas e medidas preventivas. Correções feitas diretamente no n8n devem ser exportadas, sanitizadas e reconciliadas no GitHub.

Encerramento

O incidente só é encerrado quando o serviço está estável, o backlog foi tratado, alertas voltaram ao normal, o estado do GitHub corresponde ao n8n e as ações de acompanhamento possuem owners e prazos.