Guia de Projeto Next.js

Padrão completo de rollout para apps Next.js (runtime Node + telemetria browser)

Use este guia quando seu produto roda em Next.js e você precisa de visibilidade ponta a ponta entre servidor e navegador.

Escopo de Arquitetura

  • Runtime servidor: rotas API, server actions, SSR.
  • Runtime browser: interações de usuário, transições de rota, erros frontend.
  • Contexto compartilhado: service/env/version/release.

Setup Recomendado

  1. Configure credenciais por ambiente.
  2. Inicialize SDK Node nos caminhos de startup do servidor.
  3. Inicialize SDK Browser no bootstrap do cliente.
  4. Capture fronteiras de requisição, chamadas externas e erros.
  5. Anexe metadata de release via CI/CD.

Contrato Mínimo de Dados

  • service: web-nextjs
  • env: dev / staging / prod
  • version: commit SHA ou build ID
  • IDs de correlação entre servidor e cliente

Lista de Verificação

  • Eventos de browser e servidor visíveis.
  • Erros de servidor com contexto de requisição.
  • Incidentes frontend mapeáveis para traces backend.
  • Eventos de deploy visíveis na timeline.

Fortalecimento de Produção

  1. Chaves de servidor sempre privadas.
  2. Sampling/replay configurados para controlar custo.
  3. Flush no shutdown gracioso do runtime servidor.
  4. Validação pós-upgrade de framework.

Solução de Problemas

  • Cliente sem dados: valide bootstrap client-side.
  • Servidor sem dados: valide init no runtime servidor.
  • Correlação quebrada: padronize campos version/release.

Nesta página