NOTE: The .NET Tracer is currently in Public Beta.

Please read our documentation for instructions on setting up .NET tracing and details about supported frameworks.

Package	Download
Windows and Linux Installers	See releases
Datadog.Trace
Datadog.Trace.OpenTracing
Datadog.Trace.ClrProfiler.Managed

Pipeline	develop	master
Windows C# unit tests
Windows C++ unit tests
Windows integration tests
Linux C# unit tests
Linux integration tests

Datadog Trace Agent: A service that runs on your application servers, accepting trace data from the Datadog Tracer and sending it to Datadog. The Trace Agent is not part of this repo; it's the same Trace Agent to which all Datadog tracers (e.g. Go, Python, Java, Ruby) send data.

Datadog .NET Tracer: This repository. A set of .NET libraries that let you trace any piece of your .NET code. Supports manual instrumentation and can automatically instrument supported libraries out-of-the-box.

Minimum requirements to build the code in this repository:

• Visual Studio 2017 v15.7 or newer
  • Workloads
    • Desktop development with C++
    • .NET desktop development
    • .NET Core cross-platform development
    • Optional: ASP.NET and web development (to build samples)
  • Individual components
    • .NET Framework 4.7 targeting pack
• .NET Core 2.1 SDK or newer
• Optional: WiX Toolset 3.11.1 or newer to build Windows installer (msi)
  • Requires .NET Framework 3.5 SP2 (install from Windows Features control panel: OptionalFeatures.exe)
  • WiX Toolset VS2017 Extension to build installer from VS2017
• Optional: Docker for Windows to run Linux tests
  • Requires Windows 10 (1607 Anniversary Update, Build 14393 or newer)

Microsoft provides evaluation developer VMs with Windows 10 and Visual Studio 2017 pre-installed.

Minimum requirements to build the code in this repository:

• .NET Core SDK 2.1 or newer
• Docker

You can use Docker Compose with Linux containers to run the test suites. This works on both Linux and Windows hosts.

# build C# projects
docker-compose run build

# build C++ project
docker-compose run Datadog.Trace.ClrProfiler.Native

# run integration tests
docker-compose run Datadog.Trace.ClrProfiler.IntegrationTests

Datadog APM

• Datadog APM
• Datadog APM - Tracing .NET Applications
• Datadog APM - Advanced Usage

Microsoft .NET Profiling APIs

• Profiling API
• Metadata API
• The Book of the Runtime - Profiling

OpenTracing

• OpenTracing documentation
• OpenTracing terminology

If you have questions, feedback, or feature requests, reach our support.