.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.

Version Microsoft End of Life
.NET 5
.NET Core 3.1 12/03/2022
.NET Core 2.1 08/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 library NuGet package Integration Name
ADO.NET System.Data.Common
System.Data.SqlClient 4.0+
AdoNet
Aerospike Aerospike.Client 4.0.0+ Aerospike
ASP.NET Core Microsoft.AspNetCore
Microsoft.AspNetCore.App
2.0+ and 3.0+
AspNetCore
AWS SQS AWSSDK.SQS 3.0+ AwsSqs
CosmosDb Microsoft.Azure.Cosmos.Client 3.6.0 CosmosDb
Elasticsearch Elasticsearch.Net 5.3.0+ ElasticsearchNet
GraphQL .NET GraphQL 2.3.0+ GraphQL
HttpClient / HttpMessageHandler System.Net.Http 4.0+ HttpMessageHandler
Kafka Confluent.Kafka 1.4+ Kafka
MongoDB MongoDB.Driver.Core 2.1.0+ MongoDb
MySql MySql.Data 6.7.0+ AdoNet
Oracle Oracle.ManagedDataAccess 4.122.0+ AdoNet
PostgreSQL Npgsql 4.0+ AdoNet
RabbitMQ RabbitMQ.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 Remoting Microsoft.ServiceFabric.Services.Remoting 4.0.470+ ServiceRemoting
SQL Server System.Data 4.0.0+
System.Data.SqlClient 4.0.0+
Microsoft.Data.SqlClient 1.0.0+
AdoNet
WCF (server) built-in Wcf
WebClient / WebRequest System.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:

Issue Affected .NET Core Versions Solution More information
JIT Compiler bug on Linux/x64 2.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 issue DataDog/dd-trace-dotnet/issues/302
Resource lookup bug with a non en-US locale 2.0.0 Upgrade .NET Core to 2.0.3 or above dotnet/runtime/issues/23938

Further reading