Skip to content

trafi/dd-trace-dotnet

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

.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
Datadog.Trace.OpenTracing Datadog.Trace.OpenTracing
Datadog.Trace.ClrProfiler.Managed Datadog.Trace.ClrProfiler.Managed

Build Status

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

Development

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

  • 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
  • Optional: nuget.exe CLI v3.4.4 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 build Linux binaries and run integration tests on Linux containers. See section on Docker Compose.
    • Requires Windows 10 (1607 Anniversary Update, Build 14393 or newer)

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

Building from a command line

From a Developer Command Prompt for VS 2017:

rem Restore NuGet packages
rem nuget.exe is required for command line restore because msbuild doesn't support packages.config
rem (see https://github.com/NuGet/Home/issues/7386)
nuget restore Datadog.Trace.sln

rem Build C# projects (Platform: always AnyCPU)
msbuild Datadog.Trace.proj /t:BuildCsharp /p:Configuration=Release;Platform=AnyCPU

rem Build NuGet packages
dotnet pack src\Datadog.Trace\Datadog.Trace.csproj
dotnet pack src\Datadog.Trace.OpenTracing\Datadog.Trace.OpenTracing.csproj
dotnet pack src\Datadog.Trace.ClrProfiler.Managed\Datadog.Trace.ClrProfiler.Managed.csproj

rem Build C++ projects (Platform: x64 or x86)
msbuild Datadog.Trace.proj /t:BuildCpp /p:Configuration=Release;Platform=x64

rem Build MSI installer (Platform: x64 or x86)
msbuild Datadog.Trace.proj /t:msi /p:Configuration=Release;Platform=x64

Linux

Minimum requirements

To build C# projects and NuGet packages only

To build everything and run integration tests

Building and running tests with Docker Compose

You can use Docker Compose with Linux containers to build Linux binaries and 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

Further Reading

Datadog APM

Microsoft .NET Profiling APIs

OpenTracing

Get in touch

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

Packages

No packages published

Languages

  • C++ 67.6%
  • C 21.4%
  • C# 7.6%
  • JavaScript 2.6%
  • Assembly 0.3%
  • Perl 0.2%
  • Other 0.3%