Instale o agente .NET em Azure Web Apps

Este documento explica como instalar o agente .NET da New Relic para monitoramento do desempenho de aplicativos (APM) em seu Azure Web App. (Isso não é o mesmo que instalar a integração de monitoramento de infraestrutura para Microsoft Azure.) Recommendation: Antes de seguir estas instruções, leia a visão geral da instalação do agente .NET.

Opções de instalação

Utilize qualquer um dos seguintes métodos para adicionar o agente New Relic .NET à sua aplicação web implantada no Azure. A melhor opção depende da sua função, ambiente, implantação, etc. Por exemplo:

Para equipas de operações que precisam de monitor a aplicação, a opção mais fácil e fiável é utilizar a extensão do site Azure mantida publicamente.

Note: Atualmente, as Extensões de Site do Azure estão disponíveis apenas para Recursos do Serviço de Aplicativos do Windows.

• Instalar usando a extensão do site do Azure

Para equipes de desenvolvedores ou qualquer pessoa que precise implantar o agente em um recurso de serviço de aplicativo Linux, a instalação via nuget é a melhor opção:

• Instalar usando NuGet (.NET framework)
• Instalar usando NuGet (.NET Core)

Para monitor aplicativos que não sejam da Web (incluindo WebJobs) ou aplicativos ASP..NET Core direcionados ao .NET framework, você deve ativar explicitamente o agente para o processo .exe desse aplicativo por meio de um destes dois métodos:

• Ativar por meio do posicionamento do arquivo newrelic.config local.
• Habilitar via arquivo de configuração do aplicativo

Além disso, WebJobs podem precisar de instrumentação personalizada para que a transação apareça no APM e configuração adicional caso sejam executados por menos de um minuto.

Desabilitar insightsdo aplicativo

Tanto o agente .NET da New Relic quanto insights do aplicativo Microsoft dependem do profiler CLR, mas apenas um pode estar ativo por vez. Você must desativa o aplicativo insights para que o agente .NET funcione corretamente. Para obter mais informações, consulte nossos procedimentos do aplicativo Insights resolução de problemas.

Instalar usando a extensão do site New Relic Azure (Windows Only)

Para instalar o agente .NET para um aplicativo Web do Azure usando a extensão de site do Azure New Relic:

1. Encerre seu aplicativo Web antes de instalar a extensão de site do Azure New Relic.

2. Adicione a extensão do site: navegue até https://[yoursitename].scm.azurewebsites.net e selecione

   Site extensions > Gallery

   .

3. Selecione o sinal de mais

   ícone próximo à extensão do site New Relic.

4. No portal do Azure, adicione as configurações do aplicativo New Relic ao serviço de aplicativo do Azure. Isso instala a versão mais recente do agente .NET. Com a versão 10.x, eliminamos o suporte para .NET framework 4.6.1 e inferior e .NET Core 3.0 e inferior (consulte o guia de migração). Se precisar de uma versão inferior do agente, use a variável de ambiente NEWRELIC_AGENT_VERSION_OVERRIDE . Por exemplo: NEWRELIC_AGENT_VERSION_OVERRIDE=9.9.0.

5. Reinicie seu aplicativo da web.

Algumas notas relacionadas a este processo de instalação:

• Se você precisar adicionar uma instrumentação XML personalizada ou modificar o arquivo base newrelic.config, você encontrará o agente .NET para .NET framework em %HOME%\NewRelicAgent\Framework e o agente para .NET Core em%HOME%\NewRelicAgent\Core.

• Este método de instalação monitora o aplicativo

  all

  .NET Core na instância do Azure Web Apps. Se quiser desabilitar o monitoramento de um aplicativo .NET Core específico, você pode fazer um destes:

  • Desative o agente em um arquivoappsettings.json .
  • Em um arquivo newrelic.config localizado no diretório raiz do aplicativo, defina agentEnabled como false.

Atualizando o agente com a extensão do site New Relic Azure

Para atualizar o agente .NET para um aplicativo Web do Azure usando a extensão de site do Azure New Relic, siga as instruções de instalação para:

• Instale a versão mais recente da extensão do site New Relic Azure, que atualiza os arquivos do agente para a versão mais recente.
• Reinicie o aplicativo Web para iniciar o agente atualizado.

Instalar usando NuGet (.NET framework)

O método de instalação do NuGet empacota o agente New Relic com seu aplicativo para que ele fique disponível para o Host do Aplicativo Web do Azure.

Os pacotes NuGet neste procedimento oferecem suporte apenas ao antigo packages.config. Eles não suportam o formato PackageReference atual. 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 aplicativo Web específico) antes de instalar o pacote NuGet.

Se você estiver atualizando o agente do .NET framework usando NuGet, todas as alterações feitas em newrelic.config serão substituídas. Para preservar quaisquer alterações, salve seu newrelic.config fora do seu projeto e restaure-o após a atualização.

Para instalar o agente .NET em um aplicativo Web do Azure usando NuGet:

