.NET and .NET Core Compatibility Requirements
The Datadog .NET Tracer supports all .NET-based languages (for example, C#, F#, Visual Basic). It has beta support for trimmed apps.
The .NET Tracer is open source. For more information, see the .NET Tracer repository.
Supported .NET and .NET Core runtimes
The .NET Tracer supports automatic instrumentation on the following .NET and .NET Core versions. It also supports .NET Framework.
| .NET Version | Microsoft End of Life | Support level | Package version |
|---|
| .NET 8 | | GA | latest (>= 2.42.0) |
| .NET 7 | 05/14/2024 | GA | latest (>= 2.20.0) |
| .NET 6 | | GA | latest (>= 2.0.0) |
| .NET 5 | 05/10/2022 | GA | latest (>= 2.0.0) |
| .NET Core 3.1 | 12/13/2022 | GA | latest |
| .NET Core 3.0 | 03/03/2020 | EOL | Not recommended |
| .NET Core 2.2 | 12/23/2019 | EOL | Not recommended |
| .NET Core 2.1 | 08/21/2021 | EOL | Not recommended |
| .NET Core 2.0 | 10/01/2018 | EOL | Not recommended |
Additional information can be found in Microsoft’s .NET and .NET Core Lifecycle Policy, End of life .NET runtime versions, and .NET runtime support policy.
Supported processor architectures
The .NET Tracer supports automatic instrumentation on the following architectures:
| Processor architectures | Support level | Package version |
|---|
Windows x64 (win-x64) | GA | latest |
Windows x86 (win-x86) | GA | < 3.0.0 (e.g. 2.56.0) |
Linux x64 (linux-x64) | GA | latest |
Alpine Linux x64 (linux-musl-x64) | GA | latest |
Linux ARM64 (linux-arm64) | GA | .NET 5+ only, added in version 1.27.0 |
Alpine Linux arm64 (linux-musl-arm64) | GA | .NET 6+ only, added in version 3.2.0 |
Note that running 32-bit applications on Windows x64 is supported.
Supported operating systems
The .NET Tracer supports automatic instrumentation on Windows and Linux operating systems. It supports macOS for CI Test Optimization only.
Windows
| Operating System | Version | Support level | Package version |
|---|
| Windows Server (x64) | 2012+ | GA | latest |
| Windows Client (x64) | 8.1+ | GA | latest |
| Nano Server (x64) | < 2012 | EOL | < 3.0.0 (e.g. 2.48.0) |
| Windows Server (x64) | < 2012 | EOL | < 3.0.0 (e.g. 2.48.0) |
| Windows Server (x86) | All versions | EOL | < 3.0.0 (e.g. 2.48.0) |
Additional information on the operating systems supported by .NET and .NET Core can be found in the .NET release notes
Linux
The .NET Tracer supports Linux distributions as best-effort, based on minimum libc version compatibility:
- x64: glibc 2.17 (from CentOS 7)
- Arm64: glibc 2.23 (from Debian 10)
- Alpine x64: musl 1.2.2 (from Alpine 3.14)
- Alpine arm64: musl 1.2.4 (from Alpine 3.18)
| Operating System | Version | Architectures | Support level | Package version |
|---|
| Alpine Linux (x64) | 3.14+ | x64, | GA | latest (.NET 5+ only, v1.27.0+) |
| Alpine Linux (arm64) | 3.18+ | Arm64 | GA | latest (.NET 6+ only, v3.2.0+) |
| CentOS Linux | 7+ | x64 | Maintenance | latest (EOL in v4.0.0) |
| CentOS Stream Linux | 8 | x64 | Maintenance | latest (EOL in v4.0.0) |
| Debian | 10+ | x64, Arm64 | GA | latest |
| Fedora | 29+ | x64 | GA | latest |
| openSUSE | 15+ | x64 | GA | latest |
| Red Hat Enterprise Linux | 7+ | x64 | GA | latest |
| Ubuntu | 18.04+ | x64, Arm64 | GA | latest |
macOS
The .NET Tracer supports macOS for CI Test Optimization only
| Operating System | Version | Architectures | Support level | Package version |
|---|
| macOS | 12.0+ | x64, Arm64 | GA | latest |
| macOS | 11.0 | x64 | EOL | < 3.0.0 |
| macOS | 11.0 | Arm64 | EOL | < 3.0.0 (Added in 2.20.0) |
Integrations
The latest version of the .NET Tracer can automatically instrument the following libraries:
| Framework or library | NuGet package | Integration Name |
|---|
| ADO.NET | All AdoNet integrations | AdoNet |
| Aerospike | Aerospike.Client 4.0.0+ | Aerospike |
| ASP.NET Core | Microsoft.AspNetCoreMicrosoft.AspNetCore.App2.0+ and 3.0+ | AspNetCore |
| Azure Functions | Microsoft.Azure.Webjobs 3.0+ | AzureFunctions |
| Amazon DynamoDB | AWSSDK.DynamoDBv2 3.0+ | AwsDynamoDb |
| Amazon Kinesis | AWSSDK.Kinesis 3.0+ | AwsKinesis |
| Amazon SNS | AWSSDK.SNS 3.0+ | AwsSns |
| Amazon SQS | AWSSDK.SQS 3.0+ | AwsSqs |
| CosmosDb | Microsoft.Azure.Cosmos 3.6.0+ | CosmosDb |
| Couchbase | CouchbaseNetClient 2.2.8+ | Couchbase |
| Elasticsearch | Elasticsearch.Net 5.3.0+ | ElasticsearchNet |
| GraphQL .NET | GraphQL 2.3.0+ | GraphQL |
| gRPC | Grpc.Net.Client2.30.0+ (.NET Core 3.0+ only)Grpc.Core 2.30.0+Grpc.AspNetCore 2.30.0+ | Grpc |
| HotChocolate | HotChocolate 11.0.0+ | HotChocolate |
| HttpClient / HttpMessageHandler | System.Net.Http 4.0+ | HttpMessageHandler |
| Kafka | Confluent.Kafka 1.4+ | Kafka |
| IBM MQ | amqmdnetstd 9.0.0+ | IbmMq |
| MongoDB | MongoDB.Driver.Core 2.1.0+ | MongoDb |
| MySql | MySql.Data 6.7.0+MySqlConnector 0.61.0+ | MySql |
| Oracle | Oracle.ManagedDataAccess 4.122.0+ | Oracle |
| PostgreSQL | Npgsql 4.0+ | Npgsql |
| Process | "System.Diagnostics.Process" 4.0+ | Process |
| 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 |
| SQLite | System.Data.Sqlite 2.0.0+Microsoft.Data.Sqlite 1.0.0+ | Sqlite |
| SQL Server | System.Data 4.0.0+System.Data.SqlClient 4.0.0+Microsoft.Data.SqlClient 1.0.0+ | SqlClient |
| WebClient / WebRequest | System.Net.Requests 4.0+ | WebRequest |
Don’t see the library you’re looking for? First, check if the library produces observability data compatible with OpenTelemetry (see Using OpenTelemetry Instrumentation Libraries for more details). If not, Datadog is continually adding additional support. Check with the Datadog team for help.
End of life .NET runtime versions
The .NET Tracer works on .NET Core 2.0, 2.1, 2.2, 3.0, and 3.1, and on .NET 5 and 7, but these versions reached their end of life and are no longer supported by Microsoft. See Microsoft’s support policy for more details. Datadog recommends using the latest patch version of .NET 6 or .NET 8. Older versions of .NET and .NET Core may encounter the following runtime issues when enabling automatic instrumentation:
Supported Datadog Agent versions
| Datadog Agent version | Package version |
|---|
| 7.x | Latest |
| 6.x | Latest |
| 5.x | Latest |
.NET runtime support policy
The .NET Tracer depends on the host operating system, .NET runtime, certain .NET libraries, and the Datadog Agent/API. These third party software systems support specific versions of .NET and .NET Core. When the external software no longer supports a version of .NET, the .NET Tracer also limits its support for that version.
Levels of support
| Level | Support provided |
|---|
| Unsupported | No implementation. Contact customer support for special requests. |
| Beta | Initial implementation. May not yet contain all features. Support for new features, bug & security fixes provided on a best-effort basis. |
| General Availability (GA) | Full implementation of all features. Full support for new features, bug & security fixes. |
| Maintenance | Full implementation of existing features. Does not receive new features. Support for bug & security fixes only. |
| End-of-life (EOL) | No support. |
Package versioning
The .NET Tracer practices semantic versioning.
Version updates imply the following changes to runtime support:
- Major version updates (for example
1.0.0 to 2.0.0) may change support for any runtime from Beta/GA to Maintenance/EOL. - Minor version updates (for example
1.0.0 to 1.1.0) won’t lower the level of support for one runtime but may add support for one. - Patch version updates (for example
1.0.0 to 1.0.1) will not change support for any runtime.
Further reading
Additional helpful documentation, links, and articles:
