Code de l'agent proxy et données d'analyse

La définition d’une URL proxy pour l’agent du navigateur peut être un moyen précieux de garantir que les données d’observabilité sont toujours collectées à des fins de performances.

Lorsque vous utilisez la méthode proxy, il est important de vous assurer que vous avez le droit de le faire en fonction de toute obligation contractuelle, réglementaire ou autre obligation légale que vous pourriez avoir envers votre utilisateur final et/ou les visiteurs du site. Si vous avez vérifié que cette méthode est une solution viable et conforme pour votre organisation, vous pouvez consulter les instructions de configuration ci-dessous.

Comment ça marche

À partir de la version 1.240.0 de l'agent de navigateur et des versions ultérieures, vous pouvez configurer deux types de proxys différents, selon le type de données que vous souhaitez transmettre : un proxy pour récupérer le code de l'agent de navigateur et un proxy pour transmettre les données d'analyse à New Relic.

Pour configurer ces proxys, vous devez configurer les propriétés d'agent de navigateur suivantes :

• init.proxy.assets détermine où récupérer l'agent du navigateur.

  • Si vous utilisez la méthode d'installation copier/coller, vous devrez modifier manuellement votre snippet JavaScript et définir assets sur l'URL de votre domaine.
  • Par exemple, si vous utilisez l'agent de navigateur v1.240.0 Pro+SPA, et vous définissez init.proxy.assets sur assets.mydomain.com, l'agent du navigateur sera chargé à partir de https://assets.mydomain.com/nr-spa.<hash>-1.240.0.min.js au lieu de https://js-agent.newrelic.com/nr-spa.<hash>-1.240.0.min.js.
  • Si vous utilisez la méthode d’installation NPM, cette configuration n’est pas pertinente. Les agents de navigateur installés par NPM subissent le même processus de regroupement que l'application hôte et doivent générer des ressources d'agent dans le répertoire output à côté de l'application hôte. Lorsque l'application hôte est déployée, ces ressources d'agent doivent également être déployées, ce qui entraîne le chargement du code de l'agent à partir du même domaine que le site.

• init.proxy.beacon détermine où les données d'analyse sont envoyées.

  • Pour les deux méthodes d'installation, vous devrez définir beacon sur l'URL de votre domaine.
  • Par exemple, si vous définissez beacon sur beacon.mydomain.com, toutes les données d’observabilité seront envoyées à https://beacon.mydomain.com/OBSERVABILITY_ENDPOINT.

Si vous êtes préoccupé par la confidentialité des utilisateurs, vous pouvez exclure l'en-tête X-Forwarded-For HTTP, qui est utilisé pour géolocaliser les clients. Si vous l'excluez, New Relic géolocalisera votre proxy en tant que client à la place.

Démarrer

Pour commencer à rediriger requests vers votre proxy, consultez les instructions ci-dessous en fonction de la méthode de déploiement que vous avez utilisée pour installer l'agent de navigateur.

Recommandations

Lors de la configuration de ces propriétés, nous recommandons ce qui suit :

• Utilisez un sous-domaine propriétaire. Même si vous pouvez techniquement utiliser un autre domaine tiers, il est probable qu'il soit bloqué par les bloqueurs de publicités et les VPN de sécurité.
• Le modèle d’entrée est <domain>[:<port>][/<path>]. Assurez-vous d'omettre le protocole (comme https://) et toute barre oblique de fin. Les port et path sont facultatifs et seront respectés s'ils sont ajoutés.
• Si vous configurez à la fois assets et beacon, définissez des valeurs différentes pour chaque proxy en utilisant des sous-domaines différents ou des chemins différents. Cela rendra la configuration du serveur proxy beaucoup plus facile.

Installation par copier/coller

Si vous utilisez la méthode d'installation copier/coller, ajoutez la configuration suivante à la configuration JavaScript de votre navigateur avant le chargeur d'agent :

window.NREUM.init = {
    ...<other init properties>,
    proxy: {
        assets: <URL string>
        beacon: <URL string>
    }
}

Installation de NPM

Si vous utilisez la méthode d'installation du navigateur NPM, ajoutez la configuration suivante lors de l'initialisation de l'agent du navigateur :

new BrowserAgent({ 
  init: {
    ...<other init properties>,
    proxy: {
        beacon: <URL string>
    }
  }
})

Utilisation de proxys

New Relic ne fournit ni ne prend en charge un service proxy cloud, vous devez donc configurer et gérer vos propres serveurs proxy. Pour garantir une fonctionnalité complète, nous émettons les hypothèses suivantes concernant vos proxys :

• Load the browser agent code from the New Relic CDN and pass it back to the client. Si vous utilisez le champ assets, votre proxy doit charger le code de l'agent du navigateur à partir de https://js-agent.newrelic.com/ et le renvoyer au client. Par exemple, pour l'agent de navigateur v1.240.0, requests adressées à https://assets.mydomain.com/nr-spa.3b61d78f-1.240.0.min.js devraient produire la même réponse que celles adressées à https://js-agent.newrelic.com/nr-spa.3b61d78f-1.240.0.min.js en amont.
• Forward client payloads to New Relic. Le proxy beacon transmet les frais du client à New Relic. Votre point de terminaison d'origine peut être trouvé dans la page des paramètres de votre application de navigateur. Dans le snippet JavaScript, recherchez ;NREUM.info={beacon:"_____",.... Pour la plupart des applications, ce serait (https://)bam.nr-data.net. Toutefois, cela pourrait être différent pour des raisons de conformité et juridiques. Par exemple, requests adressées à https://yourproxy.com/1/asdf?a=123 doivent être transmises à https://bam.nr-data.net/1/asdf?a=123.
• Do not modify requests and responses. Les requêtes et réponses via le serveur proxy ne doivent pas être modifiées.
• Support the bandwidth and traffic generated by observability data collection. Votre système doit être capable de prendre en charge la charge de proxy, mais la quantité de données générées dépendra de l'utilisation de votre site.