Um endpoint de health check é a forma mais simples e eficaz de saber se seu app Next.js está funcionando corretamente. É uma rota dedicada que retorna o status da sua aplicação e suas dependências — banco de dados, cache, APIs externas — em formato legível por máquinas.

Passo 1: Criar o Endpoint Básico

No Next.js App Router, crie app/api/health/route.ts que retorne um JSON com status, timestamp e uptime do processo. Retorne HTTP 200 para saudável, 503 para não saudável.

Passo 2: Adicionar Checks de Dependências

Adicione verificações de banco de dados (query simples como SELECT 1), APIs externas (Stripe, Auth0) e uso de memória. Se qualquer dependência falhar, retorne HTTP 503.

Passo 3: Monitorar Externamente com Nurbak

Um health check que ninguém verifica é inútil. Você precisa de um serviço externo que chame sua rota /api/health regularmente de fora da sua infraestrutura.

Com Nurbak, adicione 5 linhas ao seu instrumentation.ts e seu endpoint será verificado automaticamente de até 4 regiões globais (US, Brasil, França, Japão) a cada 1-5 minutos. Cada check captura DNS, TLS, TTFB, tamanho da resposta e mais.

Passo 4: Configurar Alertas

Configure regras de alerta para API fora do ar, alta latência, taxa de erros e expiração SSL. Envie alertas por Slack, email, WhatsApp ou SMS. Anti-spam incluído: uma notificação por incidente.

Melhores Práticas

  • Mantenha rápido — Health checks devem responder em menos de 500ms
  • Não faça cache — Sempre execute fresco com Cache-Control: no-cache
  • Inclua versão — Retorne a versão do app ou commit hash
  • Use JSON estruturado — Formato consistente para ferramentas de monitoramento

O plano grátis do Nurbak inclui 3 endpoints, checks a cada 5 minutos e alertas por email. Sem cartão de crédito.