Guia de migração do agente .NET 9.x para 10.x

Este guia descreve as principais alterações entre as versões 9.xe 10.x do agente .NET, os problemas que você pode encontrar durante a atualização e como migrar com êxito para a versão 9.x.

As principais mudanças incluem:

• O agente .NET não suporta mais estrutura designada como fim de vida
• Remoção do instalador scriptável obsoleto
• Remoção de instrumentação obsoleta
• Consolidação de ativos de instalação do Windows e alterações de nome
• Mudança de nome dos pacotes do instalador Linux
• Número de versão mais curto nos nomes dos arquivos do instalador

O agente .NET não suporta mais estrutura designada como fim de vida

A Microsoft anunciou que o .NET Framework 4.6.1 e inferior e o .NET Core 3.0 e inferior atingiram o fim do suporte. Designar a estrutura antiga como em fim de vida garante que estamos dedicando recursos para melhorar as versões mais recentes dessa estrutura.

É recomendado que os clientes migrem seus aplicativos para usar as versões framework suportadas. Caso a migração framework não seja uma opção, os clientes ainda podem instrumentar seu aplicativo com o agente .NET versão 9.x.

Remoção do instalador programável obsoleto

A partir da v10.x, deixaremos de fornecer instalador programável em nosso site de download devido ao baixo uso. Se você usar o instalador programável para automatizar o processo de instalação do agente .NET, considere usar o instalador MSI com opções de linha de comando em seu script ou criar seu próprio script de instalação com o arquivo zip do agente .NET de nosso site de download daqui para frente.

Remoção de instrumentação obsoleta

A partir da v10.x, o agente .NET para o Castle MonoRail instrumentado. Os clientes ainda podem usar versões mais antigas do agente .NET para utilizar esta biblioteca.

Consolidação de ativos de instalação do Windows e alterações de nome

Nas versões anteriores, publicamos arquivos ZIP separados para instalação manual de ativos de agente para .NET framework e .NET Core/.NET 5+ no Windows. Eles foram consolidados em um único arquivo ZIP contendo ativos do .NET framework e do agente .NET Core/.NET 5+ para instalação manual do Windows (as versões de 64 e 32 bits ainda estão disponíveis). Isso torna esses arquivos ZIP manuais semelhantes ao instalador automatizado MSI existente, que instala recursos .NET framework e .NET Core/.NET 5+.

Também renomeamos os arquivos MSI e ZIP para que todos tenham o mesmo nome de arquivo base: NewRelicDotNetAgent.

Tabela de nomes de ativos de instalação do Windows 9.x e seus equivalentes 10.x

Mudança de nome dos pacotes do instalador Linux

A partir da v10.x, o nome dos pacotes de instalação do agente para Linux será alterado de newrelic-netcore20-agent para newrelic-dotnet-agent. Achamos que o nome netcore20 tem sido confuso, pois oferecemos suporte a versões do .NET Core superiores a 2.0 à medida que foram lançadas e, a partir da versão 10.0 do agente, não oferecemos mais suporte a versões do .NET Core anteriores a 3.1.

Os novos pacotes newrelic-dotnet-agent são marcados como conflitantes e substituem (DEB) ou obsoletos (RPM) os pacotes newrelic-netcore20-agent mais antigos. O gerenciador de pacote do seu sistema não permitirá que ambos sejam instalados ao mesmo tempo.

Atualizando de newrelic-netcore20-agent para newrelic-dotnet-agent

1. Por segurança, você deve fazer uma cópia de backup de todos os arquivos em /usr/local/newrelic-netcore20-agent antes de prosseguir para a próxima etapa.

2. Encerre qualquer aplicativo .NET que esteja sendo monitorado.

3. Siga as instruções do gerenciador de pacote apropriado para seu sistema Linux:

   Atualize com apt (Debian, Linux Mint ou Ubuntu)

   1. Atualize a lista de pacotes locais:

      bash

      Copiar

      $
      sudo apt update

   2. Atualize o agente:

      bash

      Copiar

      $
      sudo apt install newrelic-dotnet-agent

   Atualize com dpkg (Debian, Linux Mint ou Ubuntu)

   1. Vá para download.newrelic.com/dot_net_agent/latest_release e copie o URL que corresponde à sua arquitetura e ao newrelic-dotnet-agent mais recente .deb pacote.

   2. Baixe o pacote com wget, substituindo https://LINK_TO_PACKAGE pela URL completa do pacote:

      bash

      Copiar

      $
      wget -L https://LINK_TO_PACKAGE

   3. Atualize o agente, substituindo VERSION pela versão atual:

      bash

      Copiar

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

   Atualize com yum (CentOS, Oracle Linux ou RHEL)

   Importante

   Atualmente, a New Relic não oferece pacotes rpm Linux para ARM64. Em vez disso, aproveite o tarball para instalar nesta plataforma.

   1. Atualize o agente:

      bash

      Copiar

      $
      sudo yum install newrelic-dotnet-agent

   Atualizar com rpm (CentOS, Oracle Linux ou RHEL)

   Importante

   Atualmente, a New Relic não oferece pacotes rpm Linux para ARM64. Em vez disso, aproveite o tarball para instalar nesta plataforma.

   1. Vá para download.newrelic.com/dot_net_agent/latest_release, e copie o URL que corresponde à sua arquitetura e ao newrelic-dotnet-agent .rpm mais recente pacote.

   2. Baixe o pacote com wget, substituindo https://LINK_TO_PACKAGE pela URL completa do pacote:

      bash

      Copiar

      $
      wget -L https://LINK_TO_PACKAGE

   3. Atualize o agente, substituindo VERSION pela versão atual:

      bash

      Copiar

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

4. Atualize as variáveis de ambiente de criação de perfil. A configuração exata que você deve usar muda com base em suas variáveis 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"

   Copiar

5. Inicie seu aplicativo e espere que os dados apareçam.

Quando tiver certeza de que a migração foi bem-sucedida, execute as etapas a seguir para limpar os artefatos restantes da instalação anterior newrelic-netcore20-agent :

1. Se você estiver em um sistema baseado em Debian (apt/dpkg):

   bash

   Copiar

   $
   sudo dpkg -P newrelic-netcore20-agent

2. Remova /usr/local/newrelic-netcore20-agent (aplica-se a cenários baseados em Debian (apt/dpkg) e baseados em RPM (yum/rpm)):

   bash

   Copiar

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

Números de versão mais curtos nos nomes dos arquivos do instalador

O agente New Relic .NET usa o Versionamento Semântico desde a versão 8.28.0 do agente. SemVer usa três números para versionar um lançamento: principal, secundário e patch. No entanto, os nomes dos arquivos do nosso instalador continuaram a usar quatro números, com o quarto número da versão sempre sendo zero. Seguindo em frente, estamos eliminando esse quarto número sem sentido e potencialmente confuso das strings de versão encontradas em nossos nomes de arquivos do instalador. Esta alteração se aplica aos arquivos do instalador do Windows e do Linux.