This package contains the full Datadog .NET APM suite for Tracing (automatic, and custom), Continuous Profiler and Application Security Monitoring (ASM).
Should I install this package?
Do not install this package if any of the following are true:
You instrument your application using the .NET dd-trace tool. Install Datadog.Trace instead if you need custom instrumentation.
Your application is running in Azure App Services. Install the AAS extension instead.
Your application is running in IIS on Windows. This package is not supported; install the MSI instead, and install Datadog.Trace if you also need custom instrumentation.
Install this package if:
You are running in a scenario where you can't install an MSI or Linux package. Services such as Azure Service Fabric provide limited access to the underlying server.
You want to use both custom and automatic instrumentation, and keeping tracer versions in-sync is a chore.
You are running multiple applications on a server and some of them use custom instrumentation, as well as automatic instrumentation.
You prefer to deploy a static set of binaries rather than relying on existing infrastructure on the host.
If you are using automatic instrumentation and would like to interact with APM only through C# attributes, see the Datadog.Trace.Annotations NuGet package.
The native binaries required for automatic instrumentation, for the Continuous Profiler, and for ASM.
These native binaries are identical to those installed by the MSI and Linux installer packages, so Datadog.Trace.Bundle should be considered an alternative deployment mechanism for automatic instrumentation.
The main advantages of Datadog.Trace.Bundle over the MSI or Linux packages are:
You can use it in locations where you cannot access the underlying host to install the MSI or Linux package.
You can have multiple applications on the same host using different versions of Datadog.Trace.Bundle without issue.
After adding the NuGet package to your project, set the following required environment variables to enable automatic instrumentation of your application and restart the application.
NOTE:
The following are the mandatory variables. For further configuration options, see our public documentation for the Tracer and the Continuous Profiler.
The value for the <APP_DIRECTORY> placeholder is the path to the directory containing the application’s .dll files. The value for the CORECLR_PROFILER_PATH/COR_PROFILER_PATH environment variable varies based on the system where the application is running: