Guide de migration de l'agent .NET 9.x vers 10.x

Ce guide décrit les principaux changements entre les versions 9.x et 10.x de l'agent .NET, les problèmes que vous pouvez rencontrer lors de la mise à niveau et comment migrer avec succès vers la version 9.x.

Les principaux changements incluent :

• L'agent .NET ne prend plus en charge le framework désigné comme en fin de vie
• Suppression du programme d'installation scriptable obsolète
• Suppression de l'instrumentation obsolète
• Consolidation des ressources d'installation Windows et changements de nom
• Changement de nom du package d'installation du programme Linux
• Numéro de version plus court dans les noms de fichiers du programme d'installation

L'agent .NET ne prend plus en charge le framework désigné comme en fin de vie

Microsoft a annoncé que .NET Framework 4.6.1 et inférieurs et .NET Core 3.0 et inférieurs ont atteint la fin du support. Le fait de désigner un ancien framework comme étant en fin de vie garantit que nous consacrons des ressources à l'amélioration des nouvelles versions de ces frameworks.

Il est recommandé aux clients de migrer leur application pour utiliser les versions framework prises en charge. Dans le cas où la migration framework n'est pas une option, les clients peuvent toujours instrumenter leur application avec l'agent.NET version 9.x.

Suppression du programme d'installation scriptable obsolète

À partir de la version 10.x, nous cesserons de fournir un programme d'installation scriptable à partir de notre site de téléchargement en raison d'une faible utilisation. Si vous utilisez le programme d'installation scriptable pour automatiser le agent installation processus .NET, envisagez d'utiliser le programme d'installation MSI avec des options de ligne de commande dans script votre ou de créer votre propre installation script avec l'archive zip de .NET agent à partir de notre site de téléchargement .

Suppression de l'instrumentation obsolète

À partir de la version 10.x, l'agent .NET arrête l'instrumenté Castle MonoRail. les clients peuvent toujours utiliser des versions plus anciennes de l'agent .NET pour instrumenter cette bibliothèque.

Consolidation des ressources d'installation Windows et changements de nom

Dans les versions précédentes, nous avons publié des archives ZIP distinctes pour installation manuelle des ressources agent pour .NET Framework et .NET Core/.NET 5+ sous Windows. Ceux-ci ont été consolidés dans une seule archive ZIP contenant à la fois les ressources .NET Framework et .NET Core/.NET 5+ agent pour manuelle Windows installation (les versions 64 bits et 32 bits sont toujours disponibles). Cela rend ces archives ZIP manuelles similaires au programme d'installation automatisé MSI existant qui installe à la fois les ressources .NET Framework et .NET Core/.NET 5+.

Nous avons également renommé les fichiers MSI et ZIP pour qu'ils aient tous le même nom de fichier de base : NewRelicDotNetAgent.

Tableau des noms des ressources d'installation de Windows 9.x et de leurs équivalents 10.x

Changement de nom du package d'installation du programme Linux

À partir de la version 10.x, le nom du package d'installation agent pour Linux passe de newrelic-netcore20-agent à newrelic-dotnet-agent. Nous pensons que le nom netcore20 a été source de confusion puisque nous avons pris en charge les versions de .NET Core supérieures à 2.0 au fur et à mesure de leur sortie, et à partir de la version 10.0 agent nous ne prenons plus en charge les versions de .NET Core antérieures à 3.1.

Les nouveaux packages newrelic-dotnet-agent sont marqués comme étant en conflit avec l'ancien package newrelic-netcore20-agent et comme le remplaçant (DEB) ou le rendant obsolète (RPM). Le gestionnaire de paquets de votre système ne permettra pas l'installation des deux en même temps.

Mise à niveau de newrelic-netcore20-agent vers newrelic-dotnet-agent

1. Pour des raisons de sécurité, vous devez effectuer une copie de sauvegarde de tous les fichiers dans /usr/local/newrelic-netcore20-agent avant de passer à l'étape suivante.

2. Fermez toute application .NET actuellement monitorée.

