Sentry: saber quando algo quebra

Bug em produção sem monitoramento você só descobre quando o cliente reclama. O Sentry avisa antes — observabilidade de erros e performance do stack.

O que é

Sentry captura erros, exceções e problemas de performance em produção, com stack trace, contexto, breadcrumbs e agrupamento por fingerprint. No ClubPetro está integrado via @sentry/nextjs.

Onde usamos

• Captura de erros no front e no servidor da app Next.js.
• Agrupamento pra distinguir "um usuário com azar" de "está quebrando pra todo mundo".
• Erros recorrentes alimentam o fluxo de qualidade (viram item de trabalho).

Conceitos-chave

• Issues (erros agrupados) × Tracing/Performance (latência de transações).
• Releases — associe erros à versão/deploy pra saber "começou depois de qual release".
• Source maps — sem eles, o stack trace vem minificado e ilegível; suba os source maps no deploy.
• Fingerprinting — como o Sentry agrupa; ajuste pra não fundir erros diferentes nem explodir um só em mil.
• Sample rate — em tracing, amostre pra controlar volume/custo.

Boas práticas

• Ajuste o ruído — erro esperado não deve alertar; senão ninguém olha os alertas.
• Scrub de PII — não deixe dado sensível ir pro contexto do erro (stack trace também vaza).
• Alertas por impacto — número de usuários afetados, não só contagem de eventos.
• Releases + source maps no deploy pra debugar de verdade.

Pegadinhas

• ⚠️ Ruído mata o sinal — Sentry que alerta pra tudo é Sentry ignorado.
• ⚠️ Erro capturado ≠ resolvido — entra na fila, alguém precisa agir.
• ⚠️ "Sem alerta" ≠ "sem problema" — às vezes é só falta de instrumentação.
• ⚠️ Observação prática: o SDK pede Next ≥ 15.4.1 pra rodar com Turbopack; em versão anterior aparece um aviso (benigno) no dev.

Quando usar (e quando não)

Use pra enxergar a saúde de produção em tempo real e priorizar correção por impacto. Não confunde com analytics de produto (pra isso, GA4, #07).

O que você não mede em produção, descobre pelo cliente irritado. Sentry é o aviso antes do telefone tocar.

Próximo da série: #11 — Firebase.