1. No portal do Azure, verifique sua plataforma do Azure (32 bits ou 64 bits): no menu da barra lateral do Azure, selecione

   App Services > Your Application > Settings > Configuration > General settings

   .

2. Abra seu aplicativo no Visual Studio e instale o pacote New Relic NuGet executando o comando apropriado no console

   Package manager

   :

   • 32-bit

     : Install-Package NewRelic.Azure.WebSites

   • 64-bit

     : Install-Package NewRelic.Azure.WebSites.x64

3. Publique seu aplicativo.

4. No portal do Azure, abra o aplicativo Web que você deseja monitor e selecione

   Settings > Configuration

   .

5. Em

   Configuration

   , selecione

   + New application setting

   e adicione esses pares de valores principais.

6. No portal do Azure, adicione as configurações do aplicativo New Relic ao serviço de aplicativo do Azure.
7. Reinicie seu aplicativo da web.

Instalar usando NuGet (.NET Core)

O método de instalação do NuGet empacota o agente New Relic com seu aplicativo para que ele fique disponível para o Host do Aplicativo Web do Azure.

Nosso agente .NET oferece suporte a aplicativos .NET Core Linux e Windows nos Serviços de Aplicativos do Azure. O processo de instalação dos Serviços de Aplicativos do Azure difere dos procedimentos de instalação do agente .NET para Linux e Windows.

Para instalar o agente .NET em um aplicativo Web do Azure usando NuGet:

1. Instale o pacote NuGet NewRelic.Agent .

2. Modifique o nó log adicionando um atributo de diretório ao seu arquivo newrelic.config (Note: Se o Visual Studio impedir que você edite o arquivo newrelic.config que foi adicionado ao seu projeto pelo NuGet, você precisará fazer uma cópia local disso em seu aplicativo):

   Configuração do arquivo de log para Windows

   <log directory="D:\Home\LogFiles\NewRelic" level="info"></log>

   Copiar

   Dica

   Se você não quiser modificar o arquivo de configuração, adicione uma nova configuração de aplicativo: NEWRELIC_LOG_DIRECTORY=D:\Home\LogFiles\NewRelic

   Configuração do arquivo de log para Linux

   <log directory="/home/LogFiles/NewRelic" level="info"></log>

   Copiar

   Dica

   Se você não quiser modificar o arquivo de configuração, adicione uma nova configuração de aplicativo: NEWRELIC_LOG_DIRECTORY=/home/LogFiles/NewRelic

3. Publique seu aplicativo.

4. No portal do Azure, abra o aplicativo Web que você deseja monitor e selecione Settings > Configuration.

5. Em Configuration, selecione + New application setting e adicione esses pares de valores principais.

6. No portal do Azure, adicione as configurações do aplicativo New Relic ao serviço de aplicativo do Azure.
7. Reinicie seu aplicativo da web.

Adicionar configurações do aplicativo New Relic aos Serviços de Aplicativos do Azure

Para adicionar as configurações do seu aplicativo:

1. Certifique-se de ter seu chave de licençaantes de adicionar as configurações do aplicativo do agente .NET da New Relic.

2. No portal do Azure, pesquise e abra App Services para acessar o aplicativo Web que você deseja monitor. Em seguida, selecione Configuration > Application settings.

3. Em Application settings, selecione + New application setting e adicione estes pares de valores principais:

   Chave	Valor
   NEW_RELIC_LICENSE_KEY	YOUR_LICENSE_KEY
   NEW_RELIC_APP_NAME	YOUR_APP_NAME

   Se você precisar usar uma versão anterior do agente .NET, use este par de valores principais:

   Chave	Valor
   NEWRELIC_AGENT_VERSION_OVERRIDE	DESIRED_AGENT_VERSION_NUMBER

4. Salve e reinicie seu aplicativo web.

Definir chave de licençae o nome do aplicativo com Application settings substituirá newrelic.config.

Para verificar as variáveis de ambiente do seu aplicativo no console de diagnóstico Kudu do seu aplicativo, acesse Environment > Environment variables.

Por exemplo:

https://myappname.scm.azurewebsites.net/Env.cshtml#envVariables

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 Azure Web Apps. Para visualizar o desempenho do seu aplicativo no New Relic: Vá para one.newrelic.com > All capabilities > APM & services > (select an app). A página APM Summary aparece automaticamente.

Resolução de problemas

Se nenhum dado aparecer após a instalação do agente, gerando tráfego para seu aplicativo e aguardando alguns minutos, tente estas dicas de resolução de problemas:

• Certifique-se de que todos os arquivos no diretório newrelic na raiz do seu aplicativo foram publicados no Azure.
• Certifique-se de que as variáveis de ambiente estejam definidas corretamente.
• Certifique-se de que o Microsoft aplicativo insights não esteja instalado e configurado no aplicativo. Para obter mais informações, consulte os procedimentos do aplicativo Insights resolução de problemas.
• Consulte procedimentos adicionais de resolução de problemas do Azure , conforme aplicável.