Détecter automatiquement le log du navigateur
Le logging automatique collecte les messages de log émis par le navigateur console pour vous aider à maximiser l'observabilité de vos applications frontales.
Browser logs are tracked by default at the WARN level for Pro and Pro+SPA agents, but unavailable for the Lite browser agent. We recommend that you first confirm you're using the Pro or Pro + SPA browser agent.
Important
Certain settings, such as enabling or disabling browser log collection and adjusting sample rates or log verbosity, are server-side configurations. Once you add the agent snippet to your pages, you don't need to redeploy the script to change these settings. However, server-side configurations have no effect if the feature aren't included in the deployed script. This applies to browser agent version 1.259.0 or later.
Comment fonctionne le logging automatique du navigateur
En fonction des niveaux de logging et des taux d'échantillonnage définis dans la configuration, auto-instrumentation du log du navigateur tentera de collecter des messages à partir des méthodes suivantes :
Méthode | Niveau |
|---|---|
console.log |
|
console.error |
|
console.warn |
|
console.info |
|
console.debug |
|
console.trace |
|
Par défaut, les données de logging sont stockées pendant 30 jours, mais la conservation réelle des données dépend de votre compte.
Prérequis
A Pro or Pro + SPA browser agent:
Version de l'agent
Comportement de la configuration
1.283.0 - 1.305.0Les paramètres de l'application sont appliqués aux logs de la console et aux logs manuels.
1.306.0et supérieurLes logs de la console et les logs manuels ont des paramètres distincts pour la verbosité, l'échantillonnage et les contrôles d'activation/désactivation
Important
La détection automatique log n'est pas disponible pour l'agent de navigateur Lite .
Activer la collecte automatique des logs (Pour les applications de navigateur existantes)
Améliorez l'observabilité et les capacités de débogage de votre application en suivant ces instructions de configuration simples.
Accédez à one.newrelic.com > All Capabilities > Browser.
Sélectionnez votre application de navigateur.
Dans le menu de gauche, cliquez sur Paramètres de l’application.
Ensure the Pro or Pro + SPA browser agent is selected.
Toggle Automatically collect console logs to ON to collect messages sent to the browser's console.
Toggle Collect logs manually to ON to collect logs sent programatically via newrelic.log() or newrelic.wrapLogger().
Modifiez le taux d'échantillonnage pour spécifier le pourcentage de sessions utilisateur pour collecter les logs. Vous pouvez saisir une valeur comprise entre 0 et 100.
Important
Le taux d'échantillonnage par défaut pour le logging du navigateur est défini sur 100 % des sessions utilisateur. Vous pouvez définir ce taux d'échantillonnage de session entre 0% et 100%. Par exemple, définir le taux d'échantillonnage de session sur 50% entraînera la collecte d'événements de log à partir d'environ la moitié des sessions utilisateur sélectionnées aléatoirement.
Select the desired browser log verbosity level. The default verbosity level is set to WARN. The levels you can choose from:
ERROR- collect logs withERRORlevelWARN- collect logs withWARNorERRORlevelINFO- collect logs withINFO,WARN, orERRORlevelDEBUG- collect logs withDEBUG,INFO,WARN, orERRORlevelTRACE- collect logs withTRACE,DEBUG,INFO,WARN, orERRORlevelImportant
Les données transmises via les méthodes de la console peuvent passer par la sérialisation et obfuscation. Selon la taille et la fréquence, cela peut avoir un impact négatif sur les performances des applications ainsi que sur les coûts des données. En général, il n'est PAS recommandé de transmettre de gros objets ou de grandes quantités de données dans les méthodes de la console.
Désactiver le log du navigateur
Pour désactiver le log du navigateur pour une application de navigateur existante :
Accédez à one.newrelic.com > All Capabilities > Browser.
Sélectionnez votre application de navigateur.
Dans le menu de gauche, cliquez sur Paramètres de l’application.
Toggle Automatically collect console logs and Collect logs manually to OFF.
Consommation de données
Les logs suivent les mêmes tarifs de consommation que les autres octets de votre navigateur. La quantité d'octets produits dépend du nombre et de la longueur des messages.
La fonctionnalité de logging automatique élimine le besoin d'appeler les API de navigateur newrelic.log ou newrelic.wrapLogger, sauf lors de l'ajout d'un attribut personnalisé à l'événement de logging.