Te ofrecemos esta traducción automática para facilitar la lectura.
En caso de que haya discrepancias entre la versión en inglés y la versión traducida, se entiende que prevalece la versión en inglés. Visita esta página para obtener más información.
Consulte las notas de la versión para encontrar la última versión del agente.
Verifique la versión del agente .NET que tiene instalado actualmente usando
Windows Programs and Features
o usando su administrador de paquetes de Linux.
Antes de que empieces
Hay varias formas de instalar el agente .NET, lo que significa que hay varias formas de actualizarlo. En este documento, nos centramos en los procedimientos de actualización para la instalación más sencilla, con el agente .NET instalado directamente en un host Windows o Linux.
Si tiene otras instalaciones, consulte estos documentos de instalación para esas configuraciones para obtener más contexto:
derechos en su grupo de administración de Windows. Para obtener más información, consulte la documentación de permisos.
Si la versión de su agente es inferior a 7.0 o está utilizando la versión 4.0 o inferior de .NET framework , consulte Actualización del agente .NET legacy.
Si su aplicación está alojada en IIS, asegúrese de
Una vez finalizado el paquete del instalador, inicie IIS.
Actualizar el agente .NET (Linux)
Importante
Para las versiones 10.0.0 o superiores del agente .NET, el nombre del paquete es newrelic-dotnet-agent. Para las versiones 9.9.0 o inferiores del agente .NET, el nombre del paquete es newrelic-netcore20-agent. El resto de este documento hace referencia a newrelic-dotnet-agent; reemplácelo con el nombre anterior si tiene instalada una versión anterior del agente. Cuando actualice a la versión 10.0.0 o superior desde una inferior, deberá cambiar las variables de entorno CORECLR_NEWRELIC_HOME y CORECLR_PROFILER_PATH debido al cambio de nombre del paquete.
Utilice uno de los siguientes métodos para actualizar a la última versión del agente .NET de New Relic:
Actualizar agente de .NET framework anterior (inferior a 7.0)
Si está pensando en actualizar una versión del agente de .NET framework inferior a 7.0, revise las siguientes notas. Para ver la versión del agente que tiene, consulte Comprobar la versión del agente. Para obtener una lista completa de los cambios del agente, consulte las notas de la versión de .NET.
Importante
Para implementar una aplicación dirigida a .NET framework 4.0 o anterior, debe utilizar una versión del agente de .NET framework anterior a 7.0. Consulte soporte para .NET Frameworks 4.0 o anterior para obtener más información.
Si la versión es inferior a...
Hacer esto...
7.0
La versión 7.0 y superior del agente de .NET framework admite aplicaciones que tienen como objetivo .NET framework 4.5 o superior.
6.12
Las versiones 6.12 o superiores no son compatibles con Windows Server 2003. Si necesita Windows Server 2003, utilice las versiones 6.11 o inferiores. Para obtener más información, obtenga soporte en support.newrelic.com o descargue el agente.
6.11
Anteriormente, la base de datos y las llamadas externas que ocurrían fuera de una transacción generaban métricas que se podían ver en sus respectivas páginas en la UI de APM. Ahora estas métricas no se mostrarán. En una aplicación no web estas llamadas se pueden "envolver" en una transacción personalizada para poder ver su métrica.
6.0
Para obtener soporte asíncrono si la versión de su agente .NET es anterior a la 6.0, haga lo siguiente según corresponda:
Elimine la siguiente configuración de la aplicación en newrelic.config si existe:
<appSettings>
<addkey="AsyncMode"value="false"/>
</appSettings>
Asegúrese de que el host de su aplicación tenga instalado .NET 4.5 o superior.
Dígale a .NET que use el nuevo pipeline de procesamiento de solicitudes ASP agregando las siguientes líneas a su web.config:
Las métricas que no forman parte de una transacción no se mostrarán en la UI. Exception: Puede ver la base de datos y las métricas externas en sus respectivas páginas en la UI de APM. Otras métricas similares (como los métodos instrumentados) se pueden hacer visibles "envolviéndolas" en una transacción personalizada.
New Relic mejoró el nombre de las transacciones. Sin embargo, estos cambios pueden afectar los nombres de las transacciones de las métricas existentes, incluida la clave de transacción, la métrica "alerta sobre cualquier cosa" y la consulta basada en los nombres de las transacciones. Debe volver a crear esta configuración utilizando el nuevo nombre de transacción después de la actualización.
4.2
New Relic eliminó la transacción HTTP "externa" (".svc") para la aplicación WCF alojada con el modo de compatibilidad asp.net deshabilitado. Ahora solo se informa la transacción WCF.
Este cambio da como resultado datos de rendimiento más precisos. También evita que se informen errores de código de estado HTTP por transacción WCF fallida.
4.1
New Relic implementó almacenamiento de datos métricos para traza SQL. Los nombres métricos para la actividad de la base de datos se actualizaron para informar bajo almacenamiento de datos.
4.0
La aplicación MVC2 ya no genera segmentos específicos de MVC ni tiene nombres de transacciones basados en rutas MVC.
3.0
El agente .NET de New Relic pasó a depender de .NET 3.5. Su aplicación aún puede tener como objetivo .NET 2.0, pero debe tener .NET 3.5 instalado en la computadora en la que se ejecuta el agente.
2.20
La versión 2.19.3.0 fue la última versión del agente .NET que requirió la API de llamada GetBrowserTimingFooter() y GetBrowserTimingHeader() para . En la versión del agente 2.20.24.0 o superior, solo necesita llamar GetBrowserTimingHeader(). GetBrowserTimingFooter() no tiene ningún efecto. Recommendation: Elimine estas referencias de su código.
2.9
El archivo de configuración cambió de newrelic.xml a newrelic.config. El instalador del agente más nuevo intenta convertir newrelic.xml (si está presente) en newrelic.config.
2.2 o anterior
Para actualizar desde una versión del agente .NET inferior a 2.2, debe desinstalar el agente antiguo antes de instalar la nueva versión. Siga los procedimientos estándar para su versión de Windows para desinstalar el agente. Es posible que su sistema operativo requiera un reinicio.
Es posible que experimente cocreateinstance errores con services.exe cuando actualice un instalador antiguo (2.1.3.494 o anterior) o realice otros cambios en las variables de entorno. Para resolver este problema, consulte la documentación de Microsoft.