Single Step APM Instrumentation on Windows
Overview
With Single Step Instrumentation (SSI), you can enable APM for your Java and .NET applications on Windows VMs using a single Datadog Agent installation command.
Enable APM on Windows
You can enable APM on Windows in the following ways:
- Instrument only .NET applications on IIS
- Instrument all Java and .NET applications across your entire Windows host
Join the Preview!
Host-wide instrumentation for Windows is in Preview.
To instrument only .NET applications running on IIS:
In Datadog, go to Install the Datadog Agent on Windows.
In the Customize your observability coverage section, toggle Application Performance Monitoring (APM).
(Optional) Set your SDK version:
By default, Single Step Instrumentation installs the latest supported version of the Datadog .NET SDK. If you need to pin a specific version:
- Under Instrumentation Configuration, 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.
To instrument Java and .NET applications across your entire Windows host:
In Datadog, go to Install the Datadog Agent on Windows.
In the Customize your observability coverage section, toggle Application Performance Monitoring (APM).
(Optional) Set your SDK version:
By default, Single Step Instrumentation installs the latest supported version of the Datadog .NET and Java SDK. If you need to pin a specific version:
- Under Instrumentation Configuration, 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 services you want instrumented.
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
After 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:
