Configurez les événements AjaxRequest

Dans la version 1211 de l’agent ou supérieure, toutes les requests réseau effectuées par une page sont enregistrées en tant qu’événements AjaxRequest. Vous pouvez configurer quelles requests sont enregistrées et quelles données sont capturées :

• Liste de refus: filtrez les domaines et URL qui sont exclus du suivi AJAX
• Capture de charge: enregistrez les données complètes de requête et de réponse pour déboguer les échecs

Liste de refus

Par défaut, nous enregistrons les événements AjaxRequest pour toutes les requêtes réseau effectuées par votre application.

• Pour arrêter l'enregistrement de tous les événements, ajoutez un caractère générique * (astérisque).
  • Exemple: *
• Pour arrêter l'enregistrement des événements pour un site complet, ajoutez le nom de domaine.
  • Exemple: mywebsite.com
• Pour arrêter l'enregistrement des événements pour une page spécifique, ajoutez le domaine et le chemin d'accès.
  • Exemple: mywebsite.com/photos
• À partir de la version 1.307.0 de l'agent, partout où nous trouvons un * (astérisque), nous ferons correspondre n'importe quelle longueur de chaîne.
  • Exemple : mywebsite.com/shop/* (pour un chemin), *.mywebsite.com (pour un sous-domaine), mywebsite.com/*/shop/*/checkout (pour les chaînes de milieu d'URL).

Le protocole, le port, la recherche et le hachage d’une URL sont ignorés par la liste de refus.

Accéder à la liste de refus

Pour mettre à jour la liste de refus des URL que votre application filtrera pour empêcher la création d'événements, accédez à la page des paramètres de l'application :

1. Allez à one.newrelic.com > All capabilities > Browser > (select an app) > Settings > Application settings.
2. Sous la section AJAX data capture settings, dans le champ Deny list, ajoutez les filtres que vous souhaitez appliquer à votre application.
3. Sélectionnez Save pour mettre à jour la configuration de l'agent.
4. Redéployez l'agent du navigateur (en redémarrant l'agent APMassocié ou en mettant à jour l'installation du navigateur par copier/coller).

Valider les filtres de la liste de refus

Pour valider si les filtres que vous avez ajoutés fonctionnent comme prévu, exécutez une requête NRQL pour AjaxRequest événement correspondant à votre filtre.

FROM AjaxRequest SELECT * WHERE requestUrl LIKE '%example.com%'

Données de capture de charge

Vous pouvez activer la capture de charge pour toutes les requests ou uniquement pour les requests ayant échoué. Lorsqu’il est activé, l’agent Browser capture la charge de la request et de la réponse pour tous les appels AJAX pour tous les domaines autorisés. Cela est utile pour déboguer les échecs qui ne sont pas visibles à partir des métadonnées seules, tels que les erreurs cachées dans les corps de réponse.

Lorsque vous activez la capture de charge AJAX, l’agent Browser ajoute les attributs suivants aux événements AjaxRequest :

• requestBody: la charge de la requête.
• requestHeaders: en-têtes de requête au format JSON.
• requestQuery: les paramètres de requête d’URL au format JSON.
• responseBody: la charge de la réponse.
• responseHeaders: en-têtes de réponse au format JSON.
• ajaxRequest.id: identifiant unique pour chaque requête AJAX.

Tous les attributs de données de charge sont tronqués à 4096 octets. Lorsqu’une troncature se produit, les 4 derniers octets sont remplacés par ... pour indiquer que le contenu a été coupé.

Activer la capture de charge

Vous pouvez activer la capture de charge à l'aide de l'une des méthodes suivantes :

window.NREUM.init = {
    ...<other init properties>...,
    ajax: {
      deny_list: ["bam.nr-data.net"],
      capture_payloads: 'failures' // or 'none', 'all'
    }
}

import { BrowserAgent } from '@newrelic/browser-agent/loaders/browser-agent'

const options = {
  init: {
    ...<other init properties>...,
    ajax: {
      deny_list: ["bam.nr-data.net"],
      capture_payloads: 'failures' // or 'none', 'all'
    }
  },
  info: { ... },
  loader_config: { ... }
}

new BrowserAgent(options)

Lorsque vous activez la capture de charge pour la première fois, New Relic ajoute automatiquement des règles d’obfuscation de base de référence pour protéger les données sensibles courantes :

• Numéros de carte de crédit: détecte et masque les principaux formats de carte de crédit (Visa, MasterCard, American Express, Discover, etc.)
• Numéros de sécurité sociale: détecte et masque les modèles de SSN

Vous pouvez configurer des règles d’obfuscation dans la plateforme New Relic pour masquer les données sensibles avant qu’elles ne soient envoyées à New Relic. Pour plus de détails sur les règles d’obfuscation, consultez Obfusquer les données de l’agent Browser.

Après avoir activé le paramètre de capture de charge, vous pouvez afficher les données de charge capturées sur les pages suivantes :

• Détails de la requête AJAX
• Affichage de la page
• Session Replay

Comment la capture de charge interagit avec la liste de refus

La capture de charge respecte votre liste de refus existante. Pour toute requête AJAX :

• Si l'URL figure sur la liste de refus, l'événement est entièrement ignoré et aucune métadonnée ou charge n'est capturée.
• Si l'URL ne figure pas sur la liste de refus, en fonction de vos paramètres de capture de charge, l'agent capture les charges de requête et de réponse et applique des règles d'obfuscation avant d'envoyer les données à New Relic.

Documentation associée