> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Erros

> Como o AppSignal rastreia, agrupa e alerta sobre erros, e onde reportar exceções tratadas.

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 **samples**: 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.

## 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](/guides/namespaces) para detalhes.

## Alertas sobre taxas de erro

Além das notificações por erro, a [detecção de anomalias](/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`](/ruby/instrumentation/exception-handling)
* Elixir: [`Appsignal.set_error/2` e `Appsignal.send_error/3`](/elixir/instrumentation/exception-handling)
* Node.js: [`setError()` e `sendError()`](/nodejs/3.x/instrumentation/exception-handling)
* Python: [`set_error` e `send_error`](/python/instrumentation/exception-handling)
* PHP: [Tratamento de exceções](/php/exception-handling)
* JavaScript front-end: [Tratamento de erros](/front-end/error-handling)

## Adicione contexto de depuração

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

* [Tagging](/application/tagging)
* [Links de backtrace](/application/backtrace-links)
* [Performance / tracing](/performance-tracing)
