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.
.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.
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
Para que la aplicación de instrumento se ejecute en .NET framework 4.6.2 o superior, debe ejecutar New Relic .NET agente 10.0 o superior.
The .NET agent does not support .NET Framework versions 4.5.1, 4.5.2, and 4.6.1
.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.
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.
Para obtener instrucciones de instalación específicas de Azure, consulte:
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 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:
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:
Última versión compatible verificada: 4.0.40
Versiones incompatibles conocidas: 4.0.44 o superior
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.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
Ú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.1.1
Amazon Simple Queue Service (AWSSDK.SQS) (versiones del agente 10.27.0 y posteriores)
Envío y recepción de mensajes y purga de colas.
Se instrumentan los siguientes métodos:
AmazonSQSClient.SendMessage
AmazonSQSClient.SendMessageAsync
AmazonSQSClient.SendMessageBatch
AmazonSQSClient.SendMessageBatchAsync
AmazonSQSClient.ReceiveMessage
AmazonSQSClient.ReceiveMessageAsync
AmazonSQSClient.PurgeQueue
AmazonSQSClient.PurgeQueueAsync
Versión mínima admitida: 3.3.0
Última versión compatible verificada: 3.7.301.32
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.
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
Última versión compatible verificada
AWS Bedrock
3.7.200.0
10.23.0
3.7.301.45
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.