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.
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.
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 |
The latest version of the .NET Tracer can automatically instrument the following libraries:
| Framework or library | NuGet package | Integration Name |
|---|---|---|
| ADO.NET | System.Data.CommonSystem.Data.SqlClient 4.0+ | AdoNet |
| Aerospike | Aerospike.Client 4.0.0+ | Aerospike |
| ASP.NET Core | Microsoft.AspNetCoreMicrosoft.AspNetCore.App2.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 |
| 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.
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 |
Documentation, liens et articles supplémentaires utiles:
