.NET compatibilidad del agente y requisitos para .NET framework

Nuestro agente .NET es compatible tanto con .NET framework como con .NET Core. Aquí describimos la compatibilidad y el soporte para la aplicación .NET framework . Para .NET Core, consulte Compatibilidad y requisitos para .NET Core.

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.

Para el marco y la biblioteca que no se instrumentan automáticamente, puede ampliar el agente con instrumentación personalizada de .NET.

¿Quieres probar el agente .NET de New Relic? ¡ Crea una cuenta New Relic gratis! No se requiere tarjeta de crédito.

Requisitos

Antes de instalar el agente .NET de New Relic, asegúrese de que su sistema cumpla con estos requisitos:

AVISO EOL

Microsoft anunció oficialmente el fin de vida útil de las versiones 4.5.1, 4.5.2 y 4.6.1 de .NET framework el 26 de abril de 2022.

Puede encontrar el blog informativo en el sitio de blogs de Microsoft. Puede encontrar las fechas oficiales de inicio y finalización del ciclo de vida del producto en la documentación de Microsoft.

Nuestro soporte de agente .NET para estas versiones de framework finaliza con el último agente .NET 9.x New Relic. A partir de la versión 10.0 del agente New Relic .NET, apuntaremos a .NET framework 4.6.2 adelante. Para obtener más detalles, incluido cómo prepararse fácilmente para esta transición, consulte nuestra publicación en el Foro de soporte.

.NET Framework 4.6.2 or higher

.NET framework 4.6.2 o superior requiere la versión 7.0 o superior del agente New Relic .NET.

.NET Framework 4.5.1, 4.5.2, and 4.6.1

Para una aplicación de instrumento que se ejecuta en .NET framework 4.5.1, 4.5.2 o 4.6.1, debe ejecutar una versión del agente New Relic .NET inferior a 10.0 pero no inferior a 7.0.

.NET Framework 4.0 or lower

Para que la aplicación de instrumento se ejecute en .NET framework versión 4.0 o inferior, debe ejecutar una versión del agente New Relic .NET inferior a 7.0. Para obtener más información y procedimientos de descarga, consulte Soporte técnico para .NET framework 4.0 o inferior.

Aquí hay detalles adicionales sobre las versiones 4.0 o inferiores de .NET framework :

Versión framework .NET	Notas
Framework .NET 2.0	A menos que haya instalado only .NET framework 4.0 o superior, must tiene instalada la versión 3.5 de .NET framework en el host de destino, además de cualquier otra versión de .NET framework que haya instalado.
Framework .NET 3.0	A menos que haya instalado only .NET framework 4.0 o superior, must tiene instalada la versión 3.5 de .NET framework en el host de destino, además de cualquier otra versión de .NET framework que haya instalado.
Framework .NET 3.5	Totalmente compatible con versiones del agente .NET inferiores a 7.0.
Framework .NET 4.0	Totalmente compatible con versiones del agente .NET inferiores a 7.0.

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.

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.

Instrumentación automática

Si su aplicación está alojada en ASP.NET u otro framework totalmente compatible, el agente .NET implementará automáticamente su aplicación después 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 algún marco de aplicación; Nos referimos a estos marcos como fully supported.

Compatibility status

.NET app frameworks

Totalmente compatible

Estos marcos are fully supported:

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:
- Microsoft.Owin.Host.HttpListener v2.x
- Microsoft.Owin.Host.HttpListener v3.x
- Microsoft.Owin.Host.HttpListener v4.x
Servicios web basados en SOAP

WCF

Hosting Models
- IIS alojado (con y sin compatibilidad ASP)
- Autohospedado

Binding Types (tanto cliente como servicio)
La instrumentación WCF se ha probado para los siguientes tipos de enlaces comunes. Hay distintos niveles de soporte disponibles para rastreo distribuido (DT) y 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 .

Invocation Methods (tanto cliente como servicio)
- Sincrónico
- Modelo de procesamiento asincrónico (APM) Inicio/Fin
- Procesamiento asincrónico de tareas (TAP)
- Procesamiento asincrónico basado en eventos (EAP)
  - Solo soporte al cliente.

