Compatibilité .NET deagent et exigences

L'agent .NET de New Relic de prend en charge .NET Framework et .NET Core. Ce document décrit la compatibilité et le support des environnements d'exécution, du framework et de la bibliothèque .NET.

L'agent inclut instrumentation intégrée pour certaines des parties les plus populaires de l'écosystème .NET, notamment le framework, la base de données et le système de mise en file d'attente des messages. Après avoir téléchargé et installé l’ agent, il s’exécute dans le processus de monitoring. L'agent ne crée pas de processus ou de service distinct.

Pour les frameworks et bibliothèques qui ne sont pas automatiquement instrumentés, vous pouvez étendre l'agent avec instrumentation .NET personnalisée.

Vous souhaitez tester notre agent .NET ? Créez un compte New Relic gratuitement ! Aucune carte de crédit requise.

Exigences

Avant d'installer l'agent .NET de New Relic sur Windows ou Linux, assurez-vous que votre système répond aux exigences suivantes :

L'agent .NET est compatible avec .NET Core version 3.1 et .NET 5.0, 6.0, 7.0, 8.0 et 9.0.

Important

L'agent n'est entièrement pris en charge que lorsque l'application instrumentée cible les runtimes .NET actuellement pris en charge par Microsoft. Il est probable que l'agent fonctionne avec les runtimes EOL répertoriés ci-dessous, mais nous ne testons pas les nouvelles versions de l'agent avec les runtimes EOL.

Version .NET Core	Version minimale requise de l'agent .NET
.NET Core 3.1 (fin de vie)	8.21.34.0 et versions ultérieures
.NET 5.0 (fin de vie)	8.35.0 et versions ultérieures
.NET 6.0 (fin de vie)	9.2.0 et versions ultérieures
.NET 7.0 (fin de vie)	10.0.0 et supérieur
.NET 8.0	10.0.0 et supérieur
.NET 9.0	10.0.0 et supérieur

Important

Sur la plateforme Linux ARM64, l'agent .NET ne prend en charge que les versions de .NET 5.0 ou supérieures.

L'agent a été vérifié pour fonctionner avec le système d'exploitation suivant :

système d'exploitation	Versions prises en charge
Windows (architecture compatible Intel 32 et 64 bits)	Windows Server 2008 R2 SP1 Windows Server 2012 Windows Server 2012 R2 Windows Server 2016 Windows Server 2019 Windows Server 2022 Windows 10 Windows 11 Conteneur Windows exécuté sur Server 2016 (les images basées sur NanoServer ne sont pas prises en charge)
Linux (compatible Intel 64 bits uniquement)	Toutes les distributions Linux x64 prises en charge par l'environnement d'exécution .NET Core 2.0+/.NET 5+ sont prises en charge par l'agent .NET. Pour une liste complète, reportez-vous à la documentation de Microsoft correspondant à la version du runtime que vous utilisez.
Linux (architecture ARM64/aarch64)	Toutes les distributions Linux ARM64 prises en charge par l'environnement d'exécution .NET 5+ sont prises en charge par l'agent .NET, avec les exceptions connues suivantes : Linux Alpine

système d'exploitation

Versions prises en charge

Windows (architecture compatible Intel 32 et 64 bits)

Windows Server 2008 R2 SP1
Windows Server 2012
Windows Server 2012 R2
Windows Server 2016
Windows Server 2019
Windows Server 2022
Windows 10
Windows 11
Conteneur Windows exécuté sur Server 2016 (les images basées sur NanoServer ne sont pas prises en charge)

Linux (compatible Intel 64 bits uniquement)

Toutes les distributions Linux x64 prises en charge par l'environnement d'exécution .NET Core 2.0+/.NET 5+ sont prises en charge par l'agent .NET. Pour une liste complète, reportez-vous à la documentation de Microsoft correspondant à la version du runtime que vous utilisez.

Linux (architecture ARM64/aarch64)

Toutes les distributions Linux ARM64 prises en charge par l'environnement d'exécution .NET 5+ sont prises en charge par l'agent .NET, avec les exceptions connues suivantes :

Linux Alpine

L'installation et l'exécution de l'agent .NET nécessitent les autorisations suivantes :

Composant	Autorisations nécessaires
Installer l'agent	Le processus ou l'utilisateur qui installe l'agent doit disposer d'autorisations suffisantes pour définir des variables d'environnement et un accès en écriture au répertoire dans lequel l'agent est installé.
Exécuter l'agent	Le processus de monitoring doit avoir un accès en lecture/écriture au répertoire dans lequel vous avez installé l'agent. L'agent s'exécute dans le cadre du processus de monitoring et s'appuie sur ces autorisations pour fonctionner. Pour les applications utilisant IIS via proxy inverse, le groupe `IIS_IUSRS` est souvent utilisé.

Composant

Autorisations nécessaires

Installer l'agent

Le processus ou l'utilisateur qui installe l'agent doit disposer d'autorisations suffisantes pour définir des variables d'environnement et un accès en écriture au répertoire dans lequel l'agent est installé.

Exécuter l'agent

