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> dentro da página. A instrumentação automática browser está habilitada por padrão.
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 essa injeção, páginas que funcionavam anteriormente podem parar de funcionar se um content-type não for definido corretamente. Para corrigir, revise e atualize o content-types em 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.