Skip to content

Commit f9b4a9c

Browse files
sarjyusufdomalessi
andauthored
Update Windows SSI documentation (#32911)
* Update Windows SSI documentation and logo - Change Windows IIS logo to Windows logo on SSI landing page - Update Windows SSI overview to mention Java and .NET on Windows VMs - Add two-tab structure for Windows instrumentation types: - IIS tab: For .NET applications on IIS only - Host-wide (Preview) tab: For Java and .NET applications across Windows host - Add Preview callout with Product Preview Program signup link - Update SDK terminology throughout Windows page * Fix link rendering in Windows SSI tabs Convert reference-style links to inline links within tabs for proper rendering * copy refinements * format tweaking * Apply suggestions from code review * Update content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/windows.md * Update content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/windows.md * Update content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/windows.md * Update content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/windows.md --------- Co-authored-by: Dominique Alessi <[email protected]> Co-authored-by: domalessi <[email protected]>
1 parent 9b0b344 commit f9b4a9c

File tree

2 files changed

+45
-8
lines changed

2 files changed

+45
-8
lines changed

content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/windows.md

Lines changed: 44 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -11,35 +11,72 @@ further_reading:
1111

1212
## Overview
1313

14-
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.
14+
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.
1515

1616
## Enable APM on Windows
1717

1818
<div class="alert alert-info">Before proceeding, confirm that your environment is compatible by reviewing the <a href="https://docs.datadoghq.com/tracing/trace_collection/automatic_instrumentation/single-step-apm/compatibility/">SSI compatibility guide.</a></div>
1919

20-
To enable APM with Single Step Instrumentation on Windows:
20+
You can enable APM on Windows in the following ways:
21+
* Instrument only .NET applications on IIS
22+
* Instrument all Java and .NET applications across your entire Windows host
2123

22-
1. In Datadog, go to the Install Datadog [Windows Agent page][1] .
24+
{{< callout url="#"
25+
btn_hidden="true" header="Join the Preview!">}}
26+
Host-wide instrumentation for Windows is in Preview.
27+
{{< /callout >}}
28+
29+
{{< tabs >}}
30+
{{% tab "IIS" %}}
31+
32+
To instrument only .NET applications running on IIS:
33+
34+
1. In Datadog, go to [Install the Datadog Agent on Windows][1].
2335
1. In the **Customize your observability coverage** section, toggle **Application Performance Monitoring (APM)**.
24-
1. (Optional) Set your SDK tracer version:
36+
1. (Optional) Set your SDK version:
2537

26-
By default, Single Step Instrumentation installs the latest supported version of the Datadog .NET Tracer. If you need to pin a specific version:
38+
By default, Single Step Instrumentation installs the latest supported version of the Datadog .NET SDK. If you need to pin a specific version:
2739

28-
1. Under **Application Performance Monitoring (APM)**, select **Customize library versions**.
40+
1. Under **Instrumentation Configuration**, select **Customize Library Versions**.
2941
1. Under .NET, choose the version you want to use.
3042

3143
1. Copy and run the provided MSI install command on your Windows host.
3244
1. Restart the IIS applications you want instrumented. (You do not need to restart the entire IIS server.)
3345

3446
After installation, the Agent automatically loads the Datadog .NET SDK into supported application processes to enable distributed tracing.
3547

48+
[1]: https://app.datadoghq.com/fleet/install-agent/latest?platform=windows
49+
50+
{{% /tab %}}
51+
52+
{{% tab "Host-wide (Preview)" %}}
53+
54+
To instrument Java and .NET applications across your entire Windows host:
55+
56+
1. In Datadog, go to [Install the Datadog Agent on Windows][1].
57+
1. In the **Customize your observability coverage** section, toggle **Application Performance Monitoring (APM)**.
58+
1. (Optional) Set your SDK version:
59+
60+
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:
61+
62+
1. Under **Instrumentation Configuration**, select **Customize Library Versions**.
63+
1. Under .NET, choose the version you want to use.
64+
65+
1. Copy and run the provided MSI install command on your Windows host.
66+
1. Restart the services you want instrumented.
67+
68+
[1]: https://app.datadoghq.com/fleet/install-agent/latest?platform=windows
69+
70+
{{% /tab %}}
71+
{{< /tabs >}}
72+
3673
## Configure Unified Service Tags
3774

3875
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][2].
3976

4077
## Enable SDK-dependent products and features
4178

42-
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.
79+
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.
4380

4481
To enable products, [set environment variables][3] in your application configuration.
4582

layouts/partials/apm/apm-single-step.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@
2626
<div class="col">
2727
<a class="card h-100" href="windows">
2828
<div class="card-body text-center py-2 px-1">
29-
{{ partial "img.html" (dict "root" . "src" "integrations_logos/windows_iis_large.svg" "class" "img-fluid" "alt" "windows" "width" "200") }}
29+
{{ partial "img.html" (dict "root" . "src" "integrations_logos/windows.png" "class" "img-fluid" "alt" "windows" "width" "200") }}
3030
</div>
3131
</a>
3232
</div>

0 commit comments

Comments
 (0)