Le processus de monitoring doit avoir un accès en lecture/écriture au répertoire dans lequel vous avez installé l'agent. L'agent s'exécute dans le cadre du processus de monitoring et s'appuie sur ces autorisations pour fonctionner.

Pour les applications utilisant IIS via proxy inverse, le groupe IIS_IUSRS est souvent utilisé.

L'agent .NET est compatible avec les applications ciblant .NET Core 3.1 et .NET 5.0, 6.0, 7.0, 8.0 et 9.0. Vous pouvez trouver le framework cible dans votre fichier .csproj . la compatibilité d'agent varie selon les différentes versions 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>

Important

Sur la plateforme Linux ARM64, l'agent .NET only prend en charge le framework cible net5.0 ou supérieur.

Si vous souhaitez monitorer une application ASP.NET Core ciblant .NET Framework, assurez-vous d'avoir activé la prise en charge de .NET Framework après l'installation de l'agent.NET.

instrumentationautomatique

Si votre application est hébergée dans ASP.NET Core, l’ agent crée et instrumente automatiquement les transactions. L'agent .NET instrumente automatiquement votre application après l'installation. Si votre application n'est pas automatiquement instrumentée, ou si vous souhaitez ajouter instrumentation, utilisez instrumentation personnalisée.

L'agent .NET instrumente automatiquement les performances des appels application .NET vers ces magasins de données :

Datastore	Détails de l'instance	Remarques
Base de données Cosmos		L'agent .NET `v9.2.0` ou supérieur instrumente automatiquement la bibliothèque Microsoft Azure.Cosmos . Version minimale prise en charge : 3.17.0 Dernière version compatible vérifiée : 3.48.1 Les versions 3.35.0 et supérieures sont prises en charge à partir de l'agent .NET v10.32.0
Base de canapé		Utilisez CouchbaseNetClient. Version minimale prise en charge : 3.2.0 Dernière version compatible vérifiée : 3.6.6 Version minimale de l'agent requise : 10.40.0
Serveur Microsoft SQL		Utilisez SqlClient à partir du package NuGet System.Data.SqlClient ou du package NuGet Microsoft.Data.SqlClient. System.Data.SqlClient Version minimale prise en charge : 4.4.0 Dernière version compatible vérifiée : 4.8.6 Microsoft.Data.SqlClient Version minimale prise en charge : 1.0.19239.1 Dernière version compatible vérifiée : 6.0.1
Oracle		Utiliser Oracle.ManagedDataAccess.Core Version minimale prise en charge : 23.4.0 Dernière version compatible vérifiée : 23.8.0 Les anciennes versions de `Oracle.ManagedDataAccess.Core` peuvent être instrumentées, mais n'ont pas été testées et ne sont pas prises en charge.
PostgreSQL		Utiliser Npgsql Version minimale prise en charge : 4.0.0 Dernière version compatible vérifiée : 4.0.13 Les versions antérieures de Npgsql peuvent également être instrumentées, mais des métriques en double et/ou manquantes sont possibles.
MongoDB (pilote moderne)		Version minimale prise en charge : 2.3.0 Dernière version compatible vérifiée : 3.3.0 Versions 3.0.0 et les versions supérieures sont prises en charge à partir de l'agent .NET v10.40.0. À partir de la version 10.12.0 agent, les méthodes suivantes ajoutées dans ou après la version 2.7 du pilote sont instrumentées : IMongoCollection.CountDocuments[Async] IMongoCollection.EstimatedDocumentCount[Async] IMongoCollection.AggregateToCollection[Async] IMongoDatabase.ListCollectionNames[Async] IMongoDatabase.Aggregate[Async] IMongoDatabase.AggregateToCollection[Async] IMongoDatabase.Watch[Async]
MySQL		Utilisez MySQL.Data ou MySQL connecteur MySql.Data Version minimale prise en charge : 6.10.7 Dernière version compatible vérifiée : 9.2.0 MySqlConnector Version minimale prise en charge : 1.0.1 Dernière version compatible vérifiée : 2.4.0
StackExchange. Redis		Version minimale prise en charge : 1.0.488 Dernière version compatible vérifiée : 2.8.31
Elasticsearch		Utilisez Elastic.Clients.Elasticsearch, NEST ou Elasticsearch.Net. Elastic.Clients.Elasticsearch Version minimale prise en charge : 8.0.0 Version maximale prise en charge : 8.15.10 Les versions 8.10.0 et supérieures sont prises en charge à partir de l'agent .NET v10.20.1 Les versions 8.12.1 et supérieures sont prises en charge à partir de l'agent .NET v10.23.0 NEST Version minimale prise en charge : 7.0.0 Dernière version compatible vérifiée : 7.17.5 Elasticsearch.Net Version minimale prise en charge : 7.0.0 Dernière version compatible vérifiée : 7.17.5
Memcached		Utilisez EnyimMemcachedCore. Version minimale prise en charge : 2.0.0 Dernière version compatible vérifiée : 3.3.1
DynamoDB		Utilisez AWSSDK.DynamoDBv2. Version minimale prise en charge : 3.5.0 Dernière version compatible vérifiée : 3.7.406.22 Version minimale de l'agent requise : 10.33.0
System.Data.ODBC		Utilisez System.Data.ODBC. Version minimale prise en charge : 8.0.0 Dernière version compatible vérifiée : 9.0.4 Version minimale de l'agent requise : 10.35.0 Les fonctionnalités suivantes prises en charge pour les appels datastore ODBC dans .NET Framework (à l'aide de l'espace de nommage système.Data intégré) ne sont pas prises en charge pour .NET 8+ : Connexion `Open/OpenAsync` appels Appels SqlDataReader `Read/NextResult` Trace SQL lente

