.NET Tracer for Datadog APM

Installation and Usage

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

Downloads

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

Build Status

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

Development

The Components

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.

Windows

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.

Linux

Minimum requirements to build the code in this repository:

.NET Core SDK 2.1 or newer
Docker

Running tests in Linux containers

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

Get in touch

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

cailin-lai/dd-trace-dotnet