No totalmente compatible

Estos marcos son not fully supported:

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.

No soportado

ASP clásico es not supported, porque el agente solo puede implementar aplicaciones basadas en .NET framework .

SharePoint es not supported.

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:

Versiones compatibles verificadas: 4.0.40

Versiones incompatibles conocidas: 4.0.44 o superior

Almacenamiento de datos	Detalles de la instancia	Otras notas
Cosmos DB		El agente .NET `v9.2.0` o superior instrumenta automáticamente la biblioteca Microsoft.Azure.Cosmos . Versión mínima admitida: 3.17.0 Versiones compatibles verificadas: 3.17.0, 3.23.0
Base del sofá		Utilice CouchbaseNetClient. Versión mínima admitida: 2.0.0 Versiones compatibles verificadas: 2.3.8 Versiones incompatibles conocidas: 2.4.0+ Con Couchbase, lo siguiente no está instrumentado de forma predeterminada a favor de sus homólogos de múltiples documentos: `Get(string key)` `GetDocument(string key)` `Remove(string key)` `Remove(string key, ulong cas)` `Upsert<T>(string key, T value)`
DB2
Servidor Microsoft SQL		Utilice SqlClient del paquete System.Data.SqlClient NuGet o del paquete Microsoft.Data.SqlClient NuGet o del ensamblado System.Data integrado en framework . System.Data.SqlClient Versión mínima admitida: 4.4.0 Versiones compatibles verificadas: 4.4.0, 4.6.1, 4.7.0, 4.8.4, 4.8.5, 4.8.6 Microsoft.Data.SqlClient Versión mínima admitida: 1.0.19239.1 Versiones compatibles verificadas: 1.0.19239.1, 2.1.5, 3.1.1, 4.1.1, 5.0.1, 5.1.1, 5.2.0 System.Data Versión mínima admitida: .NET framework 4.6.2 Versiones compatibles verificadas: .NET framework 4.6.2, 4.7.1, 4.8
MongoDB (controlador legacy )		Versión mínima admitida: 1.10.0 Versiones compatibles verificadas: 1.10.0 Versiones incompatibles conocidas: los detalles de la instancia no están disponibles en la versión 2 anterior.
MongoDB (controlador moderno)		Versión mínima admitida: 2.3.0 Versiones compatibles verificadas: 2.3.0, 2.8.1, 2.13.1, 2.14.1, 2.17.1, 2.19.0, 2.20.0, 2.21.0, 2.22.0, 2.23.0, 2.23.1. 2.24.0 A partir de la versión 10.12.0 del agente, se instrumentan los siguientes métodos agregados en la versión 2.7 del controlador o después: `IMongoCollection.CountDocuments[Async]` `IMongoCollection.EstimatedDocumentCount[Async]` `IMongoCollection.AggregateToCollection[Async]` `IMongoDatabase.ListCollectionNames[Async]` `IMongoDatabase.Aggregate[Async]` `IMongoDatabase.AggregateToCollection[Async]` `IMongoDatabase.Watch[Async]`
MySQL		Utilice MySQL.Data o MySQL Connector MySql.Data Versión mínima admitida: 6.10.7 Versiones compatibles verificadas: 6.10.7, 8.0.15, 8.0.30, 8.0.33, 8.1.0, 8.2.0, 8.3.0 MySqlConnector Versión mínima admitida: 1.0.1 Versiones compatibles verificadas: 1.0.1, 1.3.13, 2.1.2, 2.3.1, 2.3.3, 2.3.5
Oracle
PostgreSQL		Utilice Npgsql Versión mínima soportada: 4.0.0 Versiones compatibles verificadas: 4.0.5 También se pueden instrumentar versiones anteriores de Npgsql, pero es posible que haya duplicados y/o faltan métricas.
ServiceStack.Redis
StackExchange.Redis		Versión mínima admitida: 1.0.488 Versiones compatibles verificadas: 1.0.488, 1.1.608, 1.2.6, 2.0.601, 2.1.58, 2.2.88, 2.6.66, 2.6.116, 2.7.4, 2.7.10, 2.7.17, 2.7.33
Elasticsearch		Utilice Elastic.Clients.Elasticsearch, NEST o Elasticsearch.Net. Elastic.Clients.Elasticsearch Versión mínima admitida: 8.0.0 Versiones compatibles verificadas: 8.0.0, 8.1.0, 8.1.1, 8.9.1, 8.9.2, 8.9.3, 8.10.0, 8.11.0, 8.12.0 Se admiten las versiones 8.10.0 y superiores a partir del agente .NET v10.20.1 NEST Versión mínima soportada: 7.0.0 Versiones compatibles verificadas: 7.0.0, 7.17.5 Elasticsearch.Net Versión mínima soportada: 7.0.0 Versiones compatibles verificadas: 7.0.0, 7.17.5

