O primeiro painel é uma pergunta

"O site está lento?" é uma pergunta; "tenho um dashboard" não é. Em uma infraestrutura pequena, poucos sinais bem escolhidos dão mais segurança que dezenas de gráficos sem dono.

Comece pelas jornadas que importam: a página abre, o login funciona, o post carrega e o upload termina.

Três sinais para começar

  • Logs estruturados: horário, rota, status, duração, request id e erro. Texto livre pode continuar no detalhe, mas os campos principais precisam ser filtráveis.
  • Métricas de serviço: taxa de erro, latência por rota, saturação de CPU/memória e espaço em disco.
  • Alertas acionáveis: somente quando alguém sabe o que fazer. Um alerta que dispara todo dia e nunca muda de ação vira ruído.

Um request id vale ouro

Quando uma página chama API, banco e armazenamento, o mesmo identificador atravessa os serviços. Com ele, você consegue sair do navegador e encontrar a sequência completa no log. Sem ele, cada serviço conta uma história diferente.

Alerta com contexto

Um bom alerta diz o que aconteceu, desde quando, qual impacto provável e onde investigar. "Erro 5xx acima de 5% por 10 minutos na API de posts; confira o último deploy e o banco" é melhor que "servidor vermelho".

Também configure uma janela de manutenção para deploys previsíveis. O objetivo não é esconder erro, e sim não acordar alguém por uma mudança já conhecida.

Retrospectiva transforma sinal em melhoria

Depois de um incidente, registre o sintoma, a causa, o detector e a ação que faltou. Se o problema foi um cache antigo, talvez o próximo deploy precise invalidar a chave automaticamente. Se foi espaço em disco, o alerta deveria chegar antes do limite crítico.

Infraestrutura boa é aquela que torna o próximo diagnóstico mais curto. Para um blog, isso pode caber em um serviço de logs, duas métricas e três alertas.

Essa mentalidade conversa com os textos do Akita sobre infraestrutura e agentes: ferramentas aceleram o trabalho, mas só são confiáveis quando existe feedback observável.

Leitura relacionada: Por que LLMs vão falhar na sua empresa — AkitaOnRails.