Avec l'agent .NET, vous pouvez ajouter une instrumentation à vos pages Web. Avant d'utiliser le navigateur avec votre agent.NET, reportez-vous aux notes de sortie agent .NET et assurez-vous d'avoir installé la dernière sortie agent .NET.
Suivez les exigences agent .NET pour installer monitoring des navigateurs. Suivez ensuite les procédures décrites dans ce document pour instrumenter manuellement l’ agent.NET.
autoinstrumentation
Important
L'auto-instrumentation n'est disponible que pour les applications Web .NET Framework et .NET Core v6.0 et versions ultérieures. l'auto-instrumentation n'est pas disponible pour les applications ASP.NET Core v5.0 et antérieures, même si elles sont monitorées par l'agent.NET.
Avec auto-instrumentation du navigateur, l'agent .NET injecte automatiquement l'en-tête JavaScript du navigateur dans toute page qui a un content-type de text/html et qui a également une tag <head> dans la page. auto-instrumentationdu navigateur est activée par défaut pour les applications Web .NET Framework, mais est désactivée par défaut pour les applications Web .NET Core v6 et versions ultérieures. Pour plus d’informations, consultez Activation de l’auto-instrumentation du navigateur pour .NET Core v6+ .
La recherche tag <head> commence au début du DOM. L'agent .NET injecte l'en-tête JavaScript via l'ajout d'un HttpModule qui modifie la page à l'aide de filtres de réponse HTTP avant de diffuser le contenu à l'utilisateur.
La première fois que vous activez l'auto-instrumentation, vous devrez peut-être nettoyer votre répertoire de cache asp.net afin que les pages aspx soient recompilées. Utilisez la commande suivante :
$flush_dotnet_temp.cmdAvec cette injection, les pages précédemment fonctionnelles peuvent cesser de fonctionner si un content-type n'est pas défini correctement. Pour corriger, réviser et mettre à jour le content-types dans votre application ou désactiver l'auto-instrumentation.
instrumentation manuelle via API d'agent
Si vous ne pouvez pas activer l’instrumentation automatique, vous pouvez toujours inclure l’agent de navigateur manuellement en utilisant l’API de l’agent .NET de New Relicvet en incluant le code approprié dans vos pages.
Pour télécharger le
NewRelic.Api.Agent.dll, relancez l'installation et référencez le.dll:- Dans le répertoire de l’agent .NET de New Relic, sélectionnez la section de l’agent New Relic.Net , puis sélectionnez API Assembly.
- NuGet : installez et référencez le .dll en exécutant
Install-package NewRelic.Agent.Api.
Pour configurer votre application Web afin d’appeler l’API de l’agent .NET de New Relic, ajoutez une référence à
NewRelic.Api.Agent.dllà votre projet.Facultatif : si vous modifiez le répertoire application déployé sur le serveur Web, copiez
NewRelic.Api.Agent.dlldans le répertoirebinde l'application.Appelez l'API dans votre tag
<head>. Si unetag méta avec l'attributX-UA-COMPATIBLE http-equivexiste, définissez-la après cette tag méta.
instrumentation manuelle avec copier/coller
Lorsque vous activez monitoring des navigateurs, vous pouvez insérer manuellement le snippet JavaScript dans les pages Web de votre application. L'option copier/coller vous donne le contrôle sur le placement exact de notre snippet JavaScript, qui est nécessaire pour monitorer les performances de la page Web. Pour obtenir des instructions sur l'activation de monitoring des navigateurs avec copier/coller, reportez-vous à notre documentation de navigateur.
Désactiver l'instrumentation
Pour désactiver l’instrumentation :
Dépannage
Suivez les procédures de dépannage si vous ne parvenez pas à afficher les données de synchronisation du navigateur.
Activer auto-instrumentation du navigateur pour l'application Web .NET Core v6+
Pour activer l'auto-instrumentation du navigateur dans les applications Web .NET Core v6+ (nécessite l'agent .NET v10.19.2 ou version ultérieure) :
Assurez-vous d'avoir activé auto-instrumentation globalement en modifiant
newrelic.configet en définissant l'indicateurbrowserMonitoringautoInstrumentsurtrue:<!-- enable auto instrumentation globally --><browserMonitoring autoInstrument="true"/>Activez l'auto-instrumentation pour les applications Web .NET Core 6+ en modifiant
newrelic.configet en ajoutant un nouvel élément dans la sectionappSettings(ou ajoutez la sectionappSettingssi elle n'existe pas) - Notez que ce n'est pas la même chose que la sectionappSettingsdans un fichierweb.config:<!-- enable .NET Core 6+ instrumentation --><appSettings><add key="EnableAspNetCore6PlusBrowserInjection" value="true" /></appSettings>
Nous vous recommandons de tester soigneusement cette fonctionnalité dans un environnement hors production pour garantir la compatibilité avec votre application Web. Si vous rencontrez des problèmes avec cette fonctionnalité, veuillez nous contacter pour obtenir de l'aide.