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 browser, l'agent .NET injecte automatiquement l'en-tête JavaScript du browser dans toute page qui a un content-type de text/html et qui a également une tag <head> dans la page. Auto-instrumentation Browser est activée par défaut.
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, des pages qui fonctionnaient auparavant peuvent cesser de fonctionner si un content-type n'est pas défini correctement. Pour corriger, examinez et mettez à jour le content-types dans votre application ou désactivez 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.