Namespaces

Namespaces são uma forma de agrupar incidentes de erro, incidentes de desempenho e métricas de actions. Por padrão, 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.

​

O que você pode fazer com namespaces?

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

• Agrupar incidentes de erro e medições de desempenho 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, throughput, tempos de resposta, tempos de fila, e muito mais).
• Receber alertas de detecção de anomalias por namespace.
• Configurar preferências de notificação por namespace.

​

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. Você pode adicionar seus próprios namespaces para separar partes do seu app, como a API e o painel de administração.

​

Namespaces personalizados

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

​

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. Em seguida, configure o AppSignal no seu app para ignorar o namespace; veja nosso guia para ignorar namespaces. Após reiniciar/fazer deploy do seu app, as actions no namespace selecionado não devem mais ser reportadas em AppSignal.com.

​

Excluindo namespaces

Se você criou um namespace que não está mais ativo, pode excluí-lo na tela de namespaces nas configurações do app.