Runbook — Erros HTTP (HTTPTotalFailure, HTTP5xxSustained)

Severidade: P0/P1 · Impacto: usuários recebendo erros; aplicação parcial ou totalmente indisponível.

Verificação

1. Dashboard Application / API: taxa de erro, rotas com maior erro, painel de logs/traces.
2. Um trace de erro recente (Grafana → Explore → Tempo) mostra o span que falha e a causa (exception, timeout, conexão recusada).
3. Correlacionar com alertas de infra ativos (banco, host, containers) no dashboard Core Alerts.

Causas prováveis

• Deploy recente com bug (conferir horário do início dos erros vs deploy).
• Banco/Redis indisponível ou saturado.
• Dependência externa fora.
• Traefik sem rota para o serviço (404/502 generalizado).

Ação

1. 100% de erro após deploy: rollback imediato para a imagem anterior; investigar depois.
2. Erro vindo de dependência (visível no trace): seguir o runbook da dependência (postgres, redis).
3. 502/503 do Traefik: verificar se o container da aplicação está de pé e na rede pagesaude.

Escalonamento

P0 (falha total) sem causa identificada em 15 min: envolver backend + infra em call de incidente.