Pular para o conteúdo principal
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.
Filtro de erros aberto na página de erros, mostrando a alternância entre All errors e New errors, as abas By Revision (deploy) e By Timeframe, e uma lista de revisions recentes

O filtro de erros com New errors selecionado e uma revision escolhida

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.

Filtros e visualizações salvas

A página de erros lembra seus filtros e os aplica na próxima vez que você a abrir: namespace, status, severidade, responsável, ordem de classificação e o filtro de revision. O AppSignal os lembra para cada app, no navegador que você usou. A consulta de busca não é lembrada. Para manter um conjunto de filtros que você usa com frequência, incluindo uma consulta de busca, salve-o como uma visualização:
  1. Defina os filtros na página de erros.
  2. Abra o menu de opções (o ícone de reticências vertical) e selecione Save view.
  3. Digite um nome para a visualização e selecione Save view.
As visualizações salvas aparecem em Errors → Views na navegação do app, e todos com acesso ao app podem abri-las. Uma visualização salva abre com seus próprios filtros e não altera os filtros que a página de erros lembra. Para atualizar uma visualização, abra-a, altere os filtros e selecione Save view novamente. Escolha Save changes to current view, ou Save changes to a new view para manter a original. O mesmo menu tem Rename view e Delete view. Excluir uma visualização a remove para todos.

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.

Adicione contexto de depuração

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

Veja também