.NET Framework Compatibility Requirements

.NET Framework Compatibility Requirements



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

  • The .NET Tracer supports instrumentation on .NET Framework 4.5 and above (using CLR v4.0). It also supports .NET Core.

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

  • Datadog automatic instrumentation relies on the .NET CLR Profiling API. This API allows only one subscriber (for example, APM). To ensure maximum visibility, run only one APM solution within your application environment.
  • If you are using both automatic and custom instrumentation, it is important to keep the package versions (for example, MSI and NuGet) in sync.


The .NET Tracer can instrument the following libraries automatically:

Framework or libraryNuGet packageIntegration Name
ASP.NET (including Web Forms)built-inAspNet
ASP.NET MVCMicrosoft.AspNet.Mvc 4.0+AspNetMvc
ASP.NET Web API 2Microsoft.AspNet.WebApi 5.1+AspNetWebApi2
WCF (server)built-inWcf
HttpClient / HttpMessageHandlerbuilt-inHttpMessageHandler
WebClient / WebRequestbuilt-inWebRequest
Redis (StackExchange client)StackExchange.Redis 1.0.187+StackExchangeRedis
Redis (ServiceStack client)ServiceStack.Redis 4.0.48+ServiceStackRedis
ElasticsearchElasticsearch.Net 5.3.0+ElasticsearchNet
MongoDBMongoDB.Driver.Core 2.1.0+MongoDb
PostgreSQLNpgsql 4.0+AdoNet
RabbitMQRabbitMQ.Client 3.6.9+RabbitMQ
Note: The ADO.NET integration instruments calls made through the DbCommand abstract class or the IDbCommand interface, regardless of the underlying implementation. It also instruments direct calls to SqlCommand and NpgsqlCommand.

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

Further reading