3. Suivez les instructions du gestionnaire de paquets approprié à votre système Linux :

   Mise à niveau avec apt (Debian, Linux Mint ou Ubuntu)

   1. Mettre à jour la liste package locaux :

      bash

      Copier

      $
      sudo apt update

   2. Mettre à niveau l'agent :

      bash

      Copier

      $
      sudo apt install newrelic-dotnet-agent

   Mise à niveau avec dpkg (Debian, Linux Mint ou Ubuntu)

   1. Accédez à download.newrelic.com/dot_net_agent/latest_release et copiez l'URL qui correspond à votre architecture et au dernier newrelic-dotnet-agent .deb package.

   2. Téléchargez le package avec wget, en remplaçant https://LINK_TO_PACKAGE par l'URL complète du package :

      bash

      Copier

      $
      wget -L https://LINK_TO_PACKAGE

   3. Mettez à niveau l'agent en remplaçant VERSION par la version actuelle :

      bash

      Copier

      $
      sudo dpkg -i newrelic-dotnet-agent_VERSION_ARCHITECTURE.deb

   Mise à niveau avec yum (CentOS, Oracle Linux ou RHEL)

   Important

   New Relic ne propose pas actuellement de package rpm Linux pour ARM64. Au lieu de cela, utilisez l'tarball pour l'installer sur ces plateformes.

   1. Mettre à niveau l'agent :

      bash

      Copier

      $
      sudo yum install newrelic-dotnet-agent

   Mise à niveau avec rpm (CentOS, Oracle Linux ou RHEL)

   Important

   New Relic ne propose pas actuellement de package rpm Linux pour ARM64. Au lieu de cela, utilisez l'tarball pour l'installer sur ces plateformes.

   1. Accédez à download.newrelic.com/dot_net_agent/latest_release, et copiez l'URL qui correspond à votre architecture et au dernier newrelic-dotnet-agent .rpm package.

   2. Téléchargez le package avec wget, en remplaçant https://LINK_TO_PACKAGE par l'URL complète du package :

      bash

      Copier

      $
      wget -L https://LINK_TO_PACKAGE

   3. Mettez à niveau l'agent en remplaçant VERSION par la version actuelle :

      bash

      Copier

      $
      sudo rpm -U newrelic-dotnet-agent_VERSION.x86_64.rpm

4. Mettre à jour les variables d’environnement de profilage. La configuration exacte que vous devez utiliser change en fonction de vos variables spécifiques.

   CORECLR_ENABLE_PROFILING="1"
   CORECLR_PROFILER="{36032161-FFC0-4B61-B559-F6C5D41BAE5A}"
   CORECLR_NEWRELIC_HOME="/usr/local/newrelic-dotnet-agent"
   CORECLR_PROFILER_PATH="/usr/local/newrelic-dotnet-agent/libNewRelicProfiler.so"

   Copier

5. Démarrez votre application et attendez que les données apparaissent.

Une fois que vous êtes convaincu que la migration est réussie, effectuez les étapes suivantes pour nettoyer les artefacts restants de l'installation newrelic-netcore20-agent précédente :

1. Si vous utilisez un système basé sur Debian (apt/dpkg) :

   bash

   Copier

   $
   sudo dpkg -P newrelic-netcore20-agent

2. Supprimer /usr/local/newrelic-netcore20-agent (s'applique aux scénarios basés sur Debian (apt/dpkg) et basés sur RPM (yum/rpm)) :

   bash

   Copier

   $
   sudo rm -rf /usr/local/newrelic-netcore20-agent

Numéros de version plus courts dans les noms de fichiers du programme d'installation

L'agent .NET de New Relic utilise le contrôle de version sémantique depuis la version 8.28.0 de l'agent. SemVer utilise trois numéros pour versionner une sortie : majeur, mineur et correctif. Cependant, les noms de fichiers de notre programme d'installation ont continué à utiliser quatre chiffres, le quatrième numéro de version étant toujours zéro. À l’avenir, nous supprimerons ce quatrième numéro dénué de sens et potentiellement déroutant des chaînes de version trouvées dans les noms de fichiers de notre programme d’installation. Cette modification s'applique aux fichiers d'installation des programmes Windows et Linux.