Com o agente .NET, você pode adicionar instrumentação às suas páginas da web. Antes de usar o browser com seu agente .NET, consulte as notas de versão do agente .NET e certifique-se de ter instalado a versão mais recente do agente .NET.
Siga os requisitos do agente .NET para instalar o monitoramento do Browser. Em seguida, siga os procedimentos deste documento para instrumentar manualmente o agente .NET.
Instrumentação automática
Importante
A instrumentação automática está disponível apenas para aplicativos Web do .NET framework e aplicativos Web .NET Core v6.0 e posteriores. A instrumentação automática não está disponível para aplicativos ASP..NET Core v5.0 e anteriores, mesmo que sejam monitorados pelo agente .NET.
Com a instrumentação automática do browser, o agente .NET injeta automaticamente o cabeçalho JavaScript do browser em qualquer página que tenha um content-type de text/html e também tenha uma tag <head> na página. A instrumentação automática do browser é habilitada por padrão para aplicativos Web do .NET framework , mas é desabilitada por padrão para aplicativos Web .NET Core v6 e posteriores. Consulte Habilitando a instrumentação automática do browser para .NET Core v6+ para obter mais informações.
A pesquisa da tag <head> começa no início do DOM. O agente .NET injeta o cabeçalho JavaScript por meio da adição de um HttpModule que modifica a página usando filtros de resposta HTTP antes de transmitir o conteúdo para o usuário.
Na primeira vez que você ativar a instrumentação automática, talvez seja necessário limpar o diretório de cache asp.net para que as páginas aspx sejam recompiladas. Use o seguinte comando:
$flush_dotnet_temp.cmdCom esta injeção, as páginas que funcionavam anteriormente poderão parar de funcionar se um content-type não estiver definido corretamente. Para corrigir, revise e atualize o content-types no seu aplicativo ou desative a instrumentação automática.
Instrumentação manual via API do agente
Se não for possível ativar a instrumentação automática, você ainda poderá incluir o agente browser manualmente usando a API do agente .NET da New Relic e incluindo o código apropriado em suas páginas.
Para fazer download do
NewRelic.Api.Agent.dll, execute novamente a instalação e faça referência ao.dll:No diretório do agente .NET do New Relic, selecione a seção do agente
New Relic.Net
e selecione
API Assembly
.
NuGet: instale e faça referência ao
.dll
executando
Install-package NewRelic.Agent.Api.
Para configurar seu aplicativo da web para chamar a API do agente .NET da New Relic, adicione uma referência a
NewRelic.Api.Agent.dllao seu projeto.Opcional: Se você estiver modificando o diretório do aplicativo implantado no servidor da web, copie
NewRelic.Api.Agent.dllno diretóriobindo aplicativo.Chame a API na sua tag
<head>. Se existir umatag com o atributoX-UA-COMPATIBLE http-equiv, defina-a depois dessa tag.
Instrumentação manual com copiar/colar
Ao habilitar o monitoramento do Browser, você pode inserir manualmente o trecho JavaScript nas páginas do seu aplicativo. A opção copiar/colar dá a você controle sobre o posicionamento exato do nosso trecho JavaScript, que é necessário para monitor o desempenho da página da web. Para instruções sobre como habilitar o monitoramento do Browser com copiar/colar, consulte nossa documentação do Browser.
Desabilitar instrumentação
Para desativar a instrumentação:
Resolução de problemas
Siga os procedimentos de resolução de problemas se você não conseguir visualizar nenhum dado de tempo do browser.
Habilitar a instrumentação automática do browser para o aplicativo web .NET Core v6+
Para habilitar a instrumentação automática do browser em aplicativos Web .NET Core v6+ (requer agente .NET v10.19.2 ou posterior):
Certifique-se de ter ativado a instrumentação automática globalmente editando
newrelic.confige definindo o sinalizadorbrowserMonitoringautoInstrumentcomotrue:<!-- enable auto instrumentation globally --><browserMonitoring autoInstrument="true"/>Habilite a instrumentação automática para aplicativos da web .NET Core 6+ editando
newrelic.confige adicionando um novo item na seçãoappSettings(ou adicione a seçãoappSettingsse ela não existir) - Observe que não é a mesma coisa como a seçãoappSettingsem um arquivoweb.config:<!-- enable .NET Core 6+ instrumentation --><appSettings><add key="EnableAspNetCore6PlusBrowserInjection" value="true" /></appSettings>
Recomendamos testes completos deste recurso em um ambiente não produção para garantir compatibilidade com sua aplicação web. Se você tiver algum problema com esse recurso, entre em contato conosco para obter suporte.