Single Step APM Instrumentation on Windows
Overview
With Single Step Instrumentation (SSI), you can automatically enable APM for your .NET Framework and .NET Core applications running on Windows IIS, using a single MSI command during the Datadog Agent installation. No separate SDK installation or code changes are required.
Enable APM on Windows
Note: Only .NET applications running in IIS are supported for Single Step Instrumentation on Windows.
To enable APM with Single Step Instrumentation on Windows:
In Datadog, go to the Install Datadog Windows Agent page .
In the Customize your observability coverage section, toggle Application Performance Monitoring (APM).
(Optional) Set your SDK tracer version:
By default, Single Step Instrumentation installs the latest supported version of the Datadog .NET Tracer. If you need to pin a specific version:
- Under Application Performance Monitoring (APM), select Customize library versions.
- Under .NET, choose the version you want to use.
Copy and run the provided MSI install command on your Windows host.
Restart the IIS applications you want instrumented. (You do not need to restart the entire IIS server.)
After installation, the Agent automatically loads the Datadog .NET SDK into supported application processes to enable distributed tracing.
Unified Service Tags (USTs) apply consistent tags across traces, metrics, and logs, making it easier to navigate and correlate your observability data. Learn how to set USTs for Windows services.
Enable SDK-dependent products and features
Once SSI loads the Datadog SDK into your applications and enables distributed tracing, you can configure additional products that rely on the SDK. These include capabilities such as Continuous Profiler, Application Security Monitoring, and trace ingestion controls.
To enable products, set environment variables in your application configuration.
Remove Single Step APM instrumentation from your Agent
To disable SSI for .NET on your host, run:
&"C:\Program Files\Datadog\Datadog Agent\bin\datadog-installer.exe" remove datadog-apm-library-dotnet
Troubleshooting
If you encounter problems enabling APM with SSI, see the SSI troubleshooting guide.
Further reading
Additional helpful documentation, links, and articles:
