Con el agente .NET, puede agregar instrumentación a sus páginas web. Antes de utilizar browser con su agente .NET, consulte las notas de la versión del agente .NET y asegúrese de tener instalada la última versión del agente .NET.
Siga los requisitos del agente .NET para instalar el monitoreo del navegador. Luego siga los procedimientos de este documento para instrumentar manualmente el agente .NET.
Instrumentacion automatica
Importante
La instrumentación automática solo está disponible para aplicaciones web .NET framework y aplicaciones web .NET Core v6.0 y posteriores. La instrumentación automática no está disponible para ASP..NET Core v5.0 y aplicaciones anteriores, incluso si están supervisadas por el agente .NET.
Con la instrumentación automática browser , el agente .NET inyecta automáticamente el encabezado JavaScript browser en cualquier página que tenga un content-type de text/html y también tenga una etiqueta <head> dentro de la página. La instrumentación automáticabrowser está habilitada de forma predeterminada para las aplicaciones web .NET framework , pero está deshabilitada de forma predeterminada para las aplicaciones web .NET Core v6 y posteriores. Consulte Habilitación de la instrumentación automática browser para .NET Core v6+ para obtener más información.
La búsqueda de etiquetas <head> comienza al principio del DOM. El agente .NET inyecta el encabezado JavaScript agregando un HttpModule que modifica la página usando filtros de respuesta HTTP antes de transmitir el contenido al usuario.
La primera vez que habilita la instrumentación automática, es posible que necesite limpiar su directorio de caché asp.net para que se vuelvan a compilar las páginas aspx. Utilice el siguiente comando:
$flush_dotnet_temp.cmdCon esta inyección, las páginas que funcionaban anteriormente pueden dejar de funcionar si un content-type no está configurado correctamente. Para corregir, revisa y actualiza el content-types en tu aplicación o desactiva la instrumentación automática.
Instrumentación manual vía agente API
Si no puede habilitar la instrumentación automática, aún puede incluir el agente del navegador manualmente utilizando la API del agente .NET de New Relic e incluyendo el código apropiado en sus páginas.
Para descargar
NewRelic.Api.Agent.dll, vuelva a ejecutar la instalación y haga referencia a.dll:En el directorio del agente New Relic .NET, seleccione la sección del agente
New Relic.Net
y luego seleccione
API Assembly
.
NuGet: instale y haga referencia a
.dll
ejecutando
Install-package NewRelic.Agent.Api.
Para configurar su aplicación web para llamar a la API del agente New Relic .NET, agregue una referencia a
NewRelic.Api.Agent.dlla su proyecto.Opcional: si está modificando el directorio de la aplicación desplegar en el servidor web, copie
NewRelic.Api.Agent.dllen el directoriobinde la aplicación.Llame a la API en su etiqueta
<head>. Si existe una metaetiqueta con el atributoX-UA-COMPATIBLE http-equiv, configúrela después de esa metaetiqueta.
Instrumentación manual con copiar/pegar
Al habilitar el monitoreo del navegador, puede insertar manualmente el fragmento de JavaScript en las páginas web de su aplicación. La opción copiar/pegar le brinda control sobre la ubicación exacta de nuestro fragmento de JavaScript, que es necesario para monitor el rendimiento de la página web. Para obtener instrucciones sobre cómo habilitar el monitoreo del navegador con copiar y pegar, consulte nuestra documentación del navegador.
Deshabilitar instrumentación
Para desactivar la instrumentación:
Resolución de problemas
Siga los procedimientos de resolución de problemas si no puede ver ningún dato de tiempo browser .
Habilite la instrumentación automática browser para la aplicación web .NET Core v6+
Para habilitar la instrumentación automática browser en aplicaciones web .NET Core v6+ (requiere el agente .NET v10.19.2 o posterior):
Asegúrese de haber habilitado la instrumentación automática globalmente editando
newrelic.configy configurando el indicadorbrowserMonitoringautoInstrumententrue:<!-- enable auto instrumentation globally --><browserMonitoring autoInstrument="true"/>Habilite la instrumentación automática para aplicaciones web .NET Core 6+ editando
newrelic.configy agregando un nuevo elemento en la secciónappSettings(o agregue la secciónappSettingssi no existe). Tenga en cuenta que no es lo mismo como la secciónappSettingsen un archivoweb.config:<!-- enable .NET Core 6+ instrumentation --><appSettings><add key="EnableAspNetCore6PlusBrowserInjection" value="true" /></appSettings>
Recomendamos realizar pruebas exhaustivas de esta característica en un entorno sin producción para garantizar la compatibilidad con su aplicación web. Si tiene algún problema con esta característica, contáctenos para obtener ayuda.