Skip to content

Latest commit

 

History

History

profiler

README.MD

dd-trace-dotnet/profiler

This folder contains the source code for the Datadog .NET APM Profiler. The .NET Profiler runs in your application process to collect managed threads call stacks related to wall time, CPU consumption, and exceptions.

Installation and usage

Getting started

Configure the Datadog Agent for APM as described in our documentation. To install and enable the .NET Profiler follow the steps as described in our documentation.

Development

You can develop the profiler on various environments.

Windows

Setup and minimum requirements

  • Visual Studio 2019/2022
    • Workloads
      • Desktop development with C++
      • .NET desktop development
      • .NET Core cross-platform development
    • Individual components
      • .NET Framework 4.7 targeting pack
      • C++ for Linux Development
      • Windows 10 SDK (10.0.18362)

Building in Visual Studio

Open the solution dd-trace-dotnet\Datadog.Profiler.sln and build the projects Datadog.Profiler.Native.Windows (C++).

Building with script

Go to the Tracer folder and use the NUKE build.cmd script

..\tracer\build.cmd BuildProfilerHome BuildNativeLoader

Note: build Release binaries by default; use --buildConfiguration Debug for debug build

Linux

Minimun requirements

To build C# projects

To build C++ projects

  • Clang >= 9.0 (recommended)
  • CMake >= 3.14
  • Libtool
  • liblzma
  • libssl-dev
  • autoconf
  • git

Building from the command line

Go to the Tracer folder and use the NUKE build.cmd script

../tracer/build.sh BuildProfilerHome BuildNativeLoader

You could also use the following to Build C++ projects and run the unit tests

CXX=clang++ CC=clang cmake -S dd-trace-dotnet -B _build
cd _build
make -j
ctest

Note: the clang compiler often find errors that are not seen by Visual Studio