> ## 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.

# Namespaces

Namespaces são uma forma de agrupar incidentes de erro, incidentes de desempenho e métricas de [actions](/appsignal/terminology#actions). [Por padrão](#default-namespaces), o AppSignal fornece três namespaces: os namespaces "web", "background" e "frontend". Você pode adicionar seus próprios namespaces para separar partes do seu app, como a API ou o painel de administração, com [namespaces personalizados](#custom-namespaces).

<Tip>
  📖 Leia nosso guia sobre [como configurar namespaces][guide].
</Tip>

## O que você pode fazer com namespaces?

Vamos começar pelas coisas para as quais podemos usar namespaces:

* Agrupar [incidentes de erro](https://appsignal.com/redirect-to/app?to=exceptions) e [medições de desempenho](https://appsignal.com/redirect-to/app?to=performance) por namespace. Crie visões gerais dos namespaces mais importantes e corrija primeiro esses incidentes.
* Acompanhar e plotar métricas por namespace ([taxa de erro, contagem de erros](https://appsignal.com/redirect-to/app?to=exceptions/graphs), [throughput, tempos de resposta, tempos de fila](https://appsignal.com/redirect-to/app?to=performance/graphs), e muito mais).
* Receber [alertas de detecção de anomalias por namespace](/anomaly-detection/).
* Configurar [preferências de notificação por namespace](/application/notification-settings).

<Frame caption="Exemplo de gráficos com vários namespaces, separando uma API GraphQL e o namespace web. À esquerda, um menu suspenso com o filtro de namespace.">
  <img src="https://mintcdn.com/appsignal-715f5a51/4TRZP0Sq9Zq7PAPW/assets/images/screenshots/namespaces/graphs.png?fit=max&auto=format&n=4TRZP0Sq9Zq7PAPW&q=85&s=044f86ecbea3baac50432a8337ae69b2" alt="Gráficos do app com namespaces" width="1025" height="647" data-path="assets/images/screenshots/namespaces/graphs.png" />
</Frame>

## Namespaces padrão

O namespace "web" contém todos os dados de requisições HTTP, enquanto o namespace "background" contém métricas de bibliotecas e tarefas de background jobs. O namespace "frontend" é criado pela [integração de front-end em JavaScript](/front-end).

Você pode adicionar seus próprios namespaces para separar partes do seu app, como a API e o painel de administração.

## Namespaces personalizados

<Note>
  📖 O recurso de namespaces personalizados foi introduzido na gem AppSignal para Ruby versão
  2.3.0 e no pacote AppSignal para Elixir versão 1.3.0.
</Note>

Usar mais de um namespace facilita agrupar métricas pertencentes à
mesma parte de uma aplicação. No AppSignal, usamos namespaces personalizados para
fazer isso.

A vantagem dos namespaces personalizados é a capacidade de agrupar incidentes de erro e
desempenho de partes separadas da mesma aplicação. Pense em um
painel de administração, página pública versus back-end privado, etc.

As métricas dessas três partes em um único namespace podem poluir o namespace "web"
com incidentes de importância variável. Por exemplo, quando algo no
painel de administração quebra, não é tão grave quanto quando a página de cadastro
do front-end público quebra.

As métricas de partes separadas de uma aplicação podem ser agrupadas em
seu próprio namespace. Ao usar os helpers de instrumentação do AppSignal para
definir um namespace, é possível atribuir
[transações](/appsignal/terminology#transactions) a um determinado
namespace.

Uma vez que o namespace esteja configurado e a aplicação esteja enviando dados ao
AppSignal, o novo namespace aparecerá na navegação no AppSignal.com.
Observação: dados previamente reportados para a mesma action não são movidos para o novo
namespace.

<Note>
  📖 Para configurar namespaces personalizados no seu app, leia nosso guia para [configurar
  namespaces com nossas integrações][guide].
</Note>

<Tip>
  Apenas letras e underscores são aceitos para nomes de namespace.
</Tip>

## Limitações de namespaces

Os namespaces são ótimos para separar certas partes da sua aplicação, mas há alguns limites para eles.

Para desempenho ideal, recomenda-se não ter mais do que **10–15** namespaces no máximo. Embora não tenhamos um limite rígido para esse número, não podemos garantir o desempenho quando mais de **15** namespaces são usados.

## Ignorando namespaces

Às vezes, você tem uma determinada parte da aplicação que não precisa ser monitorada pelo AppSignal. O caso de uso mais comum é um painel de administração que você usa internamente e que não precisa de monitoramento constante. Ao ignorar um namespace inteiro, o AppSignal ignorará todos os dados transacionais de todas as actions nos namespaces configurados.

Para ignorar um namespace, primeiro configure o AppSignal para reportar todas as actions que você quer ignorar sob um certo namespace, conforme descrito no [guia de namespaces][guide].

Em seguida, configure o AppSignal no seu app para ignorar o namespace; veja nosso [guia para ignorar namespaces][ignore guide].

Após reiniciar/fazer deploy do seu app, as actions no namespace selecionado não devem mais ser reportadas em AppSignal.com.

<Note>
  📖 Para configurar o AppSignal para ignorar namespaces no seu app, leia nosso guia para
  [ignorar namespaces com nossas integrações][ignore guide].
</Note>

## Excluindo namespaces

Se você criou um namespace que não está mais ativo, pode excluí-lo na tela de [namespaces](https://appsignal.com/redirect-to/app?to=namespaces) nas configurações do app.

<Note>
  Não excluímos automaticamente um namespace caso ele deixe de receber dados.
</Note>

[guide]: /guides/namespaces.html

[ignore guide]: /guides/filter-data/ignore-namespaces.html
