Soluções de monitoramento .NET diferentes da New Relic podem usar esta API de criação de perfil. Mas apenas um serviço pode usar o profiler por vez. Isso significa que se você usou um serviço de monitoramento .NET no passado e não o desabilitou/removeu completamente, o profiler ainda pode estar em uso, o que causará conflitosprofiler quando você tentar habilitar o agente .NET.
Biblioteca de download do agente .NET
A biblioteca de download do agente .NET da New Relic contém pacotes de arquivos de instalação que são referenciados em procedimentos de instalação específicos. Para obter mais informações sobre esses arquivos, consulte o arquivo ReadMe da biblioteca de download.
Arquivos zip para instalação manual do agente .NET (Windows)
Para instalar manualmente o agente usando um arquivo ZIP, escolha o arquivo correto para o aplicativo que deseja monitor:
Acesse o site de download do agente .NET e obtenha o arquivo correspondente à arquitetura do seu aplicativo (64 ou 32 bits):
Framework .NET ou .NET Core/.NET 5+ (32 bits): NewRelicDotNetAgent_VERSION_x86.zip
Framework .NET ou .NET Core/.NET 5+ (64 bits): NewRelicDotNetAgent_VERSION_x64.zip
Descompacte a pasta do agente no local desejado.
Defina variáveis de ambiente para o processo que você deseja monitor.
Cuidado
Não recomendamos definir essas variáveis de ambiente globalmente. Definir essas variáveis de ambiente globalmente pode fazer com que todos os processos .NET em execução no sistema sejam instrumentados e reportados ao New Relic. Se você estiver instalando o agente manualmente, esperamos que você tenha meios para definir essas variáveis de ambiente apenas para os processos que deseja monitor.
Para o .NET framework, as seguintes variáveis são necessárias:
Reinicie seu aplicativo. Se estiver usando o IIS, reinicie o IIS.
Se seu aplicativo estiver recebendo tráfego, os dados deverão aparecer em alguns minutos. Caso contrário, consulte Nenhum dado aparece.
Necessidade de instrumentação personalizada
Depois de instalar um agente .NET, a maioria dos aplicativos .NET framework reportará automaticamente os dados para sua conta New Relic. (Consulte compatibilidade de estrutura de aplicativo: .NET framework | .NET Core.)
Se o seu aplicativo .NET usa uma framework de aplicativo que não é instrumentada automaticamente ou se o aplicativo não possui nenhuma framework (como um aplicativo de console), após a instalação você precisará configurar manualmente a instrumentação do seu aplicativo. Aqui estão as etapas para fazer isso:
Instrumento personalizado em seu aplicativo para definir qual atividade será reportada ao New Relic.
Variáveis de ambiente relacionadas à instalação
A instalação de um agente .NET requer a configuração de variáveis de ambiente. Para alguns procedimentos de instalação (como aplicativos .NET hospedados no IIS), essas variáveis de ambiente são definidas automaticamente. Para outros procedimentos de instalação, você terá que configurá-los manualmente. Para ver as variáveis de ambiente necessárias para o aplicativo .NET framework e .NET Core, consulte Variáveis de ambiente.
Para instalações que exigem a definição manual de variáveis de ambiente, você também pode definir outras opções de configuração por meio de variáveis de ambiente. Aqui está uma olhada em dois que são comumente definidos:
License key. A variável de ambiente para definir é:
O instalador programável são arquivos ZIP que contêm um script do PowerShell para instalação do agente .NET. Há um arquivo zip separado para .NET framework versus .NET Core.
Importante
Recomendamos usar o instalador MSI em vez do instalador programável. Se você deseja automatizar sua instalação, considere executar o instalador MSI na linha de comando.
Importante
A partir da versão 10.0.0 do agente .NET, o instalador programável não está mais disponível. Esta documentação permanece para clientes que desejam usar o instalador programável para uma versão mais antiga.
Para usar o instalador programável para instalar o agente .NET para um aplicativo .NET framework :
Certifique-se de ter direitos de administrador para o seu grupo de administração do Windows. Para obter mais detalhes sobre isso, consulte a documentação de permissões.
Baixe o pacote do instalador programável para o .NET framework no site de download. Ao baixar ou usar um desses pacotes, você concorda e aceita os termos de licença.
Descompacte o pacote.
Abra um shell de comando e navegue até a pasta do pacote descompactado.
Para uma instalação simples sem opções, use este comando:
bash
$
.\install.cmd -LicenseKey YOUR_LICENSE_KEY
Para instalar com uma ou mais opções adicionais, utilize o formato abaixo. Consulte a tabela abaixo para obter uma descrição das opções de instalação.
Se seu aplicativo estiver recebendo tráfego, os dados deverão aparecer em alguns minutos. Caso contrário, consulte Nenhum dado aparece.
Opções de instalação
Descrição
LicenseKey
Required. Seu .
NoIISReset
Opcional. Use esta opção para evitar que o instalador inicie uma redefinição do IIS.
Importante
Se você usar esta opção, será necessário redefinir o IIS manualmente antes que o New Relic inicie a instrumentação de qualquer aplicativo hospedado no IIS.
InstrumentAll
Opcional. Por padrão, o agente .NET irá instrumentar todos os aplicativos hospedados no IIS. Use esta opção para ativar a instrumentação de outros tipos de aplicativos .NET.
InstallPath
Opcional. Use esta opção para escolher um local de instalação diferente. O local de instalação padrão é C:\Program Files\New Relic.
Desinstalando o agente com o desinstalador programável:
Dica
Você pode adicionar a opção Force ao script de desinstalação para forçar uma desinstalação sem solicitar a reinicialização do IIS.
Execute o seguinte comando para desinstalar o agente .NET:
Observe que são necessários direitos de administrador em um shell elevado (especificamente para selecionar um diretório de log personalizado e executar um IISReset).
Cuidado
Por motivos de segurança, é necessário executar o script installAgent.ps1 conforme mostrado abaixo, acrescentando ./ ao nome do arquivo do script, em vez de acrescentar powershell ao script. Se você executar o script acrescentando powershell antes e qualquer um dos argumentos fornecidos (como o caminho de instalação ou o caminho de log personalizado) contiver espaços, esses argumentos serão corrompidos, o que levaria à instalação do agente em um local diferente do local pretendido, que pode ser inseguro.
Para usar o instalador programável para instalar o agente .NET para um aplicativo .NET Core:
Certifique-se de ter direitos de administrador para o seu grupo de administração do Windows. Para mais detalhes sobre isso, consulte a documentação de permissões
A instalação global irá instrumentar todos os processos do .NET Core em seu sistema. Escolha a instalação global apenas se desejar monitorar todos os processos do .NET Core.
Para uma instalação simples sem opções, use este comando:
bash
$
./installAgent.ps1 -destinationPATH-installType global -licenseKey YOUR_LICENSE_KEY \
Se seu aplicativo estiver recebendo tráfego, os dados deverão aparecer em alguns minutos. Caso contrário, consulte Nenhum dado aparece.
Opções de instalação
Descrição
Destination
Required. O local onde o agente está instalado. Este pode ser um caminho absoluto ou relativo. As cotações são obrigatórias.
InstallType
Required. Determina se esta é uma instalação local (específica do aplicativo) ou global (em todo o sistema).
LicenseKey
Required. Seu .
AppName
Opcional. Define o nome do aplicativo padrão associado à instalação do agente.
LogDir
Opcional. Define um local de registro personalizado para o agente. Por padrão, o agente coloca o diretório de log no diretório de instalação.
X86
Opcional. Instala a versão de 32 bits do agente em vez da versão de 64 bits. New Relic does not recommend instalando a versão de 32 bits do agente globalmente.
ResetIIS
Opcional. Executa um iisreset após a instalação.
Importante
Use isso apenas se seu aplicativo .NET Core estiver hospedado por meio de um proxy reverso do IIS.
Force
Opcional. Força o processo de instalação a substituir uma instalação anterior ou a instalar em uma pasta existente.
Cuidado
Isso substitui quaisquer personalizações de configuração. A New Relic recomenda fazer backup do seu arquivo de configuração e de quaisquer arquivos de instrumentação personalizados antes de forçar uma instalação excessiva.