Runbook — Coleta de telemetria (AlloyAgentDown)

Severidade: P1 · Impacto: host invisível para o monitoramento (métricas/logs/traces não coletados). Os serviços do host podem estar normais.

Verificação

1. Confirmar que o host em si está de pé (SSH). Se não: seguir host-down.
2. Na VM: docker ps | grep alloy-agent e docker logs --tail 100 alloy-agent.
3. Conectividade com o gateway: curl -sv telnet://<ip-ops>:4317 de dentro da VM.

Causas prováveis

• Container alloy-agent parado ou em crash (config inválida após atualização).
• Firewall/rede bloqueando 4317/4318 até a stack de operações.
• Gateway (alloy-gateway na VM de ops) fora do ar — nesse caso TODOS os hosts somem juntos.

Ação

1. Agente: docker compose up -d em /opt/pagesaude/services/observability/agent; se crash de config, ver logs e corrigir no repositório antes de reprovisionar.
2. Todos os hosts sumiram ao mesmo tempo: verificar o gateway e a stack na VM de ops (docker ps em /opt/pagesaude/services/observability/stack).

Escalonamento

Persistindo > 30 min, registrar janela de cegueira de monitoramento no canal de incidentes.