Detectar automaticamente os logs do browser
O logging automático coleta mensagens de log emitidas pelo browser console para ajudar você a maximizar a observabilidade do seu aplicativo frontend.
Os logs Browser são rastreados por padrão no nível WARN para o agente Pro e Pro+SPA, mas não estão disponíveis para o browser do agente Lite . Recomendamos que você primeiro confirme que está usando o Pro or Pro+SPA agent.
Como funciona o logging automático do Browser
Com base nos níveis de logging e nas taxas de amostragem definidas na configuração, a instrumentação automática dos logs do browser tentará coletar mensagens dos seguintes métodos:
Método | Nível |
|---|---|
console.log |
|
console.error |
|
console.warn |
|
console.info |
|
console.debug |
|
console.trace |
|
Por padrão, os dados de logging são armazenados por 30 dias, mas a retenção real de dados depende da sua conta.
Pré-requisitos
- Um browser de agente Pro ou Pro + SPA
Importante
A detecção automática de log não está disponível para o browser Lite Agent.
Habilitar coleta automática de logs (para aplicativos Browser existentes)
Melhore a observabilidade e os recursos de depuração do seu aplicativo seguindo estas instruções simples de configuração.
Acesse one.newrelic.com > All Capabilities > Browser.
Selecione seu aplicativo de browser.
No menu à esquerda, clique em Application settings.
Certifique-se de que o browser do agente Pro ou Pro + SPA esteja selecionado.
Alterne Browser Logs para ON.
Alterne o nível de verbosidade necessário para ON. Você pode escolher entre:
Erro
Avisar
Informações
Depurar
Trace
Importante
Os dados passados pelos métodos do console podem passar por serialização e ofuscação. Dependendo do tamanho e da frequência, isso pode impactar negativamente o desempenho do aplicativo, bem como os custos de dados. Em geral, NÃO é recomendado passar objetos grandes ou grandes quantidades de dados para métodos de console.
Edite a taxa de amostragem para especificar a porcentagem de sessões de usuário para as quais os logs serão coletados. Você pode inserir um valor entre 0 e 100.
Importante
A amostragem de logs é coordenada com outras decisões de amostragem para maximizar a coleta de dados para a mesma sessão. Por exemplo, se você definir a taxa de amostragem de logs como 5% e a taxa de amostragem do Session Replay (SR) como 10%, então:
- Aproximadamente 5% das suas sessões terão Logs e SR coletados.
- Aproximadamente 5% das suas sessões terão apenas dados de SR coletados.
- As sessões restantes não terão nenhuma delas.
Para qualquer novo aplicativo de browser que você criar, a coleta automática de logs é habilitada por padrão com um nível de verbosidade de aviso e uma taxa de amostragem de 100%.
Desativar logs do browser
Para desabilitar os logs do browser para um aplicativo de browser existente:
Acesse one.newrelic.com > All Capabilities > Browser.
Selecione seu aplicativo de browser.
No menu à esquerda, clique em Application settings.
Alterne Browser Logs para OFF.
Consumo de dados
Os logs seguem o mesmo preço de consumo dos outros bytes do seu browser. A quantidade de bytes produzidos depende da contagem e do comprimento das mensagens.
O recurso de logging automático elimina a necessidade de chamar a API do browser newrelic.log ou newrelic.wrapLogger, exceto ao adicionar atributo personalizado ao registro de evento.