El agente instrumentó automáticamente estas bibliotecas de llamadas externas:

Bibliotecas	Supported methods
Cliente HTTP	El agente instrumentó estos métodos HttpClient: `SendAsync` `GetAsync` `PostAsync` `PutAsync` `DeleteAsync` `GetStringAsync` `GetStreamAsync` `GetByteArrayAsync`
Descanso agudo	El agente instrumentó estos métodos RestSharp: `ExecuteTaskAsync` `ExecuteGetTaskAsync` `ExecutePostTaskAsync` `Execute` `ExecuteAsGet` `ExecuteAsPost` `DownloadData` Versión mínima admitida: 105.2.3 Versiones compatibles verificadas: 105.2.3, 106.0.0, 106.6.10, 106.11.0, 106.12.0, 106.13.0, 106.15.0, 107.3.0, 108.0.3, 109.0.1 Versiones incompatibles conocidas: 106.8.0, 106.9.0, 106.10.0, 106.10.1
Solicitud HttpWeb	El agente instrumentó estos métodos HttpWebRequest: `GetResponse`

Bibliotecas

Supported methods

Cliente HTTP

El agente instrumentó estos métodos HttpClient:

SendAsync
GetAsync
PostAsync
PutAsync
DeleteAsync
GetStringAsync
GetStreamAsync
GetByteArrayAsync

Descanso agudo

El agente instrumentó estos métodos RestSharp:

ExecuteTaskAsync
ExecuteGetTaskAsync
ExecutePostTaskAsync
Execute
ExecuteAsGet
ExecuteAsPost
DownloadData
Versión mínima admitida: 105.2.3
Versiones compatibles verificadas: 105.2.3, 106.0.0, 106.6.10, 106.11.0, 106.12.0, 106.13.0, 106.15.0, 107.3.0, 108.0.3, 109.0.1
Versiones incompatibles conocidas: 106.8.0, 106.9.0, 106.10.0, 106.10.1

Solicitud HttpWeb

El agente instrumentó estos métodos HttpWebRequest:

GetResponse

El agente .NET se puede configurar para instrumentar automáticamente este marco de registro para un contexto de inicio de sesión automático con reenvío de agente y decoración log local:

