Crash Reports (Sentry)

O Sentry captura erros e crashes do app em produção e te avisa no painel. Sem ele, você só descobre que algo quebrou quando o usuário reclama (ou desinstala).

ImplementaçãoCopiar link da âncora

1. Rode:

   Copiar texto

   kasy add sentry

   A CLI pergunta o DSN do Sentry e salva no projeto.

2. Para pegar o DSN:

   1. Crie conta no sentry.io (plano free serve para começar)
   2. Create Project → escolha Flutter
   3. Em Settings → Client Keys (DSN) copie a string https://<chave>@oXXXX.ingest.sentry.io/XXXX
   4. Cole no kasy add sentry quando perguntar

3. Para configurar depois, sem passar pela CLI:

   Copiar texto

   # .env
   SENTRY_DSN=https://sua_chave@oXXXX.ingest.sentry.io/XXXXXX

   Pelo MCP: cole o DSN no chat e peça "configura o Sentry". O assistente grava com configure_project_keys. Veja MCP do Kasy.

InformaçõesCopiar link da âncora

O que o Sentry captura sozinhoCopiar link da âncora

Enviar erro manualCopiar link da âncora

import 'package:sentry_flutter/sentry_flutter.dart';

try {
  await algumaCoisa();
} catch (error, stack) {
  await Sentry.captureException(error, stackTrace: stack);
}

Onde ver os errosCopiar link da âncora

sentry.io/issues → mostra cada bug com:

• Linha exata do código onde quebrou
• Quantos usuários foram afetados
• Versão do app, device, OS
• Breadcrumb (últimas ações antes do erro)

Você também pode receber notificações por e-mail ou Slack quando um bug novo aparece.

Boas práticasCopiar link da âncora

• Não envie dado pessoal: Sentry vê o stacktrace, não cadastros. Mas se você logar e-mail ou CPF dentro do erro, fica salvo lá. Evite.
• Não capture erros esperados: validação de formulário, login errado etc. já tem feedback na tela. Sentry é para o que não devia acontecer.
• Mantenha o quota free saudável: o plano gratuito tem ~5k erros/mês. Se passar disso, a conta começa a descartar, então não envie tudo.

Atualizado em 03/11/2026