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.
Compatibilidad del agente .NET y requisitos para .NET Core
El agente .NET de New Relic es compatible tanto con .NET framework como con .NET Core. Este documento describe la compatibilidad y el soporte para la aplicación .NET Core. Consulte Compatibilidad y requisitos de .NET framework para la aplicación .NET framework .
El agente .NET de New Relic incluye instrumentación integrada para algunas de las partes más populares del ecosistema .NET Core, incluidos el marco, la base de datos y los sistemas de colas de mensajes.
Después de la instalación, el agente se ejecuta dentro del proceso de supervisión; no existe un proceso o servicio separado creado por el agente.
Las fechas oficiales de inicio y finalización del ciclo de vida del producto se pueden encontrar en la documentación de Microsoft.
Nuestro soporte para el agente .NET de la versión Core inferior a 3.1 finalizó con nuestro soporte para el agente .NET 9.x New Relic. A partir de la versión 10.0 del agente .NET de New Relic , apuntaremos a ..NET Core 3.1 en adelante.
El agente .NET admite .NET Core versión 3.1 y .NET 5.0, 6.0 y 8.0.
Versión .NET Core
Versión mínima requerida del agente .NET
.NET Core 3.1
8.21.34.0 y superior
.NET 5.0
8.35.0 y superior
NET 6.0
9.2.0 y superior
.NET 7.0
10.0.0 y superior
.NET 8.0
10.0.0 y superior
Importante
En la plataforma Linux ARM64, el agente .NET only admite versiones de .NET 5.0 o superiores.
El agente .NET solo admite aplicaciones dirigidas a ..NET Core 3.1 y .NET 5.0, 6.0 y 8.0. Puede encontrar el framework objetivo en su archivo .csproj. La compatibilidad del agente varía según las diferentes versiones de .NET Core. Para obtener información sobre qué versión de agente usar para la versión de destino de ..NET Core de su aplicación, consulte la sección anterior de nuestra documentación, Microsoft .NET Core version.
Soportado:
<TargetFramework>netcoreapp3.1</TargetFramework>
<TargetFramework>net5.0</TargetFramework>
<TargetFramework>net6.0</TargetFramework>
<TargetFramework>net7.0</TargetFramework>
<TargetFramework>net8.0</TargetFramework>
Importante
En la plataforma Linux ARM64, el agente .NET only admite el marco objetivo de net5.0 o superior.
No compatible:
<TargetFramework>net452</TargetFramework>
Importante
Si desea monitor una aplicación ASP..NET Core dirigida a .NET framework, asegúrese de que su instalación del agente .NET tenga habilitada la compatibilidad con .NET framework .
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
Kestrel con proxy inverso Nginx
Kestrel con proxy inverso Apache
Alojamiento en proceso
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
Para obtener instrucciones de instalación específicas de Azure, consulte:
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 only admite versiones de .NET 5.0 o superiores.
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 requiere que su firewall permita conexiones salientes a redes y puertos específicos.
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 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 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 y 8.0 (incluye API 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:
Se admiten las versiones 8.10.0 y superiores a partir del agente .NET v10.20.1
Las versiones 8.12.1 y superiores son compatibles a partir del agente .NET v10.23.0
NEST
Versión mínima soportada: 7.0.0
Última versión compatible verificada: 7.17.5
Elasticsearch.Net
Versión mínima soportada: 7.0.0
Última versión compatible verificada: 7.17.5
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.
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 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
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)
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.