Instrumentation library for Datadog APM.
Get Started
$ dotnet add package Datadog.TraceReadme
Datadog.Trace NuGet package
This package contains the Datadog .NET APM tracer for configuring custom instrumentation.
⚠ Starting with version 3.0.0, this package requires that you also configure automatic instrumentation. Using this package without automatic instrumentation is no longer supported
If you are only using automatic instrumentation, you do not need this package. Please read our documentation for details on how to install the tracer for automatic instrumentation.
If you are using automatic instrumentation and would like to interact with APM only through C# attributes, see the Datadog.Trace.Annotations NuGet package.
Please note that Datadog does not support tracing (manual or automatic) in partial-trust environments.
Getting Started
- Configure the Datadog agent for APM as described in our documentation.
- Configure automatic instrumentation as described in our documentation.
- Configure custom instrumentation, as shown below
- View your live data on Datadog.
Configuring Datadog in code
There are multiple ways to configure your application: using environment variables, a web.config file, or a datadog.json file, as described in our documentation. This NuGet package also allows you to configure settings in code.
To override configuration settings, create an instance of TracerSettings, and pass it to the static Tracer.Configure() method:
using Datadog.Trace;
// Create a settings object using the existing
// environment variables and config sources
var settings = TracerSettings.FromDefaultSources();
// Override a value
settings.GlobalTags.Add("SomeKey", "SomeValue");
// Replace the tracer configuration
Tracer.Configure(settings);