.NET Core Compatibility Requirements

.NET Core Compatibility Requirements

  • The .NET Tracer supports all .NET-based languages (for example, C#, F#, Visual Basic).

  • The .NET Tracer library for Datadog is open source. For more information, see the .NET Tracer repository.

Supported .NET Core runtimes

The .NET Tracer supports automatic instrumentation on the following .NET Core versions. It also supports .NET Framework.

VersionMicrosoft End of Life
.NET 5
.NET Core 3.112/03/2022
.NET Core 2.108/21/2021

Additional information on .NET Core support policy can be found within Microsoft’s .NET Core Lifecycle Policy.

Supported processor architectures

The .NET Tracer supports automatic instrumentation on the following architectures:

Processor architectures
Windows x86 (win-x86)
Windows x64 (win-x64)
Linux x64 (linux-x64)
Alpine Linux x64 (linux-musl-x64)
Linux ARM64 (linux-arm64)

.NET 5 only, added in version 1.27.0

Integrations

The latest version of the .NET Tracer can automatically instrument the following libraries:

Framework or libraryNuGet packageIntegration Name
ADO.NETSystem.Data.Common
System.Data.SqlClient 4.0+
AdoNet
AerospikeAerospike.Client 4.0.0+Aerospike
ASP.NET CoreMicrosoft.AspNetCore
Microsoft.AspNetCore.App
2.0+ and 3.0+
AspNetCore
AWS SQSAWSSDK.SQS 3.0+AwsSqs
CosmosDbMicrosoft.Azure.Cosmos.Client 3.6.0CosmosDb
ElasticsearchElasticsearch.Net 5.3.0+ElasticsearchNet
HttpClient / HttpMessageHandlerSystem.Net.Http 4.0+HttpMessageHandler
KafkaConfluent.Kafka 1.4+Kafka
MongoDBMongoDB.Driver.Core 2.1.0+MongoDb
MySqlMySql.Data 6.7.0+AdoNet
OracleOracle.ManagedDataAccess 4.122.0+AdoNet
PostgreSQLNpgsql 4.0+AdoNet
RabbitMQRabbitMQ.Client 3.6.9+RabbitMQ
Redis (ServiceStack client)ServiceStack.Redis 4.0.48+ServiceStackRedis
Redis (StackExchange client)StackExchange.Redis 1.0.187+StackExchangeRedis
Service Fabric RemotingMicrosoft.ServiceFabric.Services.Remoting 4.0.470+ServiceRemoting
SQL ServerSystem.Data 4.0.0+
System.Data.SqlClient 4.0.0+
Microsoft.Data.SqlClient 1.0.0+
AdoNet
WCF (server)built-inWcf
WebClient / WebRequestSystem.Net.Requests 4.0+WebRequest

Don’t see your desired frameworks? Datadog is continually adding additional support. Check with the Datadog team for help.

Out of support .NET Core versions

The .NET Tracer works on .NET Core 2.0, 2.1, 2.2, and 3.0, but these versions reached their end of life and are no longer supported by Microsoft. See Microsoft’s support policy for more details. We recommend using the latest patch version of .NET Core 3.1 or .NET 5. Older versions of .NET Core may encounter the following runtime issues when enabling automatic instrumentation:

IssueAffected .NET Core VersionsSolutionMore information
JIT Compiler bug on Linux/x642.0.x,
2.1.0-2.1.11,
2.2.0-2.2.5
Upgrade .NET Core to the latest patch version, or follow steps in the linked issueDataDog/dd-trace-dotnet/issues/302
Resource lookup bug with a non en-US locale2.0.0Upgrade .NET Core to 2.0.3 or abovedotnet/runtime/issues/23938

Further reading