L'agent .NET ne monitore pas directement les processus datastore . De plus, la capture des paramètres .NET SQL dans une trace de requête ne répertorie pas les paramètres d'une requête paramétrée ou d'une procédure stockée.

La collecte des détails d’instance pour les magasins de données pris en charge est activée par défaut. Pour demander des informations au niveau de l'instance à partir de magasins de données non répertoriés actuellement, obtenez de l'aide sur support.newrelic.com.

Si votre datastore n'est pas répertoriée ici, vous pouvez ajouter instrumentation personnalisée à l'aide de la méthode RecordDatastoreSegment dans l' API .NET de l'agent.

L'agent .NET instrumente automatiquement ces bibliothèque d'appels externes :

Bibliothèques	Supported methods
HttpClient	L'agent instrumente ces méthodes HttpClient : `SendAsync` `GetAsync` `PostAsync` `PutAsync` `DeleteAsync` `GetStringAsync` `GetStreamAsync` `GetByteArrayAsync`

Bibliothèques

Supported methods

HttpClient

L'agent instrumente ces méthodes HttpClient :

SendAsync
GetAsync
PostAsync
PutAsync
DeleteAsync
GetStringAsync
GetStreamAsync
GetByteArrayAsync

L'agent .NET peut être configuré pour instrumenter automatiquement ces frameworks LLM :

Frameworks	Version minimale du framework	Version minimale de l'agent	Dernière version compatible vérifiée
Base AWS	3.7.200.0	10.23.0 (`InvokeModelAsync`) 10.37.0 (`InvokeModelAsync`, `ConverseAsync`)	3.7.418.4
OpenAI	2.0.0	10.37.0 (`CompleteChat`, `CompleteChatAsync`)	2.1.0
Azure.AI.OpenAI	2.0.0	10.37.0 (`CompleteChat`, `CompleteChatAsync`)	2.1.0

L'agent .NET peut être configuré pour instrumenter automatiquement ce framework de logging pour des logs automatiques en contexte avec transfertagent et décoration log local:

Frameworks	Version minimale du framework	Version minimale de l'agent	Dernière version compatible vérifiée
Log4Net	2.0.10	9.7.0	3.0.4
Sérilog	2.5.0	9.7.0	4.2.0
NLog	4.5.0	9.7.0	5.4.0
Microsoft.Extensions.Logging	3.0.0	10.0.0	9.0.4

L'agent instrumente automatiquement ces systèmes de messages :

