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.
Les logs du navigateur sont suivis par défaut au niveau WARN pour les agents Pro et Pro+SPA, mais ne sont pas disponibles pour l'agent Lite browser. Nous vous recommandons de confirmer d'abord que vous utilisez l'agent browser Pro ou Pro + SPA.
Important
Certains paramètres, tels que l'activation ou la désactivation de la collecte des logs du navigateur et l'ajustement des taux d'échantillonnage ou de la verbosité des logs, sont des configurations côté serveur. Une fois que vous avez ajouté l'extrait de l'agent à vos pages, vous n'avez pas besoin de redéployer le script pour modifier ces paramètres. Cependant, les configurations côté serveur n'ont aucun effet si les fonctionnalités ne sont pas incluses dans le script déployé. Ceci s'applique à la version 1.259.0 ou ultérieure de l'agent browser.
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
Un agent browser Pro ou Pro + SPA :
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.
Assurez-vous que l'agent browser Pro ou Pro + SPA est sélectionné.
Basculez Automatically collect console logs sur ON pour collecter les messages envoyés à la console du navigateur.
Basculez Collect logs manually sur ON pour collecter les logs envoyés par programme via newrelic.log() ou 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.
Sélectionnez le niveau de verbosité des logs du navigateur souhaité. Le niveau de verbosité par défaut est défini sur WARN. Les niveaux parmi lesquels vous pouvez choisir :
ERROR- collecter les logs avec le niveauERRORWARN- collecter les logs avec le niveauWARNouERRORINFO- collecter les logs avec le niveauINFO,WARNouERRORDEBUG- collecter les logs avec le niveauDEBUG,INFO,WARNouERRORTRACE- collecter les logs avec le niveauTRACE,DEBUG,INFO,WARNouERRORImportant
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.
Basculez Automatically collect console logs et Collect logs manually sur 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.