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, 9.0 et 10.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 |
.NET 10.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.
Assurez-vous d’utiliser l’un de ces serveurs d’application/Web :
- Crécerelle
- Kestrel avec proxy inverse IIS via AspNetCoreModule
- Kestrel avec proxy inverse IIS via AspNetCoreModuleV2
- Kestrel avec proxy inverse Nginx
- Kestrel avec proxy inverse Apache
- Hébergement en cours
Pour obtenir des instructions d'installation d'AWS Elastic Beanstalk, consultez le guide d'installation .NET.
Pour obtenir des instructions d’installation spécifiques à Azure, consultez le guide d’installation .NET.
L'agent nécessite que votre pare-feu autorise les connexions sortantes vers des réseaux et des ports spécifiques.
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) |
|
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 (y compris les versions conteneurisées). Pour une liste complète, reportez-vous à la documentation de Microsoft pour la version du runtime que vous utilisez. |
Linux (architecture ARM64/aarch64) | Toutes les distributions Linux ARM64 prises en charge par le runtime .NET 5+ sont prises en charge par l'agent .NET (y compris les versions conteneurisées), avec les exceptions connues suivantes :
|
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 |
L'agent est disponible en versions 32 bits (x86) et 64 bits (x64) sur Windows ainsi qu'en versions 64 bits (x64) et ARM64 (aarch64) sur Linux.
Important
Sur la plateforme Linux ARM64, l'agent .NET ne prend en charge que les versions de .NET 5.0 ou supérieures.
En tant que mesure de sécurité standard pour la collecte de données, votre serveur d'applications doit prendre en charge SHA-2 (256 bits). SHA-1 n'est pas pris en charge.
L'agent .NET est compatible avec les applications ciblant .NET Core 3.1 et .NET 5.0, 6.0, 7.0, 8.0, 9.0 et 10.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><TargetFramework>net10.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 ces frameworks application :
- ASP.NET Core MVC 2.0, 2.1, 2.2, 3.0, 3.1, 5.0, 6.0, 7.0, 8.0, 9.0 et 10.0 (y compris l'API Web)
- ASP.NET Core Razor Pages 6.0, 7.0, 8.0, 9.0 et 10.0 (à partir de la version 10.19.0 de l'agent .NET)
L'agent .NET instrumente automatiquement les performances des appels application .NET vers ces magasins de données :
Datastore | Remarques | |
|---|---|---|
Base de données Cosmos | L'agent .NET
| |
Base de canapé | Utilisez CouchbaseNetClient.
| |
Serveur Microsoft SQL | Utilisez SqlClient à partir du package NuGet System.Data.SqlClient ou du package NuGet Microsoft.Data.SqlClient. System.Data.SqlClient
| |
Oracle | Utiliser Oracle.ManagedDataAccess.Core
| |
PostgreSQL | Utiliser Npgsql
| |
MongoDB (pilote moderne) | Version minimale prise en charge : 2.3.0 Dernière version compatible vérifiée : 3.8.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 :
| |
MySQL | Utilisez MySQL.Data ou MySQL connecteur MySql.Data
| |
StackExchange. Redis | Version minimale prise en charge : 1.0.488 Dernière version compatible vérifiée : 2.12.14 | |
Elasticsearch | Utilisez Elastic.Clients.Elasticsearch, NEST ou Elasticsearch.Net. Elastic.Clients.Elasticsearch
| |
Memcached | Utilisez EnyimMemcachedCore.
| |
DynamoDB | Utilisez AWSSDK.DynamoDBv2.
| |
System.Data.ODBC | Utilisez System.Data.ODBC.
|
L'agent .NET ne collecte pas de données sur les processus du serveur datastore. Il collecte uniquement les données provenant de l'utilisation de la bibliothèque cliente datastore. Pour monitorer directement les processus du serveur datastore, utilisez l'agent New Relic Infrastructure avec intégration sur hôte.
Par défaut, l'agent .NET ne capture pas les paramètres SQL pour les procédures stockées ou les requêtes paramétrées dans une trace de requête. Pour voir ces paramètres SQL, vous devez activer la fonctionnalité de collecte dans la configuration de l'agent.
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 :
|
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 ( | 4.0.17.5 |
OpenAI | 2.0.0 | 10.37.0 ( | 2.8.0 |
Azure.AI.OpenAI | 2.0.0 | 10.37.0 ( | 2.8.0-beta1 |
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.3.1 |
Sérilog | 2.5.0 | 9.7.0 | 4.3.1 |
NLog | 4.5.0 | 9.7.0 | 6.1.2 |
Microsoft.Extensions.Logging | 3.0.0 | 10.0.0 | 10.0.7 |
L'agent instrumente automatiquement ces systèmes de messages :
Bibliothèques | Supported methods |
|---|---|
Confluent.Kafka |
|
NServiceBus |
|
RabbitMQ |
|
MassTransit (versions d'agent 10.19.0 et plus récentes) |
|
AWSSDK.SQS (Amazon Simple Queue Service) (versions d'agent 10.27.0 et plus récentes) |
|
AWSSDK.Kinesis (Amazon Kinesis Data Streams) (versions d'agent 10.40.0 et ultérieures) |
|
AWSSDK.KinesisFirehose (Amazon Kinesis Firehose) (versions d'agent 10.40.0 et ultérieures) |
|
Azure Service Bus (Azure.Messaging.ServiceBus) (versions d'agent 10.42.0 et plus récentes) |
|
L'agent .NET instrumente automatiquement les performances des appels application .NET vers ces bibliothèques de tâches en arrière-plan et de workflow :
Frameworks | Version minimale du framework | Version minimale de l'agent | Dernière version compatible vérifiée |
|---|---|---|---|
Hangfire | 1.7.0 | 10.51.0 | 1.8.23 |
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
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.
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.
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
L'agent .NET télécharge les données à la fin de chaque cycle de collecte (une fois par minute). Si votre application .NET ne s'exécute pas aussi longtemps, vous pouvez définir l'attribut sendDataOnExit de l'élément service sur true dans le fichier newrelic.config .
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.
AWS Elastic Beanstalk n'est pas un environnement .NET pris en charge.
L'agent nécessite la version CLR 4.0. les applications héritées exécutées sur CLR 2.0 peuvent être instrumentées avec des versions agent inférieures à 7.0.
L’utilisation de Code Access Security est compatible avec l’agent .NET uniquement lorsque Full Trust est fourni. L'agent n'est pas compatible avec des niveaux de confiance plus restrictifs.
Pour obtenir des instructions d’installation spécifiques à Azure, consultez le guide d’installation .NET.
L'agent nécessite que votre pare-feu autorise les connexions sortantes vers des réseaux et des ports spécifiques.
L'agent a besoin d'un de ces systèmes d'exploitation :
Windows Server 2008
Windows Server 2008 R2
Windows Server 2012
Windows Server 2012 R2
Windows Server 2016
Windows Server 2019
Windows Server 2022
Windows 10
Windows 11
Windows Azure (famille de systèmes d'exploitation 1, 2 et 3)
L'agent prend en charge l'exécution dans les versions conteneurisées de tous les systèmes d’exploitation Windows pris en charge, à l'exception connue de
nanoserver.
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.configet 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.
L'agent est disponible en versions 32 bits et 64 bits. Sur un système 64 bits, l'agent 64 bits peut instrumenter à la fois les applications 32 bits et 64 bits.
En tant que mesure de sécurité standard pour la collecte de données, votre serveur d'applications doit prendre en charge SHA-2 (256 bits). SHA-1 n'est pas pris en charge.
Le Common Language Runtime (CLR) .NET permet uniquement à un seul profileur d’accéder à l’API de profilage d’un processus à un moment donné. L'exécution de notre agent .NET avec d'autres logiciels monitoring entraînera un conflit de profileur. Pour plus d'informations, consultez Erreurs lors de l'utilisation d'autres logiciels APM.
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 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 | Autres notes | |
|---|---|---|
Base de données Cosmos | L'agent .NET
| |
Base de canapé | Utilisez CouchbaseNetClient.
| |
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
| |
System.Data.ODBC | Utilisez l'espace de nommage
| |
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.8.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 :
| |
MySQL | Utilisez MySQL.Data ou MySQL connecteur MySql.Data
| |
Oracle | Utiliser Oracle.ManagedDataAccess
| |
PostgreSQL | Utiliser Npgsql
| |
ServiceStack.Redis |
| |
StackExchange. Redis |
| |
Elasticsearch | Utilisez Elastic.Clients.Elasticsearch, NEST ou Elasticsearch.Net. Elastic.Clients.Elasticsearch
| |
Memcached | Utilisez EnyimMemcachedCore.
| |
DynamoDB | Utilisez AWSSDK.DynamoDBv2.
|
L'agent .NET ne collecte pas de données sur les processus du serveur datastore. Il collecte uniquement les données provenant de l'utilisation de la bibliothèque cliente datastore. Pour monitorer directement les processus du serveur datastore, utilisez l'agent New Relic Infrastructure avec intégration sur hôte.
Par défaut, l'agent .NET ne capture pas les paramètres SQL pour les procédures stockées ou les requêtes paramétrées dans une trace de requête. Pour voir ces paramètres SQL, vous devez activer la fonctionnalité de collecte dans la configuration de l'agent.
Par défaut, l'agent collecte les détails de l'instance pour tous les magasins de données pris en charge. Pour demander de l'assistance pour d'autres magasins de données, contactez l'assistance à l'adresse 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 instrumente automatiquement le système de gestion de contenu EPiServer.
L'agent instrumente automatiquement ces bibliothèque d'appels externes :
Bibliothèques | Supported methods |
|---|---|
HttpClient | L'agent instrumente ces méthodes HttpClient :
|
Reste Sharp | L'agent instrumente ces méthodes RestSharp :
|
Requête Web Http | L'agent instrumente ces méthodes HttpWebRequest :
|
Les modèles d’hébergement suivants sont entièrement pris en charge :
- Hébergé par IIS (avec et sans compatibilité ASP)
- Auto-hébergé
Les méthodes d'appel suivantes (client et service) sont prises en charge :
- Synchrone
- Modèle de traitement asynchrone (APM) Début/Fin
- Traitement asynchrone des tâches (TAP)
- Traitement asynchrone basé sur les événements (EAP, support client uniquement)
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 ( | 4.0.17.5 |
OpenAI | 2.0.0 | 10.37.0 ( | 2.8.0 |
Azure.AI.OpenAI | 2.0.0 | 10.37.0 ( | 2.8.0-beta1 |
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.3.1 |
Sérilog | 2.0.0 | 9.7.0 | 4.3.1 |
NLog | 4.1.0 | 9.7.0 | 6.1.2 |
Microsoft.Extensions.Logging | 3.0.0 | 9.7.0 | 10.0.7 |
L'agent instrumente automatiquement ces systèmes de messages :
Bibliothèques | Supported methods |
|---|---|
Confluent.Kafka |
|
MSMQ |
|
NServiceBus |
|
RabbitMQ |
|
MassTransit (versions d'agent 10.19.0 et plus récentes) |
|
AWSSDK.SQS (Amazon Simple Queue Service) (versions d'agent 10.27.0 et plus récentes) |
|
AWSSDK.Kinesis (Amazon Kinesis Data Streams) (versions d'agent 10.40.0 et ultérieures) |
|
AWSSDK.KinesisFirehose (Amazon Kinesis Firehose) (versions d'agent 10.40.0 et ultérieures) |
|
Azure Service Bus (Azure.Messaging.ServiceBus) (versions d'agent 10.42.0 et plus récentes) |
|
L'agent .NET instrumente automatiquement les performances des appels application .NET vers ces bibliothèques de tâches en arrière-plan et de workflow :
Frameworks | Version minimale du framework | Version minimale de l'agent | Dernière version compatible vérifiée |
|---|---|---|---|
Hangfire | 1.7.0 | 10.51.0 | 1.8.23 |
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 :
|
Serveur Blazor | Suivez vos données les plus importantes dans notre dashboard Blazor Server en instrumentant votre application avec New Relic:
|
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 |
|---|---|
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. | |
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. | |
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. | |
Synthétique trace de transaction connecte requests du moniteur Synthétique à la transaction APM sous-jacente. |