.NET Tests

.NET Tests

Compatibility

Supported .NET versions:

  • .NET Core >= 2.1 and >= 3.0
  • .NET >= 5.0

Supported test frameworks:

  • xUnit >= 2.2
  • NUnit >= 3.0
  • MsTest V2 >= 14

Prerequisites

Install the Datadog Agent to collect tests data.

Installing the .NET tracer

To install or update the dd-trace command globally on the machine, run:

dotnet tool update -g dd-trace

Instrumenting tests

To instrument your test suite, prefix your test command with dd-trace, providing the name of the service or library under test as the --dd-service parameter, and the environment where tests are being run (for example, local when running tests on a developer workstation, or ci when running them on a CI provider) as the --dd-env parameter. For example:

dd-trace --dd-service=my-dotnet-app --dd-env=ci -- dotnet test

All tests are automatically instrumented.

Configuration settings

You can change the default configuration of the CLI by using command line arguments or environment variables. For a full list of configuration settings, run:

dd-trace --help

The following list shows the default values for key configuration settings:

--dd-service
Name of the service or library under test.
Environment variable: DD_SERVICE
Default: The repository name
Example: my-dotnet-app
--dd-env
Name of the environment where tests are being run.
Environment variable: DD_ENV
Default: none
Examples: local, ci
--agent-url
Datadog Agent URL for trace collection in the form http://hostname:port.
Environment variable: DD_TRACE_AGENT_URL
Default: http://localhost:8126

All other Datadog Tracer configuration options can also be used.

Further reading