Este documento explica como instalar o agente .NET do APM na plataforma de serviços na nuvem Azure da Microsoft. Isso não é o mesmo que instalar a integração de infraestrutura para Microsoft Azure. Para ter certeza de que está usando as instruções mais relevantes, primeiro consulte a instalação do agente .NET.
Importante
Antes de instalar o pacote NuGet em uma solução Visual Studio de vários projetos, certifique-se de ter selecionado o projeto correto para seu aplicativo .NET New Relic (por exemplo, um projeto de site específico).
Verifique a localização da função Web ou de trabalho
Se os arquivos Service estiverem aninhados em uma pasta Solution , o instalador do NuGet não poderá localizar ou atualizar os arquivos necessários. Isso causará problemas com a configuração do agente .NET, o que, por sua vez, impedirá que o agente relate métricas em seus serviços na nuvem.
Recommendation: Coloque a função Web
ou Worker
em root da solução antes de instalar o pacote NuGet. Depois que o agente .NET da New Relic estiver instalado, você poderá mover a função Cloud de volta para a pasta Solution .
Instale o pacote NuGet para serviços na nuvem
Importante
Os pacotes NuGet neste procedimento oferecem suporte apenas ao antigo packages.config
. Eles não suportam o novo formato PackageReference
. Para obter mais informações, consulte a documentação de referência de pacotes da Microsoft
Para soluções de vários projetos, certifique-se de ter selecionado o projeto correto (por exemplo, um projeto de site específico) antes de instalar o pacote NuGet.
Abra sua solução do Visual Studio ou crie uma nova selecionando
File > New > Project
. Para soluções de vários projetos, certifique-se de ter selecionado o projeto correto (por exemplo, um projeto de site específico).
Se você ainda não tiver um projeto de serviços na nuvem do Azure em sua solução, adicione um clicando com o botão direito do mouse em seu aplicativo em
Solution Explorer
e selecionando
Add Windows Azure Cloud Service Project
.
Abra o console
Package Manager
selecionando
Tools > Library Package Manager > Package Manager Console
. Defina seu projeto como o projeto padrão.
No prompt de comando
Package Manager
, digite
Install-Package NewRelicWindowsAzure
e pressioneEnter
.
Siga o prompt para inserir sua chave de licença do New Relic e o nome do seu aplicativo como deseja que apareça na interface do usuário do New Relic. Ou use o nome da sua solução como nome do aplicativo padrão.
Em
Solution Explorer
, clique com o botão direito no projeto Azure serviços na nuvem e selecione
Publish
.
Se esta for a primeira vez que você implanta este aplicativo no Azure, insira suas credenciais do Azure.
Se aplicável, métodos de instrumento para
Worker
funções.
Instrumento Função do trabalhador
Uma função Worker
é um processo não web executado como um serviço na nuvem do Azure. Para instrumento a Worker
função, você deve criar uma transação personalizada.
O agente .NET automaticamente utiliza chamadas externas e chamadas de banco de dados, mas não utiliza métodos padrão para transação. Criar uma transação personalizada resolve isso. Após a inicialização da função Worker
e a execução do método, os dados da transação aparecerão nas páginas Summary e Transactions do APM na categoriaNon-web .
O instalador do NuGet adiciona automaticamente o parâmetro NewRelic.AppName
à configuração do aplicativo. Isso aparece como <YOUR_WORKER_ROLE_NAME>.dll.config
em E:\approot
.
O agente .NET também automaticamente instrumento WaWorkerHost.exe
. Este é o nome do processo de função Worker
real.
Opcional: crie um arquivo de configuração personalizado
Você pode criar um arquivo de configuração personalizado no Visual Studio. Isso permite que você faça alterações em newrelic.config
dentro do Visual Studio, sem precisar acessar remotamente sua instância do Azure Role sempre que fizer uma alteração. Sempre que você publica seu aplicativo, o arquivo de configuração no Visual Studio é automaticamente carregado no host remoto.
As escolhas feitas com o assistente de instalação não importam. A instalação local não afeta o ambiente de desenvolvimento do Azure.
No Visual Studio, selecione Solution Explorer e abra
NewRelicAgent_x64_XYZ.msi
.Siga as etapas para instalar o agente localmente.
Importe
newrelic.config
para seu projeto: em Solution Explorer > Cloud Project, clique com o botão direito em Web Role e selecione Add > Existing Item. Navegue até C:\ProgramData\New Relic\.NET Agent e selecionenewrelic.config
.De C:\ProgramData\New Relic\.NET Agent, edite
newrelic.cmd
.Na seção
:INSTALL_NEWRELIC_AGENT
, encontre esta instrução:IF $ERRORLEVEL% EQU 0 (Adicione o seguinte código como outra instrução dentro do bloco
IF
e salve o arquivo:copy /Y "%RoleRoot%\approot\newrelic.config" "%NR_HOME%" >> %RoleRoot%\nr.log
Agora você pode editar o newrelic.config
hospedado no Visual Studio. Sempre que você publicar seu aplicativo, o comando copy
fará upload do arquivo de configuração para o host remoto.
Veja o desempenho do seu aplicativo
Seu aplicativo deve receber tráfego para que você possa visualizar seu desempenho no New Relic. Pode ser necessário aguardar alguns minutos para que os dados comecem a aparecer. Se não aparecerem dados, consulte os procedimentos de resolução de problemas para serviços na nuvem do Azure. Para visualizar o desempenho do seu aplicativo no APM: Vá para one.newrelic.com > All capabilities > APM & services > (select an app). A página APM Summary aparece automaticamente.