Cette traduction automatique est fournie pour votre commodité.
En cas d'incohérence entre la version anglaise et la version traduite, la version anglaise prévaudra. Veuillez visiter cette page pour plus d'informations.
Reportez-vous aux notes de sortie pour trouver la dernière version de l'agent.
Vérifiez la version de l'agent .NET que vous avez actuellement installé en utilisant Windows Programs and Features ou en utilisant votre gestionnaire de paquets Linux.
Avant de commencer
Il existe plusieurs façons d’installer l’agent .NET, ce qui signifie qu’il existe plusieurs façons de le mettre à jour. Dans ce document, nous nous concentrons sur les procédures de mise à jour pour l'installation la plus simple, avec l'agent .NET installé directement sur un hôte Windows ou Linux.
Si vous avez d'autres installations, consultez ces documents d'installation pour ces configurations pour plus de contexte :
La mise à jour de l’agent nécessite des droits Administrator dans votre groupe d’administrateurs Windows. Pour plus d'informations, consultez la documentation sur les autorisations.
Si la agent version de votre est inférieure à 7.0 ou si vous utilisez .NET Framework version 4.0 ou inférieure, consultez Mettre legacy à jour .NET agent.
Si votre application est hébergée dans IIS, assurez-vous de stop IIS avant de mettre à jour l'agent .NET.
Une fois le package d’installation terminé, démarrez IIS.
Pour mettre à jour l'agent .NET pour une application Web Azure à l'aide de l'extension de site Azure New Relic, suivez les instructions d'installation pour :
Supprimez l'extension de site New Relic Azure, cela désinstalle l'agent
Réinstallez la dernière version de l’extension de site New Relic Azure à l’aide de ces instructions d’installation, qui installent la dernière version de l’agent.
Redémarrez l'application Web pour démarrer l'agent mis à jour.
Mettre à jour l'agent .NET (Linux)
Important
Pour les versions d’agent .NET 10.0.0 ou supérieures, le nom du package est newrelic-dotnet-agent. Pour les versions d’agent .NET 9.9.0 ou inférieures, le nom du package est newrelic-netcore20-agent. Le reste de ce document fait référence à newrelic-dotnet-agent; remplacez-le par l'ancien nom si vous avez installé une ancienne version de l'agent. Lorsque vous effectuez une mise à jour vers la version 10.0.0 ou supérieure à partir d'une version inférieure, vous devrez modifier les variables d'environnement CORECLR_NEWRELIC_HOME et CORECLR_PROFILER_PATH en raison du changement de nom du package.
Utilisez l’une des méthodes suivantes pour mettre à jour vers la dernière version de l’agent .NET de New Relic :
Installez le fichier dans votre emplacement d’installation préféré. Pour le fichier tar.gz : extrayez le fichier zip au-dessus de vos fichiers existants.
Démarrez votre/vos application(s).
Fermez votre/vos application(s).
Utilisez ce qui suit pour mettre à jour l’agent :
bash
$
sudo yum update newrelic-dotnet-agent
Démarrez votre/vos application(s).
Fermez votre/vos application(s).
Utilisez ce qui suit pour obtenir une liste des mises à jour disponibles et les installer :
Mettre à jour l'ancien agent .NET Framework (inférieur à 7.0)
Si vous envisagez de mettre à jour une version agent .NET Framework inférieure à 7.0, consultez les notes suivantes. Pour voir la version de l'agent dont vous disposez, voir Vérifier la version de l'agent. Pour une liste complète des modifications apportées agent , consultez les notes de sortie .NET.
Important
Pour instrumenter une application ciblant .NET Framework 4.0 ou une version antérieure, vous devez utiliser une version de l'agent .NET Framework antérieure à 7.0. Consultez la prise en charge de .NET Frameworks 4.0 ou version antérieure pour plus d’informations.
Si la version est inférieure à...
Fais ceci...
7.0
La version 7.0 et supérieure de l'agent .NET Framework prend en charge les applications qui ciblent .NET Framework 4.5 ou supérieur.
6.12
Les versions 6.12 ou supérieures ne prennent pas en charge Windows Server 2003. Si vous avez besoin de Windows Server 2003, utilisez les versions 6.11 ou inférieures. Pour plus d'informations, obtenez de l'aide sur support.newrelic.com ou téléchargez l'agent.
6.11
Auparavant, la base de données et les appels externes qui se produisaient en dehors d'une transaction généraient des métriques que vous pouviez afficher dans leurs pages respectives dans l'UI APM. Désormais, ces métriques ne seront plus affichées. Dans une application non Web, ces appels peuvent être « encapsulés » dans une transaction personnalisée pour pouvoir afficher leurs métriques.
6.0
Pour obtenir une prise en charge asynchrone si la version de votre agent .NET est antérieure à 6.0, procédez comme suit :
Supprimez le paramètre d'application suivant dans newrelic.config s'il existe :
<appSettings>
<addkey="AsyncMode"value="false"/>
</appSettings>
Assurez-vous que l'hôte de votre application dispose de .NET 4.5 ou supérieur installé.
Dites à .NET d’utiliser le nouveau pipeline de traitement des requêtes ASP en ajoutant les lignes suivantes à votre web.config:
Les métriques qui ne font pas partie d'une transaction ne seront pas affichées dans l'UI. Exception: Vous pouvez afficher la base de données et les métriques externes sur leurs pages respectives dans l'UI APM. D'autres métriques de ce type (telles que les méthodes instrumentées) peuvent être rendues visibles en les « enveloppant » dans une transaction personnalisée.
New Relic a amélioré le nom des transactions. Cependant, ces modifications peuvent affecter les noms de transaction des métriques existantes, notamment les métriques transaction clé, "alerte on any" et les requêtes basées sur les noms de transactions. Vous devez recréer ces paramètres en utilisant le nouveau nom de transaction après la mise à jour.
4.2
New Relic a supprimé la transaction HTTP « externe » (transactions « .svc») pour l'application WCF hébergée avec le mode de compatibilité asp.net désactivé. Désormais, seule la transaction WCF est signalée.
Ce changement permet d’obtenir des données de débit plus précises. Il empêche également que des erreurs de code d'état HTTP soient signalées pour les transactions WCF ayant échoué.
4.1
New Relic a implémenté des métriques datastore pour la trace SQL. les noms de mesures pour l'activité de la base de données ont été mis à jour pour être signalés sous datastore.
4.0
L'application MVC2 ne génère plus de segments spécifiques à MVC ni de noms de transaction basés sur l'itinéraire MVC.
3.0
L'agent .NET de New Relic est devenu dépendant de .NET 3.5. Votre application peut toujours cibler .NET 2.0, mais vous devez avoir .NET 3.5 installé sur l’ordinateur sur lequel l’ agent s’exécute.
2.20
La version 2.19.3.0 était la dernière version agent .NET qui nécessitait à la fois l'appel d'API GetBrowserTimingFooter() et GetBrowserTimingHeader() pour . Dans la version d'agent 2.20.24.0 ou supérieure, il vous suffit d'appeler GetBrowserTimingHeader(). GetBrowserTimingFooter() n'a aucun effet. Recommandation : supprimez ces références de votre code.
2.9
Le fichier de configuration est passé de newrelic.xml à newrelic.config. programme d'installation pour un agent plus récent tente de convertir newrelic.xml (si présent) en newrelic.config.
2.2 ou version antérieure
Pour effectuer une mise à jour à partir d’une version d’agent .NET inférieure à 2.2, vous devez désinstaller l’ancien agent avant d’installer la nouvelle version. Suivez les procédures standard de votre version de Windows pour désinstaller l'agent. Votre système d’exploitation peut nécessiter un redémarrage.
Vous pouvez rencontrer des erreurs cocreateinstance avec services.exe lorsque vous mettez à jour un ancien programme d'installation (2.1.3.494 ou inférieur) ou apportez d'autres modifications aux variables d'environnement. Pour résoudre ce problème, reportez-vous à la documentation de Microsoft.