Guía de migración del agente .NET 9.x a 10.x

Esta guía describe los principales cambios entre las versiones 9.x y 10.x del agente .NET, los problemas que puede encontrar durante la actualización y cómo migrar exitosamente a la versión 9.x.

Los principales cambios incluyen:

• El agente .NET ya no admite el marco designado como final de vida útil
• Eliminación del instalador scriptable obsoleto
• Eliminación de instrumentación obsoleta
• Consolidación de activos de instalación de Windows y cambios de nombre
• Cambio de nombre de los paquetes del instalador de Linux
• Número de versión más corto en los nombres de archivos del instalador

El agente .NET ya no admite el marco designado como final de vida útil

Microsoft anunció que .NET Framework 4.6.1 y versiones anteriores y .NET Core 3.0 y versiones anteriores han llegado al final del soporte. Designar el marco antiguo como al final de su vida útil garantiza que estemos dedicando recursos a mejorar las versiones más nuevas de ese marco.

Se recomienda que los clientes migren su aplicación para utilizar las versiones de framework compatibles. En el caso de que la migración framework no sea una opción, los clientes aún pueden instrumentar su aplicación con el agente .NET versión 9.x.

Eliminación del instalador de secuencias de comandos obsoleto

A partir de v10.x, dejaremos de proporcionar un instalador programable desde nuestro sitio de descarga debido al bajo uso. Si utiliza el instalador programable para automatizar el proceso de instalación del agente .NET, considere usar el instalador MSI con opciones de línea de comando en su script o crear su propio script de instalación con el archivo zip del agente .NET desde nuestro sitio de descarga en el futuro.

Eliminación de instrumentación obsoleta

A partir de v10.x, el agente .NET deja de instrumentar Castle MonoRail. Los clientes aún pueden utilizar versiones anteriores del agente .NET para instrumentar esta biblioteca.

Consolidación de activos de instalación de Windows y cambios de nombre

En versiones anteriores, publicamos archivos ZIP separados para la instalación manual de activos del agente para .NET framework y .NET Core/.NET 5+ en Windows. Estos se han consolidado en un único archivo ZIP que contiene .NET framework y activos del agente .NET Core/.NET 5+ para la instalación manual de Windows (aún están disponibles las versiones de 64 y 32 bits). Esto hace que estos archivos ZIP manuales sean similares al instalador automatizado MSI existente que instala tanto .NET framework como .NET Core/.NET 5+.

También cambiamos el nombre de los archivos MSI y ZIP para que todos tengan el mismo nombre de archivo base: NewRelicDotNetAgent.

Tabla de nombres de recursos de instalación de Windows 9.x y sus equivalentes 10.x

Cambio de nombre de los paquetes del instalador de Linux

A partir de v10.x, el nombre de los paquetes de instalación del agente para Linux cambia de newrelic-netcore20-agent a newrelic-dotnet-agent. Creemos que el nombre netcore20 ha sido confuso ya que admitimos versiones de .NET Core superiores a 2.0 a medida que se lanzaron y, a partir de la versión 10.0 del agente, ya no admitimos versiones de .NET Core anteriores a 3.1.

Los nuevos paquetes newrelic-dotnet-agent están marcados como conflictivos y reemplazando (DEB) u obsoletos (RPM) los paquetes newrelic-netcore20-agent más antiguos. El administrador de paquetes de su sistema no permitirá que ambos se instalen al mismo tiempo.

Actualizando de newrelic-netcore20-agent a newrelic-dotnet-agent

1. Por seguridad, debes hacer una copia de seguridad de todos los archivos en /usr/local/newrelic-netcore20-agent antes de continuar con el siguiente paso.

2. Cierre cualquier aplicación .NET que se esté monitoreando actualmente.

3. Siga las instrucciones del administrador de paquetes apropiado para su sistema Linux:

   Actualice con apt (Debian, Linux Mint o Ubuntu)

   1. Actualice la lista de paquetes locales:

      bash

      Copia

      $
      sudo apt update

   2. Actualizar el agente:

      bash

      Copia

      $
      sudo apt install newrelic-dotnet-agent

   Actualice con dpkg (Debian, Linux Mint o Ubuntu)

   1. Vaya a download.newrelic.com/dot_net_agent/latest_release y copie la URL que corresponde a su arquitectura y al último newrelic-dotnet-agent .deb paquete.

   2. Descargue el paquete con wget, reemplazando https://LINK_TO_PACKAGE con la URL completa del paquete:

      bash

      Copia

      $
      wget -L https://LINK_TO_PACKAGE

   3. Actualice el agente, reemplazando VERSION con la versión actual:

      bash

      Copia

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

   Actualice con yum (CentOS, Oracle Linux o RHEL)

   Importante

   New Relic no ofrece actualmente paquetes rpm de Linux para ARM64. En su lugar, aproveche el tarball para instalarlo en estas plataformas.

   1. Actualizar el agente:

      bash

      Copia

      $
      sudo yum install newrelic-dotnet-agent

   Actualice con rpm (CentOS, Oracle Linux o RHEL)

   Importante

   New Relic no ofrece actualmente paquetes rpm de Linux para ARM64. En su lugar, aproveche el tarball para instalarlo en estas plataformas.

   1. Vaya a download.newrelic.com/dot_net_agent/latest_release, y copie la URL que corresponde a su arquitectura y al último newrelic-dotnet-agent .rpm paquete.

   2. Descargue el paquete con wget, reemplazando https://LINK_TO_PACKAGE con la URL completa del paquete:

      bash

      Copia

      $
      wget -L https://LINK_TO_PACKAGE

   3. Actualice el agente, reemplazando VERSION con la versión actual:

      bash

      Copia

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

4. Actualice las variables de entorno de generación de perfiles. La configuración exacta que debe utilizar cambia según sus variables específicas.

   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"

   Copia

5. Inicie su aplicación y espere a que aparezcan los datos.

Una vez que esté satisfecho de que la migración se realizó correctamente, realice los siguientes pasos para limpiar los artefactos restantes de la instalación newrelic-netcore20-agent anterior:

1. Si tiene un sistema basado en Debian (apt/dpkg):

   bash

   Copia

   $
   sudo dpkg -P newrelic-netcore20-agent

2. Elimine /usr/local/newrelic-netcore20-agent (se aplica tanto a escenarios basados en Debian (apt/dpkg) como en escenarios basados en RPM (yum/rpm)):

   bash

   Copia

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

Números de versión más cortos en los nombres de archivos del instalador

El agente New Relic .NET ha estado utilizando Semantic Versioning desde la versión 8.28.0 del agente. SemVer utiliza tres números para versionar una versión: mayor, menor y parche. Sin embargo, los nombres de archivos de nuestro instalador han seguido usando cuatro números, siendo el cuarto número de versión siempre cero. En el futuro, eliminaremos este cuarto número sin sentido y potencialmente confuso de las cadenas de versión que se encuentran en los nombres de archivos de nuestro instalador. Este cambio se aplica a los archivos de instalación de Windows y Linux.