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 Agent: A service that runs on your application servers, accepting trace data from the Datadog Tracer and sending it to Datadog. The Agent is not part of this repo; it's the same 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
- Workloads
- .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
- Requires .NET Framework 3.5 SP2 (install from Windows Features control panel:
- 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.IntegrationTestsDatadog APM
Microsoft .NET Profiling APIs
OpenTracing
If you have questions, feedback, or feature requests, reach our support.