Detectar automáticamente los logs de browser
El logging automático recopila mensajes de log emitidos desde el browser console para ayudarlo a maximizar la observabilidad de su aplicación frontend.
Los logs del navegador se rastrean de forma predeterminada en el nivel WARN para los agentes Pro y Pro+SPA, pero no están disponibles para el agente Lite browser. Recomendamos que primero confirme que está utilizando el agente browser Pro o Pro + SPA.
Importante
Ciertas configuraciones, como la habilitación o deshabilitación de la recopilación de logs del navegador y el ajuste de las tasas de muestreo o la verbosidad de los logs, son configuraciones del lado del servidor. Una vez que agregas el fragmento del agente a tus páginas, no necesitas volver a implementar el script para cambiar estas configuraciones. Sin embargo, las configuraciones del lado del servidor no tienen efecto si la función no está incluida en el script implementado. Esto se aplica a la versión 1.259.0 o posterior del agente del navegador.
Cómo funciona el logging automático del browser
En función de los niveles de logging y las frecuencias de ejemplificación establecido en la configuración, la instrumentación automática de logs browser intentará recopilar mensajes de los siguientes métodos:
Método | Nivel |
|---|---|
console.log |
|
console.error |
|
console.warn |
|
console.info |
|
console.debug |
|
console.trace |
|
De forma predeterminada, los datos de logging se almacenan durante 30 días, pero la retención real de los datos depende de su cuenta.
Requisitos previos
Un agente browser Pro o Pro + SPA:
Versión del agente
Comportamiento de la configuración
1.283.0 - 1.305.0La configuración de la aplicación se aplica tanto a los logs de la consola como a los logs manuales
1.306.0y superiorLos logs de la consola y los logs manuales tienen configuraciones separadas para la verbosidad, el muestreo y los controles de habilitación/deshabilitación
Importante
La detección automática de logs no está disponible para el agente Lite del browser.
Habilitar la recopilación automática de log (para aplicaciones de navegador existentes)
Mejore la observabilidad y las capacidades de depuración de su aplicación siguiendo estas sencillas instrucciones de configuración.
Vaya a one.newrelic.com > All Capabilities > Browser.
Seleccione la aplicación de su browser .
En el menú de la izquierda, haga clic en Application settings.
Asegúrese de que esté seleccionado el agente browser Pro o Pro + SPA.
Activa Automatically collect console logs en ON para recopilar los mensajes enviados a la consola del navegador.
Activa Collect logs manually en ON para recopilar los logs enviados mediante programación a través de newrelic.log() o newrelic.wrapLogger().
Edite la frecuencia de ejemplificación para especificar el porcentaje de sesiones de usuario para recopilar logs. Puede introducir un valor entre 0 y 100.
Importante
La tasa de muestreo predeterminada para el logging del navegador se establece en el 100% de las sesiones de usuario. Puede establecer esta tasa de muestreo de sesión en cualquier valor entre 0% y 100%. Por ejemplo, establecer la tasa de muestreo de sesión en 50% dará como resultado la recopilación de eventos de log de aproximadamente la mitad de las sesiones de usuario seleccionadas aleatoriamente.
Seleccione el nivel de verbosidad del log del navegador deseado. El nivel de verbosidad predeterminado está configurado en WARN. Los niveles que puede elegir son:
ERROR- recopilar logs con nivelERRORWARN- recopilar logs con el nivelWARNoERRORINFO- recopilar logs con el nivelINFO,WARNoERRORDEBUG- recopilar logs con el nivelDEBUG,INFO,WARNoERRORTRACE- recopilar logs con el nivelTRACE,DEBUG,INFO,WARNoERRORImportante
Los datos que pasan a través de los métodos de consola pueden pasar por serialización y ofuscación. Dependiendo del tamaño y la frecuencia, esto puede afectar negativamente el rendimiento de la aplicación, así como los costos de datos. En general, NO se recomienda pasar objetos grandes o grandes cantidades de datos a los métodos de consola.
Deshabilitar los logs del browser
Para deshabilitar los logs del browser para una aplicación de browser existente:
Vaya a one.newrelic.com > All Capabilities > Browser.
Seleccione la aplicación de su browser .
En el menú de la izquierda, haga clic en Application settings.
Desactiva Automatically collect console logs y Collect logs manually en OFF.
Consumo de datos
Los logs siguen el mismo precio de consumo que los demás bytes de su browser . La cantidad de bytes producidos depende del número y la longitud de los mensajes.
La función de logging automático elimina la necesidad de llamar a newrelic.log la newrelic.wrapLogger browser API o, excepto cuando se agrega un atributo personalizado al evento de registro.