Usage docs are on the main Datadog website:

• NGINX
• Envoy
• Istio
• C++ code

For some quick-start examples, see the examples folder.

Before considering contributions to the project, please take a moment to read our brief contribution guidelines.

Building this project requires the following tools installed:

• Build tools (e.g. build-essential, xcode)
• cmake >= 3.1

Additional libraries are installed via a script.

• Clone the repository

  git clone https://github.com/DataDog/dd-opentracing-cpp

• Install additional library dependencies (requires sudo)

  cd dd-opentracing-cpp
  sudo scripts/install_dependencies.sh

• Generate build files using cmake

  mkdir .build
  cd .build
  cmake ..

• Run the build

  make

• (Optional) Run the tests

  cmake -DBUILD_TESTING=ON ..
  make
  ctest --output-on-failure

• (Optional) Install to /usr/local

  make install

If you want sanitizers to be enabled, then add either the -DSANITIZE_THREAD=ON -DSANITIZE_UNDEFINED=ON or -DSANITIZE_ADDRESS=ON flags to cmake, running the tests will now also check with the sanitizers.

NOTE: This is currently Early Access, and issues should be reported only via GitHub Issues. Installation steps are likely to change based on user feedback and becoming available via Vcpkg.

Building this project requires the following tools installed:

• Visual Studio 2019 with "Desktop development for C++" installed
• Vcpkg
• Git

The commands below should be executed in an x64 Native Tools Command Prompt shell.

• Clone the repository

  cd %HOMEPATH%
  git clone https://github.com/DataDog/dd-opentracing-cpp

• Generate build files using cmake

  cd dd-opentracing-cpp
  mkdir .build
  cd .build
  cmake -DCMAKE_TOOLCHAIN_FILE=%HOMEPATH%\vcpkg\scripts\buildsystems\vcpkg.cmake ..

• Run the build

  cmake --build . -- -p:Configuration=RelWithDebInfo

Integration tests require additional tools installed:

• msgpack-cli
• wiremock
• jq

Installation details can be extracted from the Dockerfile for the container that is usually used when running integration tests.

Run this command to run the integration tests directly.

test/integration/run_integration_tests_local.sh