Depurando o agente .NET no Windows

Problema

Depois de instalar o agente .NET da New Relic para Windows, você terá um ou mais dos seguintes problemas:

• Você não vê nenhum dado
• Você percebe dados faltantes
• Você não vê nenhum registro

Solução

Coisas importantes para verificar e entender:

• Certifique-se de ter privilégios de administrador em seu host.
• Certifique-se de que as etapas de instalação e execução foram seguidas

Etapa 1: verificar o log do agente do aplicativo

Dicas importantes antes de verificar o log:

• Ao usar o instalador MSI do Windows, o padrão é %ALLUSERSPROFILE%\New Relic\.NET Agent\Logs.
• Se você instalou o agente com o pacote NuGet NewRelic.Agent , encontrará uma pasta logs no diretório onde o agente foi extraído em seu sistema.

Para verificar o log do agente:

1. Certifique-se de estar analisando os dados atuais. Exclua ou mova quaisquer arquivos existentes no diretório de log para ter certeza de que o log gerado reflete o estado atual do seu sistema.
2. Reinicie seu aplicativo. Se seu aplicativo estiver hospedado no IIS, execute uma linha de comando IISRESET em uma linha de comando admin.
3. Exercite seu aplicativo por pelo menos alguns minutos de uma forma que gere o tráfego que você espera ver em sua conta New Relic.
4. Anote o ID do processo (PID) em que seu aplicativo está sendo executado para poder verificar se um log está sendo criado para esse processo. Você pode encontrar o PID usando o Gerenciador de Tarefas do Windows ou o Process Explorer.
5. Volte para o diretório de log do agente e procure um arquivo de log com um nome que contenha o ID do processo do seu aplicativo (por exemplo, NewRelic.Profiler.[PID].log).
6. Se você vir esse arquivo profiler log no diretório de logs, verifique também se há um log de agente correspondente. O log do agente contém o prefixo newrelic_agent. Se você estiver executando vários aplicativos .NET em seu host, pode haver mais de um deles. Se você vir um ou mais, deverá determinar qual corresponde ao aplicativo que está tentando monitor.
7. Procure no log do agente a sequência (pid [your PID]), por exemplo (pid 1573). Se você encontrar essa string no arquivo de log, saberá que é o log do agente associado ao seu aplicativo.
8. Procure erros de rede ou outros erros que possam fazer com que o agente não consiga enviar dados para a New Relic.

Etapa 2: verifique se o profiler do agente .NET está carregado no processo do aplicativo

Para verificar se o profiler está carregado:

1. Baixe e extraia o Microsoft Process Explorer para o seu servidor.

2. Lance a versão apropriada do Process Explorer para seu ambiente (32 x 64 bits) como administrador (clique com o botão direito Run as Administrator).

3. Na janela principal do Process Explorer, encontre o processo que você está tentando monitor e anote o número na coluna PID. Se você estiver tentando monitor um aplicativo Web hospedado no IIS, o nome do processo será w3wp.exe.

4. Na barra de menu do Process Explorer, selecione View > Show lower pane e depois View > Lower pane view > DLLs.

5. Destaque o processo do seu aplicativo no painel superior e verifique no painel inferior as seguintes DLL(s).

   • NewRelic.Profiler.dll - Esta DLL é necessária para que o agente monitor seu aplicativo. Se não estiver presente, certifique-se de que o usuário sob o qual o aplicativo está sendo executado tenha permissões de leitura para a pasta onde o agente foi instalado.

     Importante

     • No .NET Framework agent , isso deve ser igual à variável de ambiente NEWRELIC_INSTALL_PATH .
     • No .NET Core agent , isso deve ser igual à variável de ambiente CORECLR_NEWRELIC_HOME .

   • mscorlib.dll: .NET Framework agent only. A presença dessa DLL é como o agente identifica seu aplicativo como um aplicativo .NET framework . Se não estiver presente, o agente ignora completamente o aplicativo. Se o seu aplicativo não contém essa DLL, verifique novamente para ter certeza de que seu aplicativo atende aos requisitos de compatibilidade do agente

Se você não vir NewRelic.Profiler.dll, continue na próxima etapa. Se você obtiver resultados, vá para a Etapa 4 (permissões).

Etapa 3: verificar as variáveis de ambiente necessárias

Para verificar as variáveis de ambiente necessárias: Clique com o botão direito no processo no Process Explorer e selecione Properties. Você verá um conjunto de guias na parte superior da janela que aparece. Selecione a guia Environment .

Se as variáveis corretas estiverem definidas e o aplicativo que você está tentando monitor tiver acesso a elas, você deverá ver um conjunto específico de variáveis de ambiente, dependendo se o agente que você instalou é .NET framework ou .NET Core.

COR_ENABLE_PROFILING = 1
COR_PROFILER = {71DA0A04-7777-4EC6-9643-7D28B46A8A41}
NEWRELIC_INSTALL_PATH = C:\Program Files\New Relic\.NET Agent

CORECLR_ENABLE_PROFILING=1
CORECLR_PROFILER={36032161-FFC0-4B61-B559-F6C5D41BAE5A}
NEWRELIC_INSTALL_PATH=C:\Program Files\New Relic\.NET Agent\
CORECLR_NEWRELIC_HOME=C:\ProgramData\New Relic\.NET Agent\

CORECLR_ENABLE_PROFILING=1

Etapa 4: verifique as permissões

Verifique as seguintes tarefas de permissões:

• Certifique-se de que o usuário sob o qual o processo do seu aplicativo está sendo executado tenha permissões de leitura/gravação/execução para o diretório onde o agente .NET foi extraído em seu sistema (NEWRELIC_INSTALL_PATH ou CORECLR_NEWRELIC_HOME) e todos os seus subdiretórios.
• Se você fez alguma alteração, reinicie seu aplicativo e volte para a Etapa 1.

Se as etapas acima não resolverem o problema, recomendamos que você entre em contato com o suporte ou peça ajuda em nosso Fórum de suporte.