Erros

O AppSignal captura as exceções que sua aplicação lança, agrupa-as para facilitar a triagem e alerta você quando algo precisa de atenção. Os erros estão fortemente ligados aos traces: um erro normalmente acontece dentro de uma requisição, job em segundo plano ou execução de script, e o trace ao redor fornece o tempo e o contexto que você precisa para depurar.

​

Como o AppSignal agrupa erros

Quando sua aplicação reporta uma exceção, o AppSignal a agrupa em uma issue com outras ocorrências do mesmo tipo de erro, na mesma action e namespace. Um único bug que dispara milhares de vezes vira uma issue para triagem, e não milhares de alertas separados. Cada issue mantém um conjunto de traces: ocorrências representativas com o backtrace completo, metadados da requisição (como hostname, revision e caminho da requisição) e quaisquer tags que você adicionar.

​

Veja os erros que um deploy introduziu

O filtro Pick a revision na página de erros permite restringir a lista de erros a um deploy ou a um período. Abra-o para escolher um escopo, como By Revision (deploy), ou By Timeframe, que cobre um intervalo de tempo. Por padrão, o filtro está definido como All errors, que lista todas as issues ocorridas da mais recente para a mais antiga. Selecione New errors para listar apenas os erros vistos pela primeira vez nele:

• Most recent revisions: erros vistos pela primeira vez desde as revisions mais recentes de cada serviço.
• A specific revision: erros vistos pela primeira vez naquele deploy.
• A timeframe: erros vistos pela primeira vez dentro desse intervalo de tempo. Escolha um horário de início e fim, ou um predefinido como Last 24 hours ou Last 7 days.

Enquanto New errors estiver selecionado, o rótulo do filtro indica isso, por exemplo New in revision a1b2c3d ou New in timeframe. A alternância permanece ativa quando você escolhe outro deploy ou período. Ela também faz parte da URL da página, então um link que você compartilhar abre a mesma lista. Os deploy markers informam ao AppSignal quando cada deploy aconteceu. Até que você os adicione, o AppSignal conta tudo desde a criação do app como um único deploy. New errors em Most recent revisions então lista todos os erros. Escolha um período em vez disso. Ferramentas de IA que você conecta ao AppSignal MCP, como Claude Code ou Cursor, podem obter a mesma lista. Elas usam o parâmetro new_only da ferramenta get_exception_incidents.

​

Triagem e notificações

Cada issue pode ser atribuída a um membro da equipe, receber um estado e uma severidade, e ter suas próprias configurações de notificação. O AppSignal notifica você através dos canais configurados (e-mail, Slack e outras integrações) quando um novo erro é detectado.

​

Namespaces

Os erros são agrupados por namespace, para que você possa separar requisições web de jobs em segundo plano. Os namespaces padrão são Web e Background, e você pode configurar namespaces personalizados. Veja Namespaces para detalhes.

​

Alertas sobre taxas de erro

Além das notificações por erro, a Anomaly detection pode alertar você quando a taxa de erros de uma aplicação ou namespace ultrapassa um limite definido.

​

Reportando exceções tratadas

Se você mesmo capturar uma exceção, ainda pode reportá-la ao AppSignal usando os métodos auxiliares fornecidos pelo seu SDK. Os nomes exatos dos helpers variam por SDK, mas o objetivo é o mesmo: manter o erro vinculado ao trace, ou enviá-lo com contexto útil.

• Ruby: report_error, set_error e send_error
• Elixir: Appsignal.set_error/2 e Appsignal.send_error/3
• Node.js: setError() e sendError()
• Python: set_error e send_error
• PHP: Tratamento de exceções
• JavaScript front-end: Tratamento de erros

​

Adicione contexto de depuração

Para facilitar a investigação de erros, adicione mais contexto com:

• Tagging
• Links de backtrace
• Performance / tracing

​

Veja também

• A gem debug do Ruby: breakpoints, execução passo a passo e a pilha de chamadas: use a gem debug do Ruby para investigar um problema enquanto o reproduz localmente.
• params.expect: strong parameters no Rails 8: o Rails 8 adiciona o params.expect para permitir e exigir parâmetros em uma única etapa. Ele rejeita formatos de parâmetros inesperados como requisições inválidas.