A lista a seguir inclui todas as opções de configuração com o nome da variável de ambiente e o nome da chave no arquivo de configuração.
Para mais informações sobre como configurar o AppSignal com um arquivo de configuração, consulte o tópico Configuração.
key
Esta opção de configuração é obrigatória para enviar dados ao AppSignal. Se esta
opção de configuração não for definida, o AppSignal para JavaScript será executado em
modo de desenvolvimento, e nenhum dado será enviado ao AppSignal.
A chave da API de monitoramento de erros de front-end da sua aplicação. Você pode encontrar essa chave de API em “Front-end error monitoring” na seção “Push & Deploy” das configurações da sua aplicação.
Esta não é a mesma chave de API no nível da organização ou da aplicação, que é usada para monitoramento em nossas integrações de back-end.
namespace
- Tipo:
string
- Valor padrão:
"frontend"
O namespace padrão a ser usado para relatar erros ao AppSignal. Saiba mais no nosso guia de namespaces.
revision
Define a revisão da aplicação para a versão atualmente em execução do seu app. Isso é usado para criar marcadores de deploy e marcar todos os dados recebidos como pertencentes a um deploy específico. Saiba mais no nosso guia de marcadores de deploy.
ignoreErrors
Um array de expressões regulares para verificar em relação à propriedade message de qualquer erro relatado ao AppSignal. Se qualquer uma das expressões regulares corresponder, o erro será ignorado. Saiba mais no nosso guia de como ignorar erros.
matchBacktracePaths
Esta opção de configuração é útil ao desenvolver aplicações para ambientes desktop e
mobile, ou ao implantar o mesmo ambiente de aplicação em múltiplos domínios.
A maioria das aplicações não precisará usar esta opção de configuração.Usar esta opção de configuração quebrará a detecção pública de
sourcemaps. Para usar esta
opção de configuração com uma base de código com sourcemaps, você deve fazer upload de
sourcemaps privados para sua aplicação.Esta opção de configuração é experimental e pode mudar em versões futuras.
Um array de expressões regulares com um ou mais grupos de captura. Essas expressões regulares serão verificadas contra os caminhos das linhas de backtrace dos erros relatados ao AppSignal. Se qualquer uma das expressões regulares corresponder com um ou mais grupos de captura não vazios, o caminho na linha de backtrace é substituído pelo resultado da concatenação dos grupos de captura.
Isso é útil quando o caminho onde sua aplicação é implantada não é conhecido antecipadamente. Por exemplo, o caminho para uma
aplicação Electron pode ser diferente na máquina de cada usuário. Você pode buscar pela parte desse caminho que é conhecida por representar
sua aplicação.
Por exemplo, se o código-fonte da sua aplicação estiver localizado em um caminho como o seguinte, onde ${USERNAME} muda para cada usuário:
/Users/${USERNAME}/Applications/MyApp.app/Contents/Resources/bundle/app.js`
Então você pode usar esta opção de configuração da seguinte forma:
const appsignal = new Appsignal({
// ... other configuration options ...
matchBacktracePaths: [new RegExp("MyApp.app/Contents/Resources/(.*)")],
});
Quando um erro for relatado, os caminhos das linhas de backtrace serão substituídos pelo resultado do grupo de captura, que neste exemplo será bundle/app.js.
Isso garante que os erros relatados ao AppSignal sejam agrupados corretamente ao usar o agrupamento por linha de backtrace e permite que sourcemaps privados sejam enviados para o caminho limpo.