Bibliothèques	Supported methods
Confluent.Kafka	Produire et consommer sur des sujets. Les méthodes suivantes sont instrumentées : `IProducer.Produce` `IProducer.ProduceAsync` `IConsumer.Consume` Version minimale prise en charge : 1.4.0 Dernière version compatible vérifiée : 2.9.0
NServiceBus	Met et prend des messages. Version minimale prise en charge : 5.0 Dernière version compatible vérifiée : 9.2.7
RabbitMQ	Place et prend des messages et purge la file d'attente. Lors de la réception de messages utilisant un `IBasicConsumer`, le `EventingBasicConsumer` est la seule implémentation instrumentée par l'agent.NET. `BasicGet` est instrumenté, mais l'agent ne prend pas en charge le tracing distribué pour `BasicGet`. Les méthodes suivantes sont instrumentées : `IModel.BasicGet` `IModel.BasicPublish` `IModel.BasicConsume` `IModel.QueuePurge` `EventingBasicConsumer.HandleBasicDeliver` Version minimale prise en charge : 3.5.2 Dernière version compatible vérifiée : 6.6.0
MassTransit (versions d'agent 10.19.0 et plus récentes)	Publication/envoi et consommation de messages Version minimale prise en charge : 7.1.0 Dernière version compatible vérifiée : 8.3.7
AWSSDK.SQS (Amazon Simple Queue Service) (versions d'agent 10.27.0 et plus récentes)	Envoyer et recevoir des messages Version minimale prise en charge : 3.7.0 Dernière version compatible vérifiée : 3.7.400.134
AWSSDK.Kinesis (Amazon Kinesis Data Streams) (versions d'agent 10.40.0 et ultérieures)	Les opérations `PutRecord(s)Async` et `GetRecordsAsync` sont instrumentées comme des opérations de courtier de messages. D'autres opérations Kinesis sont instrumentées comme des appels de méthodes de base. Version minimale prise en charge : 3.7.0 Dernière version compatible vérifiée : 3.7.402.111
AWSSDK.KinesisFirehose (Amazon Kinesis Firehose) (versions d'agent 10.40.0 et ultérieures)	Toutes les opérations Kinesis Firehose sont instrumentées sous forme d'appels de méthode de base. Version minimale prise en charge : 3.7.0 Dernière version compatible vérifiée : 3.7.402.49

Fonctionnalité indisponible

Les fonctionnalités suivantes ne sont pas disponibles pour l'agent.NET :

L'agent .NET ne prend pas en charge le déploiement autonome et les exécutables, car le compilateur peut potentiellement couper les assemblys dont dépend l'agent .
Infinite Tracing n'est pas pris en charge sur Alpine Linux en raison d'un problème de compatibilité GRPC. Consultez ce problème d'agent pour plus d'informations.

L'agent .NET ne prend pas en charge le déploiement natif Ahead of Time (AOT) pour l'application .NET, car la compilation juste-à-temps (JIT) est requise pour que l'agent fonctionne correctement.

Connectez l'agent à d'autres produits New Relic

En plus d'APM, l'agent .NET s'intègre à d'autres produits New Relic pour vous offrir une visibilité de bout en bout :

Produit	intégration
Monitoring de navigateurs	Pour les applications Web ASP.NET Core v6.0 et versions ultérieures (MVC, Razor et Blazor), l'agent .NET (à partir de la version 10.19.0) injecte automatiquement l'agent JavaScript du navigateur lorsque vous activez auto-instrumentation. Pour les autres types d'applications Web, vous pouvez injecter l'agent en utilisant l' API .NET deagent ou la méthode copier/coller deagent du navigateur. Après avoir activé injection du navigateur, vous pouvez afficher les données du navigateur dans la page RésuméAPM et basculer rapidement entre l'APM et les données du navigateur pour une application particulière. Pour les options configuration et instrumentation manuelle, voir monitoring des navigateurs et l'agent .NET.
Monitoring de l'infrastructure	Lorsque vous installez l'infrastructure et l'agent APM sur le même hôte, ils se détectent automatiquement. Vous pouvez ensuite afficher une liste d'hôtes dans l'UI APM et filtrer vos infrastructure hôtes par APM application dans notre infrastructure UI. Pour plus d’informations, consultez APM les données dans l’ infrastructure UI.
Dashboards	L'agent .NET envoie un événement et un attribut par défaut pour la requête NRQL . Vous pouvez également enregistrer un événement personnalisé pour une analyse avancée.

Produit

intégration

Monitoring de navigateurs

Pour les applications Web ASP.NET Core v6.0 et versions ultérieures (MVC, Razor et Blazor), l'agent .NET (à partir de la version 10.19.0) injecte automatiquement l'agent JavaScript du navigateur lorsque vous activez auto-instrumentation.

Pour les autres types d'applications Web, vous pouvez injecter l'agent en utilisant l' API .NET deagent ou la méthode copier/coller deagent du navigateur.

Après avoir activé injection du navigateur, vous pouvez afficher les données du navigateur dans la page RésuméAPM et basculer rapidement entre l'APM et les données du navigateur pour une application particulière. Pour les options configuration et instrumentation manuelle, voir monitoring des navigateurs et l'agent .NET.

Monitoring de l'infrastructure

Lorsque vous installez l'infrastructure et l'agent APM sur le même hôte, ils se détectent automatiquement. Vous pouvez ensuite afficher une liste d'hôtes dans l'UI APM et filtrer vos infrastructure hôtes par APM application dans notre infrastructure UI. Pour plus d’informations, consultez APM les données dans l’ infrastructure UI.

Dashboards

L'agent .NET envoie un événement et un attribut par défaut pour la requête NRQL . Vous pouvez également enregistrer un événement personnalisé pour une analyse avancée.

Exigences

Avant d'installer l'agent .NET de New Relic, assurez-vous que votre système répond aux exigences suivantes :

.NET Framework 4.6.2 ou supérieur

Pour instrumenter une application exécutée sur .NET Framework 4.6.2 ou supérieur, vous devez exécuter New Relic .NET agent 10.0 ou supérieur. Pour instrumenter une application exécutée sur .NET Framework version 4.0 ou inférieure, vous devez exécuter une version de l'agent .NET de New Relic inférieure à 7.0. Pour plus d'informations et pour connaître les procédures de téléchargement, consultez Support technique pour .NET Framework 4.0 ou version antérieure.

The .NET agent doesn't support .NET Framework versions 4.5.1, 4.5.2, and 4.6.1

Vous devez utiliser l'un de ces serveurs d'application/Web :

IIS
OWIN auto-hébergé
WCF auto-hébergé
Crécerelle
Kestrel avec proxy inverse IIS via AspNetCoreModule
Kestrel avec proxy inverse IIS via AspNetCoreModuleV2
L'agent crée automatiquement des transactions pour les applications hébergées dans IIS. Si vous vous auto-hébergez avec WCF et OWIN version 3 ou supérieure, l'agent crée également automatiquement des transactions. Pour les autres services auto-hébergés, vous devrez créer des transactions via une instrumentation personnalisée.

l'installation nécessite des privilèges élevés (administrateur). Par exemple, vous pouvez :

Connectez-vous en tant qu'administrateur utilisateur.
Soyez membre du groupe administrateur.
Sur les systèmes d'exploitation plus récents, fournissez les informations d'identification d'élévation lorsque vous y êtes invité.
Le processus de monitoring doit avoir un accès en lecture/écriture au répertoire dans lequel l'agent est installé. L'agent s'exécute dans le cadre du processus de monitoring et s'appuie sur ces autorisations pour fonctionner.
Recommendation:
Limitez les autorisations pour le fichier newrelic.config et accordez l'accès en lecture/écriture uniquement au propriétaire du processus de monitoring.
Vérifiez les autorisations du log créé par l'agent pour minimiser le nombre d'utilisateurs disposant d'un accès et leurs privilèges.

instrumentationautomatique

Si votre application est hébergée dans ASP.NET ou un autre frameworkentièrement pris en charge, l'agent .NET instrumentera automatiquement votre application après l'installation. Si votre application n'est pas automatiquement instrumentée, ou si vous souhaitez ajouter instrumentation, utilisez instrumentation personnalisée.

L'agent .NET ne monitore pas directement les processus datastore . De plus, par défaut, la capture des paramètres .NET SQL dans une trace de requête ne répertorie pas les paramètres d'une requête paramétrée ou d'une procédure stockée. La collecte des paramètres de requête SQL peut être activée dans la agent configuration.

L'agent instrumente automatiquement certains cadres application ; nous faisons référence à ces cadres sous le nom de fully supported, qui sont répertoriés ci-dessous :

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
Formulaires Web ASP.NET
Castle MonoRail v2 (plus pris en charge dans la version 10.0 ou supérieure de l'agent .NET)
Application API Web hébergée par OWIN sur framework .NET utilisant :
Microsoft.Owin.Host.HttpListener v2.x
Microsoft.Owin.Host.HttpListener v3.x
Microsoft.Owin.Host.HttpListener v4.x
Services Web basés sur SOAP
WCF

L'instrumentation WCF a été testée pour les types de liaison courants suivants (client et service). Différents niveaux de support sont disponibles pour le tracing distribué (DT) et le tracing inter-applications (CAT) :

Obligatoire	Tracing distribué (DT) Support	Prise en charge du tracing inter-applications (CAT) (obsolète)
HTTP de base	soutenu	soutenu
WebHTTP	soutenu	soutenu
WSHTTP	soutenu	soutenu
Protocole NetTCP	soutenu	soutenu
Pipe nommée Net	non pris en charge*	non pris en charge*
NetMSMQ	non pris en charge*	non pris en charge*

* le tracing distribué peut être implémenté manuellement à l'aide de ces méthodes API de tracing distribué .

La collecte des détails d'instance pour les magasins de données pris en charge nécessite l'agent .NET version 6.5.29.0 ou supérieure et est activée par défaut. Pour demander des informations au niveau de l'instance à partir de banques de données qui ne sont pas actuellement répertoriées, obtenez de l'aide au centre de support New Relic.

Afin d'instrumenter automatiquement les performances des appels application .NET framework vers ces datastores, assurez-vous de disposer de la version 8.14 ou supérieure de l'agent .NET:

Datastore	Détails de l'instance	Autres notes
Base de données Cosmos		L'agent .NET `v9.2.0` ou supérieur instrumente automatiquement la bibliothèque Microsoft Azure.Cosmos . Version minimale prise en charge : 3.17.0 Dernière version compatible vérifiée : 3.48.1 Les versions 3.35.0 et supérieures sont prises en charge à partir de l'agent .NET v10.32.0
Base de canapé		Utilisez CouchbaseNetClient. Version minimale prise en charge : 2.0.0 Dernière version compatible vérifiée : 3.6.6 Les versions 3.2.0 et ultérieures sont prises en charge à partir de l'agent .NET v10.40.0 Versions incompatibles connues : 3.0.x, 3.1.x Avec CouchbaseNetClient 2.x, les éléments suivants ne sont pas instrumentés par défaut en faveur de leurs homologues multi-documents : `Get(string key)` `GetDocument(string key)` `Remove(string key)` `Remove(string key, ulong cas)` `Upsert<T>(string key, T value)`
IBM DB2
Serveur Microsoft SQL		Utilisez SqlClient à partir du package NuGet système.Data.SqlClient ou du package NuGet Microsoft.Data.SqlClient ou de l'assembly du frameword du System.Data intégré. System.Data.SqlClient Version minimale prise en charge : 4.4.0 Dernière version compatible vérifiée : 4.8.6 Microsoft.Data.SqlClient Version minimale prise en charge : 1.0.19239.1 Dernière version compatible vérifiée : 6.0.1 System.Data Version minimale prise en charge : .NET Framework 4.6.2 Dernière version compatible vérifiée : 4.8
System.Data.ODBC		Utilisez l'espace de nommage `System.Data.ODBC` intégré du framework .NET. Disponible dans toutes les versions agent .NET Framework actuellement prises en charge. Toutes les versions du framework .NET actuellement prises en charge par Microsoft sont vérifiées comme étant compatibles.
MongoDB (pilote legacy )		Version minimale prise en charge : 1.10.0 Dernière version compatible vérifiée : 1.10.0 Versions incompatibles connues : les détails de l'instance ne sont pas disponibles dans la version inférieure 2.
MongoDB (pilote moderne)		Version minimale prise en charge : 2.3.0 Dernière version compatible vérifiée : 3.3.0 Versions 3.0.0 et les versions supérieures sont prises en charge à partir de l'agent .NET v10.40.0. À partir de la version 10.12.0 agent, les méthodes suivantes ajoutées dans ou après la version 2.7 du pilote sont instrumentées : `IMongoCollection.CountDocuments[Async]` `IMongoCollection.EstimatedDocumentCount[Async]` `IMongoCollection.AggregateToCollection[Async]` `IMongoDatabase.ListCollectionNames[Async]` `IMongoDatabase.Aggregate[Async]` `IMongoDatabase.AggregateToCollection[Async]` `IMongoDatabase.Watch[Async]`
MySQL		Utilisez MySQL.Data ou MySQL connecteur MySql.Data Version minimale prise en charge : 6.10.7 Dernière version compatible vérifiée : 9..0 MySqlConnector Version minimale prise en charge : 1.0.1 Dernière version compatible vérifiée : 2.4.0
Oracle		Utiliser Oracle.ManagedDataAccess Version minimale prise en charge : 12.1.2400 Dernière version compatible vérifiée : 23.8.0
PostgreSQL		Utiliser Npgsql Version minimale prise en charge : 4.0.0 Dernière version compatible vérifiée : 4.0.5 Les versions antérieures de Npgsql peuvent également être instrumentées, mais des métriques en double et/ou manquantes sont possibles.
ServiceStack.Redis		Dernière version compatible vérifiée : 4.0.40 Versions incompatibles connues : 4.0.44 ou supérieure
StackExchange. Redis		Version minimale prise en charge : 1.0.488 Dernière version compatible vérifiée : 2.8.31
Elasticsearch		Utilisez Elastic.Clients.Elasticsearch, NEST ou Elasticsearch.Net. Elastic.Clients.Elasticsearch Version minimale prise en charge : 8.0.0 Version maximale prise en charge : 8.15.10 Les versions 8.10.0 et supérieures sont prises en charge à partir de l'agent .NET v10.20.1 Les versions 8.12.1 et supérieures sont prises en charge à partir de l'agent .NET v10.23.0 NEST Version minimale prise en charge : 7.0.0 Dernière version compatible vérifiée : 7.17.5 Elasticsearch.Net Version minimale prise en charge : 7.0.0 Dernière version compatible vérifiée : 7.17.5
Memcached		Utilisez EnyimMemcachedCore. Version minimale prise en charge : 2.0.0 Dernière version compatible vérifiée : 3.3.1
DynamoDB		Utilisez AWSSDK.DynamoDBv2. Version minimale prise en charge : 3.5.0 Dernière version compatible vérifiée : 3.7.406.22 Version minimale de l'agent requise : 10.33.0

Si votre datastore n'est pas répertoriée ici, vous pouvez ajouter instrumentation personnalisée à l'aide de la méthode RecordDatastoreSegment dans l' API .NET de l'agent.

L'agent instrumente automatiquement ces bibliothèque d'appels externes :

Bibliothèques	Supported methods
HttpClient	L'agent instrumente ces méthodes HttpClient : `SendAsync` `GetAsync` `PostAsync` `PutAsync` `DeleteAsync` `GetStringAsync` `GetStreamAsync` `GetByteArrayAsync`
Reste Sharp	L'agent instrumente ces méthodes RestSharp : `ExecuteTaskAsync` `ExecuteGetTaskAsync` `ExecutePostTaskAsync` `Execute` `ExecuteAsGet` `ExecuteAsPost` `DownloadData` Version minimale prise en charge : 105.2.3 Dernière version compatible vérifiée : 112.1.0 Versions incompatibles connues : 106.8.0, 106.9.0, 106.10.0, 106.10.1
Requête Web Http	L'agent instrumente ces méthodes HttpWebRequest : `GetResponse`

Bibliothèques

Supported methods

HttpClient

L'agent instrumente ces méthodes HttpClient :

SendAsync
GetAsync
PostAsync
PutAsync
DeleteAsync
GetStringAsync
GetStreamAsync
GetByteArrayAsync

Reste Sharp

L'agent instrumente ces méthodes RestSharp :

ExecuteTaskAsync
ExecuteGetTaskAsync
ExecutePostTaskAsync
Execute
ExecuteAsGet
ExecuteAsPost
DownloadData
Version minimale prise en charge : 105.2.3
Dernière version compatible vérifiée : 112.1.0
Versions incompatibles connues : 106.8.0, 106.9.0, 106.10.0, 106.10.1

Requête Web Http

L'agent instrumente ces méthodes HttpWebRequest :

GetResponse

L'agent .NET peut être configuré pour instrumenter automatiquement ces frameworks LLM :

Frameworks	Version minimale du framework	Version minimale de l'agent	Dernière version compatible vérifiée
Base AWS	3.7.200.0	10.23.0 (`InvokeModelAsync`) 10.37.0 (`InvokeModelAsync`, `ConverseAsync`)	3.7.418.4
OpenAI	2.0.0	10.37.0 (`CompleteChat`, `CompleteChatAsync`)	2.1.0
Azure.AI.OpenAI	2.0.0	10.37.0 (`CompleteChat`, `CompleteChatAsync`)	2.1.0

L'agent .NET peut être configuré pour instrumenter automatiquement ce framework de logging pour des logs automatiques en contexte avec transfertagent et décoration log local:

Frameworks	Version minimale du framework	Version minimale de l'agent	Dernière version compatible vérifiée
Log4Net	1.2.10	9.7.0	3.0.4
Sérilog	2.0.0	9.7.0	4.2.0
NLog	4.1.0	9.7.0	5.4.0
Microsoft.Extensions.Logging	3.0.0	9.7.0	9.0.4

L'agent instrumente automatiquement ces systèmes de messages :

Bibliothèques	Supported methods
Confluent.Kafka	Produire et consommer sur des sujets. Les méthodes suivantes sont instrumentées : `IProducer.Produce` `IProducer.ProduceAsync` `IConsumer.Consume` Version minimale prise en charge : 1.4.0 Dernière version compatible vérifiée : 2.9.0
MSMQ	Envoi et réception de messages, aperçu et purge de la file d'attente
NServiceBus	Met et prend des messages. Version minimale prise en charge : 5.0 Dernière version compatible vérifiée : 8.2.4
RabbitMQ	Place et prend des messages et purge la file d'attente. Lors de la réception de messages utilisant un `IBasicConsumer`, le `EventingBasicConsumer` est la seule implémentation instrumentée par l'agent.NET. `BasicGet` est instrumenté, mais l'agent ne prend pas en charge le tracing distribué pour `BasicGet`. Les méthodes suivantes sont instrumentées : `IModel.BasicGet` `IModel.BasicPublish` `IModel.BasicConsume` `IModel.QueuePurge` `EventingBasicConsumer.HandleBasicDeliver` Version minimale prise en charge : 3.5.2 Dernière version compatible vérifiée : 6.6.0
MassTransit (versions d'agent 10.19.0 et plus récentes)	Publication/envoi et consommation de messages Version minimale prise en charge : 7.1.0 Dernière version compatible vérifiée : 8.3.7
AWSSDK.SQS (Amazon Simple Queue Service) (versions d'agent 10.27.0 et plus récentes)	Envoyer et recevoir des messages Version minimale prise en charge : 3.7.0 Dernière version compatible vérifiée : 3.7.400.134
AWSSDK.Kinesis (Amazon Kinesis Data Streams) (versions d'agent 10.40.0 et ultérieures)	Les opérations `PutRecord(s)Async` et `GetRecordsAsync` sont instrumentées comme des opérations de courtier de messages. D'autres opérations Kinesis sont instrumentées comme des appels de méthodes de base. Version minimale prise en charge : 3.7.0 Dernière version compatible vérifiée : 3.7.402.111
AWSSDK.KinesisFirehose (Amazon Kinesis Firehose) (versions d'agent 10.40.0 et ultérieures)	Toutes les opérations Kinesis Firehose sont instrumentées sous forme d'appels de méthode de base. Version minimale prise en charge : 3.7.0 Dernière version compatible vérifiée : 3.7.402.49

Les langages et technologies .NET répertoriés sont compatibles avec notre dashboard d'observabilité instantanée . Si vous utilisez l'un de ces langages ou technologies, vous pouvez afficher vos données dans un New Relic dashboard, dès la sortie de la boîte :

Langue/technologie	Configuration supplémentaire
Application C#	New Relic peut instrumenter automatiquement les services écrits en C#. Accédez à notre page quickstart C# pour installer le dashboard C#.
ADO.net	Si votre application utilise ADO.net, vous pouvez installer une combinaison d'agents New Relic qui génèrent un dashboard ADO.net. Voici ce que vous devez faire : Installez New Relic APM l'.NET agent et agent l'd'infrastructure en suivant les étapes de notre guidée installation. Installez l'intégration Microsoft Windows Perfmon/WMI sur hôte pour New Relic Infrastructure en suivant les instructions nri-perfmon. Si vous avez installé Perfmon manuellement, redémarrez votre agent d'infrastructure. Accédez à notre page quickstart ADO.NET pour installer le dashboard ADO.NET.
Serveur Blazor	Suivez vos données les plus importantes dans notre dashboard Blazor Server en instrumentant votre application avec New Relic: Installez l'agent .NET APM de New Relic et l'agent d'infrastructure en suivant les étapes de notre installation guidée. Si vous préférez, vous pouvez installer l'agent d'infrastructure via la ligne de commande. Obtenez le dashboard prédéfini en installant le quickstartde Blazor Depuis one.newrelic.com, accédez à APM & services, puis sélectionnez votre application. Pour vérifier que votre installation est réussie, effectuez les requêtes suivantes : `FROM Transaction SELECT count(*) FACET request.uri` Si des données apparaissent, vous avez correctement instrumenté votre application.

Langue/technologie

Configuration supplémentaire

Application C#

New Relic peut instrumenter automatiquement les services écrits en C#. Accédez à notre page quickstart C# pour installer le dashboard C#.

ADO.net

Si votre application utilise ADO.net, vous pouvez installer une combinaison d'agents New Relic qui génèrent un dashboard ADO.net. Voici ce que vous devez faire :

Installez New Relic APM l'.NET agent et agent l'd'infrastructure en suivant les étapes de notre guidée installation.
Installez l'intégration Microsoft Windows Perfmon/WMI sur hôte pour New Relic Infrastructure en suivant les instructions nri-perfmon.
Si vous avez installé Perfmon manuellement, redémarrez votre agent d'infrastructure.
Accédez à notre page quickstart ADO.NET pour installer le dashboard ADO.NET.

Serveur Blazor

Suivez vos données les plus importantes dans notre dashboard Blazor Server en instrumentant votre application avec New Relic:

Installez l'agent .NET APM de New Relic et l'agent d'infrastructure en suivant les étapes de notre installation guidée. Si vous préférez, vous pouvez installer l'agent d'infrastructure via la ligne de commande.
Obtenez le dashboard prédéfini en installant le quickstartde Blazor
Depuis one.newrelic.com, accédez à APM & services, puis sélectionnez votre application. Pour vérifier que votre installation est réussie, effectuez les requêtes suivantes :
```
FROM Transaction SELECT count(*) FACET request.uri
```
Si des données apparaissent, vous avez correctement instrumenté votre application.

Ces frameworks ne sont pas entièrement pris en charge :

ASP.NET Web API v1: Consultez les informations de dépannage sur l'utilisation d'ASP.NET Web API v1 avec l'agent .NET de New Relic 5.0 ou supérieur pour les applications ciblant .NET Framework 4.0. (Cela n'affecte pas .NET Framework 4.5 ou supérieur.)
Mono: New Relic ne prend pas en charge Mono, un framework .NET open source qui fonctionne sous Linux. Cela est dû au fait qu’il n’existe pas API de profileur à injecter dans l’ agent .NET en tant que profileur dans une application .NET basée sur Mono. L'API profileur est une interface basée sur un modèle d'objet de composant (COM) et n'est pas prise en charge sous Linux.
L'ASP classique est not supported, car l'agent ne peut instrumenter que les applications basées sur .NET Framework.
Sharepoint est not supported.

Fonctionnalité indisponible

La compilation juste-à-temps (JIT) est une exigence pour la fonctionnalité de l'agent .NET, donc les images natives créées avec Native Image Generator (NGEN) ne sont pas prises en charge par l'agent .NET.

Connectez l'agent à d'autres produits New Relic

En plus d'APM, l'agent s'intègre à d'autres produits New Relic pour vous offrir une visibilité de bout en bout :

Produit	intégration
Monitoring de navigateurs	Pour l'application Web ASP.NET, l'agent .NET injecte automatiquement l'agent JavaScript du navigateur lorsque vous activez auto-instrumentation. Après avoir activé injection du navigateur, vous pouvez afficher les données du navigateur dans la page RésuméAPM et basculer rapidement entre les données et pour une application particulière. Pour les options configuration et instrumentation manuelle, voir monitoring des navigateurs et l'agent .NET.
Monitoring de l'infrastructure	Lorsque vous installez l'infrastructure et l'agent APM sur le même hôte, ils se détectent automatiquement. Vous pouvez ensuite afficher une liste d'hôtes dans l'UI APM et filtrer vos hôtes par APM application dans notre infrastructure UI. Pour plus d'informations, consultez APM Données dans infrastructure UI.
Dashboards	L'agent .NET envoie un événement et un attribut par défaut pour la requête NRQL . Vous pouvez également enregistrer un événement personnalisé pour une analyse avancée.
Monitoring synthétique	Synthétique trace de transaction connecte requests du moniteur Synthétique à la transaction APM sous-jacente.

Cette traduction automatique est fournie pour votre commodité.

Compatibilité .NET deagent et exigences

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

Serveurs d'applications/Web

AWS Elastic Beanstalk

Microsoft Azure

Exigences réseau

système d'exploitation

Autorisations

Architecture du processeur

Exigences de sécurité

Version cible du framework

instrumentationautomatique

Cadre d'application

Magasins de données

Bibliothèque d'appels externes

grands modèles de langage (LLM) (LLM)

Cadre de logging

Messagerie

Fonctionnalité indisponible

Connectez l'agent à d'autres produits New Relic

Exigences

Version du framework .NET

Durée de vie de l'application

Serveurs d'applications/Web

AWS Elastic Beanstalk

CLR

Sécurité d'accès au code

Microsoft Azure

Exigences réseau

système d'exploitation

Autorisations

Architecture du processeur

Exigences de sécurité

Utilisation d'autres logiciels monitoring

instrumentationautomatique

Cadre d'application

Types de reliure

Magasins de données

CMS

Bibliothèque d'appels externes

Modèles d'hébergement

Modèles d'invocation

grands modèles de langage (LLM) (LLM)

Cadre de logging

Messagerie

Langages et technologies .NET pris en charge pour le dashboard

Cadre non pris en charge

Fonctionnalité indisponible

Connectez l'agent à d'autres produits New Relic

Exigences