Exigences de compatibilité .NET Core

Exigences de compatibilité .NET Core

La bibliothèque de tracing Datadog .NET est open source. Consultez le référentiel GitHub pour en savoir plus.

Le traceur .NET prend en charge l’instrumentation automatique sur .NET Core 2.1 et 3.1, ainsi que sur .NET Framework.

Le traceur .NET fonctionne sur .NET Core 2.0, 2.2 et 3.0, mais ces versions ont atteint la fin de leur cycle de vie et ne sont plus prises en charge par Microsoft. Consultez la section Politique de prise en charge de Microsoft pour en savoir plus. Nous vous conseillons d’utiliser la dernière version patchée de .NET Core 2.1 ou 3.1. Les anciennes versions de .NET Core sous Linux/x64 présentent des bugs au niveau du compilateur JIT qui peuvent entraîner des exceptions dans les applications lors de l’utilisation de l’instrumentation automatique. Si votre application est basée sur .NET Core 2.0, 2.1.0-2.1.11 ou 2.2.0-2.2.5, nous vous conseillons vivement de mettre à jour votre runtime .NET Core. Si vous ne pouvez pas le mettre à jour, vous devrez peut-être définir la variable d’environnement DD_CLR_DISABLE_OPTIMIZATIONS=true pour contourner le problème. Consultez DataDog/dd-trace-dotnet/issues/302 pour en savoir plus.

Remarque : lorsque vous utilisez à la fois l’instrumentation manuelle et l’instrumentation automatique, il est essentiel de veiller à ce que les versions du package NuGet et du programme d’installation MSI correspondent.

Intégrations

Le traceur .NET peut instrumenter automatiquement les bibliothèques suivantes :

Framework ou bibliothèquePackage NuGetNom de l’intégration
ASP.NET CoreMicrosoft.AspNetCore
Microsoft.AspNetCore.App
2.0+ et 3.0+
AspNetCore
ADO.NETSystem.Data.Common
System.Data.SqlClient 4.0+
AdoNet
HttpClient / HttpMessageHandlerSystem.Net.Http 4.0+HttpMessageHandler
WebClient / WebRequestSystem.Net.Requests 4.0+WebRequest
Redis (client StackExchange)StackExchange.Redis 1.0.187+StackExchangeRedis
Redis (client ServiceStack)ServiceStack.Redis 4.0.48+ServiceStackRedis
ElasticsearchElasticsearch.Net 5.3.0+ElasticsearchNet
MongoDBMongoDB.Driver.Core 2.1.0+MongoDb
PostgreSQLNpgsql 4.0+AdoNet

Remarque : l’intégration ADO.NET instrumente les appels effectués via la classe abstraite DbCommand ou l’interface IDbCommand, sans tenir compte de l’implémentation sous-jacente. Elle instrumente également les appels directs de SqlCommand.

Votre framework préféré n’est pas disponible ? Datadog élargit continuellement la liste des frameworks pris en charge. Contactez l'équipe Datadog pour obtenir de l’aide.

Pour aller plus loin

Documentation, liens et articles supplémentaires utiles: