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.
El agente .NET de New Relic es compatible con .NET Framework y .NET Core. Este documento describe la compatibilidad y el soporte para entornos de ejecución, marcos y bibliotecas .NET.
El agente incluye instrumentación integrada para algunas de las partes más populares del ecosistema .NET, incluidos el marco, la base de datos y los sistemas de colas de mensajes. Después de descargar e instalar el agente, se ejecuta dentro del proceso del monitor. El agente no crea un proceso o servicio separado.
¿Quieres probar nuestro agente .NET? ¡ Crea una cuenta New Relic gratis! No se requiere tarjeta de crédito.
Requisitos
Antes de instalar el agente New Relic .NET en Windows o Linux, asegúrese de que su sistema cumpla con estos requisitos:
El agente .NET es compatible con .NET Core versión 3.1 y .NET 5.0, 6.0, 7.0, 8.0 y 9.0.
Importante
El agente solo es totalmente compatible cuando la aplicación instrumentada tiene como objetivo los tiempos de ejecución .NET actualmente soportados por Microsoft. Es probable que el agente funcione con los tiempos de ejecución EOL que se enumeran a continuación, pero no probamos nuevas versiones del agente con tiempos de ejecución EOL.
Versión .NET Core
Versión mínima requerida del agente .NET
.NET Core 3.1 (fin de vida útil)
8.21.34.0 y superior
.NET 5.0 (fin de vida útil)
8.35.0 y superior
.NET 6.0 (fin de vida útil)
9.2.0 y superior
.NET 7.0 (fin de vida útil)
10.0.0 y superior
.NET 8.0
10.0.0 y superior
.NET 9.0
10.0.0 y superior
Importante
En la plataforma Linux ARM64, el agente .NET solo admite versiones de .NET 5.0 o superiores.
Asegúrese de utilizar uno de estos servidores web/aplicaciones:
Cernícalo
Kestrel con proxy inverso IIS a través de AspNetCoreModule
Kestrel con proxy inverso IIS a través de AspNetCoreModuleV2
El agente requiere que su firewall permita conexiones salientes a redes y puertos específicos.
Se ha verificado que el agente trabaja con el siguiente sistema operativo:
Sistema operativo
Versiones compatibles
Windows (arquitectura compatible con Intel de 32 y 64 bits)
Servidor Windows 2008 R2 SP1
Servidor Windows 2012
Servidor Windows 2012 R2
Servidor Windows 2016
Servidor Windows 2019
Servidor Windows 2022
Windows 10
Windows 11
Contenedor de Windows ejecutándose en Server 2016 (no se admiten imágenes basadas en NanoServer)
Linux (solo compatible con Intel de 64 bits)
Todas las distribuciones de Linux x64 compatibles con el tiempo de ejecución de .NET Core 2.0+/.NET 5+ son compatibles con el agente .NET. Para obtener una lista completa, consulte la documentación de Microsoft para conocer la versión del tiempo de ejecución que está utilizando.
Linux (arquitectura ARM64/aarch64)
Todas las distribuciones de Linux ARM64 compatibles con el tiempo de ejecución de .NET 5+ son compatibles con el agente .NET, con las siguientes excepciones conocidas:
Linux alpino
La instalación y ejecución del agente .NET requiere estos permisos:
Componente
Permisos necesarios
Instalar el agente
El proceso o usuario que instala el agente debe tener permisos suficientes para configurar variables de entorno y acceso de escritura al directorio donde está instalado el agente.
Ejecute el agente
El proceso de supervisión debe tener acceso de lectura/escritura al directorio en el que instaló el agente. El agente se ejecuta como parte del proceso de supervisión y depende de esos permisos para funcionar.
Para aplicaciones que utilizan IIS a través de proxy inverso, se suele utilizar el grupo IIS_IUSRS .
El agente está disponible en versiones de 32 bits (x86) y 64 bits (x64) en Windows, así como en versiones de 64 bits (x64) y ARM64 (aarch64) en Linux.
Importante
En la plataforma Linux ARM64, el agente .NET solo admite versiones de .NET 5.0 o superiores.
El agente .NET es compatible con aplicaciones destinadas a .NET Core 3.1 y .NET 5.0, 6.0, 7.0, 8.0 y 9.0. Puede encontrar el framework objetivo en su archivo .csproj. La compatibilidad del agente varía según las diferentes versiones de .NET Core.
Compatible:
<TargetFramework>netcoreapp3.1</TargetFramework>
<TargetFramework>net5.0</TargetFramework>
<TargetFramework>net6.0</TargetFramework>
<TargetFramework>net7.0</TargetFramework>
<TargetFramework>net8.0</TargetFramework>
<TargetFramework>net9.0</TargetFramework>
Importante
En la plataforma Linux ARM64, el agente .NET only admite el marco objetivo de net5.0 o superior.
Si desea monitor una aplicación ASP.NET Core orientada al marco .NET, cerciorar de habilitar la compatibilidad con el marco .NET luego de instalar el agente .NET.
Instrumentación automática
Si su aplicación está alojada en ASP..NET Core, el agente crea e instrumenta automáticamente la transacción. El agente .NET instrumentó automáticamente su aplicación luego de la instalación. Si tu app no está instrumentada automáticamente, o si deseas agregar instrumentación, usa instrumentación personalizada.
El agente .NET instrumentó automáticamente este marco de aplicación:
ASP..NET Core MVC 2.0, 2.1, 2.2, 3.0, 3.1, 5.0, 6.0, 7.0, 8.0 y 9.0 (incluye API sitio web)
ASP..NET Core Razor Pages 6.0, 7.0 y 8.0 (a partir de la versión 10.19.0 del agente .NET)
El agente .NET instrumentó automáticamente el rendimiento de las llamadas de la aplicación .NET a estos almacenes de datos:
Última versión compatible verificada: 4.0.0-preview.4
Versión mínima del agente requerida: 10.33.0
El agente .NET no monitor directamente los procesos de almacenamiento de datos. Además, la captura de parámetros .NET SQL en una traza de consulta no enumera parámetros para una consulta parametrizada o un procedimiento almacenado.
La recopilación de detalles de instancia para almacenes de datos admitidos está habilitada de forma predeterminada. Para solicitar información a nivel de instancia de almacenes de datos que no figuran actualmente en la lista, obtenga soporte en support.newrelic.com.
Si su almacenamiento de datos no aparece aquí, puede agregar instrumentación personalizada empleando el método RecordDatastoreSegment en la API del agente .NET.
El agente .NET instrumentó automáticamente esta biblioteca de llamadas externas:
Bibliotecas
Supported methods
Cliente HTTP
El agente instrumentó estos métodos HttpClient:
SendAsync
GetAsync
PostAsync
PutAsync
DeleteAsync
GetStringAsync
GetStreamAsync
GetByteArrayAsync
El agente .NET se puede configurar para instrumentar automáticamente estos marcos LLM:
El agente .NET no admite el despliegue nativo anticipado (AOT) para aplicaciones .NET porque se requiere la compilación justo a tiempo (JIT) para que el agente funcione correctamente.
Conecte el agente a otros productos New Relic
Además de APM, el agente .NET se integra con otros productos New Relic para brindarle visibilidad de un extremo a otro:
Para ASP..NET Core v6.0 y aplicaciones web posteriores (MVC, Razor y Blazor), el agente .NET (a partir de la versión 10.19.0) inyecta automáticamente el agente JavaScript del navegador cuando habilita la instrumentación automática.
Después de habilitar la inyección browser , puede ver los datos del navegador en la página Resumen de APM y cambiar rápidamente entre el APM y los datos del navegador para una aplicación en particular. Para opciones de configuración e instrumentación manual, consulte monitoreo del navegador y el agente .NET.
Cuando instalas la infraestructura y el agente APM en el mismo host, se detectan automáticamente entre sí. Luego puede ver una lista de hosts en la UI de APM y filtrar los hosts de su infraestructura por aplicación APM en nuestra UI de infraestructura. Para obtener más información, consulte Datos de APM en la UI de la infraestructura.
Para ejecutar la aplicación en .NET Framework 4.6.2 o superior, debe ejecutar New Relic .NET agent 10.0 o superior. Para ejecutar una aplicación en .NET Framework versión 4.0 o anterior, debe ejecutar una versión del agente New Relic .NET anterior a 7.0. Para obtener más información y procedimientos de descarga, consulte Soporte técnico para .NET Framework 4.0 o anterior.
The .NET agent doesn't support .NET Framework versions 4.5.1, 4.5.2, and 4.6.1
El agente .NET carga datos al final de cada ciclo de recolección (una vez por minuto). Si su aplicación .NET no se ejecuta durante tanto tiempo, puede configurar el atributo sendDataOnExit de service element en true en el archivo newrelic.config .
Debe utilizar uno de estos servidores web/aplicaciones:
IIS
OWIN autohospedado
WCF autohospedado
Cernícalo
Kestrel con proxy inverso IIS a través de AspNetCoreModule
Kestrel con proxy inverso IIS a través de AspNetCoreModuleV2
El agente crea automáticamente transacciones para aplicaciones alojadas en IIS. Si se autohospeda con WCF y OWIN versión 3 o superior, el agente también crea transacciones automáticamente. Para otros servicios autohospedados, deberá crear transacciones mediante instrumentación personalizada.
El agente requiere CLR versión 4.0. La aplicación legacy que se ejecuta en CLR 2.0 se puede instrumentar con versiones del agente inferiores a 7.0.
El uso de Code Access Security es compatible con el agente .NET solo cuando se proporciona Full Trust. El agente no es compatible con niveles de confianza más restrictivos.
El agente requiere que su firewall permita conexiones salientes a redes y puertos específicos.
El agente requiere uno de estos sistema operativo:
Servidor Windows 2008
Servidor Windows 2008 R2
Servidor Windows 2012
Servidor Windows 2012 R2
Servidor Windows 2016
Servidor Windows 2019
Servidor Windows 2022
Windows 10
Windows 11
Windows Azure (familia de sistemas operativos 1, 2 y 3)
Contenedor de Windows que se ejecuta en Windows 2016 (no se admiten imágenes basadas en NanoServer)
La instalación requiere privilegios elevados (administrador). Por ejemplo, puedes:
Inicie sesión como usuario administrador.
Ser miembro del grupo administrador.
En el sistema operativo más nuevo, proporcione credenciales de elevación cuando aparezca el símbolo.
El proceso de supervisión debe tener acceso de lectura/escritura al directorio en el que está instalado el agente. El agente se ejecuta como parte del proceso de supervisión y depende de esos permisos para funcionar.
Recommendation:
Restrinja los permisos para el archivo newrelic.config y otorgue acceso de lectura/escritura solo al propietario del proceso de supervisión.
Revisar los permisos del log creado por el agente para minimizar la cantidad de usuarios con acceso y sus privilegios.
El agente está disponible en versiones de 32 y 64 bits. En sistemas de 64 bits, el agente de 64 bits puede implementar aplicaciones de 32 y 64 bits.
.NET Common Language Runtime (CLR) solo permite que un generador de perfiles acceda a la API de creación de perfiles de un proceso en un momento dado. Ejecutar nuestro agente .NET junto con otro software de monitoreo resultará en un conflicto generador de perfiles. Para obtener más información, consulte Errores al utilizar otro software APM.
Instrumentación automática
Si su aplicación está alojada en ASP.NET u otro frameworktotalmente compatible, el agente .NET instrumentará automáticamente su aplicación luego de la instalación. Si su aplicación no está instrumentada automáticamente, o si desea agregar instrumentación, use instrumentación personalizada.
El agente .NET no monitor directamente los procesos de almacenamiento de datos. Además, de forma predeterminada, la captura de parámetros .NET SQL en una consulta traza no enumera los parámetros para una consulta parametrizada o un procedimiento almacenado. La recopilación del parámetro de consulta SQL se puede habilitar en la configuración del agente.
El agente instrumentó automáticamente algunos marcos de aplicación; nos referimos a estos marcos como fully supported, que se enumeran a continuación:
ASP.NET MVC 2
ASP.NET MVC 3
ASP.NET MVC 4
ASP.NET MVC 5
API web ASP.NET v2
ASP..NET Core MVC 2.0
ASP..NET Core 2.1
ASP..NET Core 2.2
Formularios web ASP.NET
Castle MonoRail v2 (ya no es compatible con la versión 10.0 o superior del agente .NET)
Aplicación API web alojada en OWIN en .NET framework usando:
La instrumentación WCF se probó para los siguientestipos de enlaces comunes (tanto de cliente como de servicio). Hay disponibles distintos niveles de soporte para el rastreo distribuido (DT) y el rastreo multiaplicación (CAT):
Vinculante
Soporte rastreo distribuido (DT)
Soporte de seguimiento de múltiples aplicaciones (CAT) (obsoleto)
HTTP básico
soportado
soportado
WebHTTP
soportado
soportado
WSHTTP
soportado
soportado
NetTCP
soportado
soportado
NetNamedPipe
No soportado*
No soportado*
NetMSMQ
No soportado*
No soportado*
* rastreo distribuido puede implementarse manualmente utilizando estos métodos API de rastreo distribuido .
La recopilación de detalles de instancia para almacenes de datos compatibles requiere la versión 6.5.29.0 o superior del agente .NET y está habilitada de forma predeterminada. Para solicitar información a nivel de instancia de almacenes de datos que no figuran actualmente en la lista, obtenga soporte en el centro de soporte de New Relic.
Para instrumentar automáticamente el rendimiento de las llamadas de la aplicación .NET framework a estos almacenes de datos, asegúrese de tener la versión 8.14 o superior del agente .NET:
Última versión compatible verificada: 4.0.40
Versiones incompatibles conocidas: 4.0.44 o superior
Última versión compatible verificada: 4.0.0-preview.4
Versión mínima del agente requerida: 10.33.0
Si su almacenamiento de datos no aparece aquí, puede agregar instrumentación personalizada empleando el método RecordDatastoreSegment en la API del agente .NET.
El agente instrumentó automáticamente el sistema de gestión de contenidos EPiServer .
El agente instrumentó automáticamente estas bibliotecas de llamadas externas:
El agente instrumentó automáticamente estos sistemas de mensajes:
Bibliotecas
Supported methods
Confluent.Kafka
Producir y consumir sobre temas.
Se instrumentan los siguientes métodos:
IProducer.Produce
IProducer.ProduceAsync
IConsumer.Consume
Versión mínima admitida: 1.4.0
Última versión compatible verificada: 2.5.3
MSMQ
Envío y recepción de mensajes, visualización de colas y purga
NServicioBus
Pone y recibe mensajes.
Versión mínima soportada: 5.0
Última versión compatible verificada: 8.2.4
RabbitMQ
Coloca y recibe mensajes y elimina colas.
Al recibir mensajes utilizando un IBasicConsumer, el EventingBasicConsumer es la única implementación instrumentada por el agente .NET.
BasicGet Está instrumentado, pero el agente no soporta rastreo distribuido para BasicGet.
Se instrumentan los siguientes métodos:
IModel.BasicGet
IModel.BasicPublish
IModel.BasicConsume
IModel.QueuePurge
EventingBasicConsumer.HandleBasicDeliver
Versión mínima soportada: 3.5.2
Última versión compatible verificada: 6.6.0
MassTransit (versiones del agente 10.19.0 y posteriores)
Publicar/enviar y consumir mensajes
Versión mínima soportada: 7.1.0
Última versión compatible verificada: 8.2.5
AWSSDK.SQS (Amazon Simple Queue Service) (versiones del agente 10.27.0 y posteriores)
Enviar y recibir mensajes
Versión mínima compatible: 3.7.0
Última versión compatible verificada: 3.7.400.33
Los lenguajes y tecnologías .NET enumerados son compatibles con nuestro panel de observabilidad instantánea . Si utiliza alguno de estos lenguajes o tecnologías, puede ver sus datos en un dashboard de New Relic, listo para usar:
Idioma/tecnología
Configuración adicional
Aplicación c#
New Relic puede instrumentar automáticamente servicios escritos en C#. Vaya a nuestra página de inicio rápido de C# para instalar el panel de C#.
ADO.net
Si su aplicación utiliza ADO.net, puede instalar una combinación de agente New Relic que genera un dashboard de ADO.net. Esto es lo que debes hacer:
Instale el agente New Relic APM .NET y el agente de infraestructura siguiendo los pasos de nuestra instalación guiada.
Desde one.newrelic.com, vaya a APM & services y luego seleccione su aplicación. Para comprobar que su instalación es exitosa, consulte lo siguiente:
FROMTransactionSELECTcount(*) FACET request.uri
Si aparecen datos, ha instrumentado su aplicación correctamente.
Estos marcos no son totalmente compatibles:
ASP.NET Web API v1: Consulte la información sobre resolución de problemas sobre el uso de ASP.NET Web API v1 con el agente .NET 5.0 o superior de New Relic para aplicaciones orientadas a .NET framework 4.0. (Esto no afecta a .NET framework 4.5 o superior).
Mono: New Relic no es compatible con Mono, un framework .NET de código abierto que se ejecuta en Linux. Esto se debe a que no existe una API Profiler para inyectar en el agente .NET como generador de perfiles en la aplicación .NET basada en Mono. La API del generador de perfiles es una interfaz basada en el modelo de objetos componentes (COM) y no es compatible con Linux.
ASP clásico es not supported, porque el agente solo puede implementar aplicaciones basadas en .NET framework .
SharePoint es not supported.
Característica no disponible
La compilación justo a tiempo (JIT) es un requisito para la funcionalidad del agente .NET, por lo que el agente .NET no admite las imágenes nativas creadas con Native Image Generator (NGEN) .
Conecte el agente a otros productos New Relic
Además de APM, el agente se integra con otros productos de New Relic para brindarle visibilidad de un extremo a otro:
Para la aplicación web ASP.NET, el agente .NET inyecta automáticamente el agente JavaScript del navegador cuando habilita la instrumentación automática.
Después de habilitar la inyección browser , puede ver los datos del navegador en la página Resumen de APM y cambiar rápidamente entre los datos y de una aplicación en particular. Para opciones de configuración e instrumentación manual, consulte monitoreo del navegador y el agente .NET.
Cuando instalas la infraestructura y el agente APM en el mismo host, se detectan automáticamente entre sí. Luego puede ver una lista de hosts en la UI de APM y filtrar sus hosts por aplicación de APM en nuestra UI de infraestructura. Para obtener más información, consulte Datos de APM en UI de infraestructura.