Consulte as notas de versão para encontrar a versão mais recente do agente.
Verifique a versão do agente .NET que você instalou atualmente usando Windows Programs and Features ou usando seu gerenciador de pacote Linux.
Antes que você comece
Existem várias maneiras de instalar o agente .NET, o que significa que existem várias maneiras de atualizá-lo. Neste documento, focamos nos procedimentos de atualização para a instalação mais simples, com o agente .NET instalado diretamente em um host Windows ou Linux.
Se você tiver outras instalações, consulte estes documentos de instalação dessas configurações para obter mais contexto:
Atualizar o agente requer Administrator direitos no seu grupo de administradores do Windows. Para obter mais informações, consulte a documentação de permissões.
Se a versão do seu agente for inferior a 7.0 ou você estiver usando o .NET framework versão 4.0 ou inferior, consulte Atualizar o agente .NET legado.
Se seu aplicativo estiver hospedado no IIS, certifique-se de stop IIS antes de atualizar o agente .NET.
Após a conclusão do pacote instalador, inicie o IIS.
Atualizar o agente .NET (Linux)
Importante
Para o agente .NET versões 10.0.0 ou superior, o nome do pacote é newrelic-dotnet-agent. Para o agente .NET versões 9.9.0 ou inferior, o nome do pacote é newrelic-netcore20-agent. O restante deste documento refere-se a newrelic-dotnet-agent; substitua-o pelo nome mais antigo se você tiver uma versão mais antiga do agente instalada. Ao atualizar para a versão 10.0.0 ou superior a partir de uma versão anterior, você precisará alterar as variáveis de ambiente CORECLR_NEWRELIC_HOME e CORECLR_PROFILER_PATH devido à alteração do nome do pacote.
Use um dos seguintes métodos para atualizar para a versão mais recente do agente .NET da New Relic:
Atualizar agente do .NET framework mais antigo (inferior a 7.0)
Se você estiver pensando em atualizar uma versão do agente do .NET framework inferior a 7.0, revise as notas a seguir. Para ver a versão do agente que você possui, consulte Verificar a versão do agente. Para obter uma lista completa das alterações do agente, consulte as notas de versão do .NET.
Importante
Para o aplicativo do instrumento direcionado ao .NET framework 4.0 ou anterior, você deve usar uma versão do agente .NET framework anterior à 7.0. Consulte suporte para .NET Frameworks 4.0 ou anterior para obter mais informações.
Se a versão for inferior a...
Fazem isto...
7,0
A versão 7.0 e superior do agente .NET framework suporta o aplicativo destino .NET framework 4.5 ou superior.
6.12
As versões 6.12 ou superiores não oferecem suporte ao Windows Server 2003. Se você precisar do Windows Server 2003, use as versões 6.11 ou inferiores. Para obter mais informações, obtenha suporte em support.newrelic.com ou baixe o agente.
6.11
Anteriormente,chamadas externas ede banco de dados que ocorriam fora de uma transação geravam métricas que você podia visualizar em suas respectivas páginas na interface do APM. Agora essas métricas não serão exibidas. Em um aplicativo não web essas chamadas podem ser “envolvidas” em uma transação customizada para poder visualizar sua métrica.
6,0
Para obter suporte assíncrono se a versão do seu agente .NET for anterior à 6.0, faça o seguinte, conforme aplicável:
Remova a seguinte configuração do aplicativo em newrelic.config , se existir:
<appSettings>
<addkey="AsyncMode"value="false"/>
</appSettings>
Certifique-se de que o host do seu aplicativo tenha o .NET 4.5 ou superior instalado.
Diga ao .NET para usar o novo pipeline de processamento de solicitação ASP adicionando as seguintes linhas ao seu web.config:
Métricas que não fazem parte de uma transação não serão exibidas na interface. Exception: Você pode visualizar o banco de dados e as métricas externas em suas respectivas páginas na interface do APM. Outras métricas desse tipo (como métodos instrumentados) podem se tornar visíveis "envolvendo-as" em uma transação personalizada.
A New Relic melhorou a nomenclatura da transação. No entanto, estas alterações podem afetar os nomes de transação das métricas existentes, incluindo transação principal, métrica "alerta sobre qualquer coisa" e consulta baseada em nomes de transação. Você deve recriar essas configurações usando o novo nome da transação após a atualização.
4.2
A New Relic abandonou a transação HTTP "externa" (".svc" transações) para aplicativo WCF hospedado com modo de compatibilidade asp.net desativado. Agora apenas a transação do WCF é relatada.
Esta alteração resulta em taxas de transferência de dados mais precisas. Ele também evita que erros de código de status HTTP sejam relatados em caso de falha na transação do WCF.
4.1
A New Relic implementou métrica de armazenamento de dados para rastreamento SQL. os nomes das métricas para atividade do banco de dados foram atualizados para reportar no armazenamento de dados.
4,0
O aplicativo MVC2 não gera mais segmentos específicos do MVC nem possui nomes de transações baseados em rotas do MVC.
3,0
O agente .NET da New Relic tornou-se dependente do .NET 3.5. Seu aplicativo ainda pode ter destino .NET 2.0, mas você deve ter o .NET 3.5 instalado no computador no qual o agente é executado.
2.20
A versão 2.19.3.0 foi a última versão do agente .NET que exigia a chamada de API GetBrowserTimingFooter() e GetBrowserTimingHeader() para . Na versão do agente 2.20.24.0 ou superior, você só precisa ligar para GetBrowserTimingHeader(). GetBrowserTimingFooter() não tem efeito. Recomendação: Remova essas referências do seu código.
2.9
O arquivo de configuração mudou de newrelic.xml para newrelic.config. instalador para agente mais recente tenta converter newrelic.xml (se presente) para newrelic.config.
2.2 ou anterior
Para atualizar de uma versão do agente .NET inferior a 2.2, você deve desinstalar o agente antigo antes de instalar a nova versão. Siga os procedimentos padrão da sua versão do Windows para desinstalar o agente. Seu sistema operacional pode exigir uma reinicialização.
Você pode encontrar cocreateinstance erros com services.exe ao atualizar um instalador antigo (2.1.3.494 ou inferior) ou fazer outras alterações nas variáveis de ambiente. Para resolver esse problema, consulte a documentação da Microsoft.