Instale o agente .NET no Azure serviços na nuvem

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.

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

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.

1. 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).

2. 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

   .

3. Abra o console

   Package Manager

   selecionando

   Tools > Library Package Manager > Package Manager Console

   . Defina seu projeto como o projeto padrão.

4. No prompt de comando

   Package Manager

   , digite Install-Package NewRelicWindowsAzure e pressione

   Enter

   .

5. 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.

6. Em

   Solution Explorer

   , clique com o botão direito no projeto Azure serviços na nuvem e selecione

   Publish

   .

7. Se esta for a primeira vez que você implanta este aplicativo no Azure, insira suas credenciais do Azure.

8. 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.

namespace MyWorkerRole
{
    public class NotificationQueue
    {
        public bool ProcessMessage(Message message) {
            // code to process message
        }
    }
}

<?xml version="1.0" encoding="utf-8"?>
<extension xmlns="urn:newrelic-extension">
  <instrumentation>
    <tracerfactory name="NewRelic.Agent.Core.Tracer.Factories.BackgroundThreadTracerFactory" metricName="Custom/ProcessMessage">
      <match assemblyname="MyWorkerRole" classname="MyWorkerRole.NotificationQueue">
        <exactmethodmatcher methodName="ProcessMessage" />
      </match>
    </tracerfactory>
  </instrumentation>
</extension>

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.

1. No Visual Studio, selecione Solution Explorer e abra NewRelicAgent_x64_XYZ.msi.

2. Siga as etapas para instalar o agente localmente.

3. 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 selecione newrelic.config.

4. De C:\ProgramData\New Relic\.NET Agent, edite newrelic.cmd.

5. Na seção :INSTALL_NEWRELIC_AGENT , encontre esta instrução:

   IF $ERRORLEVEL% EQU 0 (

   Copiar

6. 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

   Copiar

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.