Frameworks	Versión mínima framework	Versión mínima del agente	Versiones compatibles verificadas
Log4Net	1.2.10	9.7.0	1.2.10, 2.0.5, 2.0.14, 2.0.16
Serilog	2.0.0	9.7.0	1.5.14, 2.5.0, 2.10.0, 3.0.1, 3.1.1
NLog	4.1.0	9.7.0	4.1.2, 4.3.11, 4.5.11, 5.2.0, 5.2.2, 5.2.3, 5.2.4, 5.2.5, 5.2.6, 5.2.7, 5.2.8
Microsoft.Extensions.Logging	3.0.0	9.7.0

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 Versiones compatibles verificadas: 1.4.0, 2.2.0
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
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 Versiones compatibles verificadas: 3.5.2, 5.1.0, 6.2.1, 3.6.9, 4.1.3, 5.2.0, 6.0.0, 6.2.1, 6.4.0, 6.5.0, 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 Versiones compatibles verificadas: 7.1.0, 7.3.1, 8.1.1

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. Instale la integración en el host de Microsoft Windows Perfmon/WMI para New Relic Infrastructure siguiendo las instrucciones de nri-perfmon. Si instaló Perfmon manualmente, reinicie su agente de infraestructura. Vaya a nuestra página de inicio rápido de ADO.NET para instalar el panel de ADO.NET.
Servidor Blazor	Realice un seguimiento de sus datos más importantes en nuestro dashboard de Blazor Server instrumentando su aplicación con New Relic: Instale el agente New Relic APM .NET y el agente de infraestructura siguiendo los pasos de nuestra instalación guiada. Si lo prefiere, puede instalar el agente de infraestructura a través de la línea de comando. Obtenga el dashboard prediseñado instalando el inicio rápido de Blazor 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: `FROM Transaction SELECT count(*) FACET request.uri` Si aparecen datos, ha instrumentado su aplicación correctamente.

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.
Instale la integración en el host de Microsoft Windows Perfmon/WMI para New Relic Infrastructure siguiendo las instrucciones de nri-perfmon.
Si instaló Perfmon manualmente, reinicie su agente de infraestructura.
Vaya a nuestra página de inicio rápido de ADO.NET para instalar el panel de ADO.NET.

Servidor Blazor

Realice un seguimiento de sus datos más importantes en nuestro dashboard de Blazor Server instrumentando su aplicación con New Relic:

Instale el agente New Relic APM .NET y el agente de infraestructura siguiendo los pasos de nuestra instalación guiada. Si lo prefiere, puede instalar el agente de infraestructura a través de la línea de comando.
Obtenga el dashboard prediseñado instalando el inicio rápido de Blazor
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:
```
FROM Transaction SELECT count(*) FACET request.uri
```
Si aparecen datos, ha instrumentado su aplicación correctamente.

El agente .NET se puede configurar para instrumentar automáticamente estos marcos LLM:

Frameworks	Versión mínima framework	Versión mínima del agente	Versiones compatibles verificadas
AWS Bedrock	3.7.200.0	10.23.0	3.7.200.0, 3.7.301.45

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:

Producto	integracion
monitoreo del navegador	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.
Monitoreo de infraestructura	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 UIde infraestructura.
Panel	El agente .NET envía un evento y atributo predeterminados para la consulta NRQL. También puedes grabar eventos personalizados para análisis avanzado.
Monitoreo sintetico	Sintético traza de la transacción conecta las solicitudes del monitor Sintético a la transacción APM subyacente.

Te ofrecemos esta traducción automática para facilitar la lectura.

.NET compatibilidad del agente y requisitos para .NET framework

Requisitos

Versión framework .NET

AVISO EOL

Vida útil de la aplicación

Servidores de aplicaciones/web

AWS Elastic Beanstalk

Importante

CLR

Seguridad de acceso al código

Microsoft Azure

Requisitos de red

Sistema operativo

Permisos

Arquitectura del procesador

Requerimientos de seguridad

Uso de otro software de monitoreo

Instrumentación automática

Marco de la aplicación

Almacenes de datos

CMS

Biblioteca de llamadas externas

Marco de registro

Mensajería

Lenguajes y tecnologías .NET compatibles para el panel

Modelo de lenguaje extenso (LLM)

Conecte el agente a otros productos New Relic

Te ofrecemos esta traducción automática para facilitar la lectura.

.NET compatibilidad del agente y requisitos para .NET framework

Requisitos.css-21sua1{background:none;border:none;width:0;padding:0;}

Vida útil de la aplicación

Servidores de aplicaciones/web

AWS Elastic Beanstalk

CLR

Seguridad de acceso al código

Microsoft Azure

Requisitos de red

Sistema operativo

Permisos

Arquitectura del procesador

Requerimientos de seguridad

Uso de otro software de monitoreo

Instrumentación automática

Marco de la aplicación

Almacenes de datos

CMS

Biblioteca de llamadas externas

Marco de registro

Mensajería

Lenguajes y tecnologías .NET compatibles para el panel

Modelo de lenguaje extenso (LLM)

Conecte el agente a otros productos New Relic

Requisitos