Skip to content

Domalessi/ssi updates #33195

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
domalessi wants to merge 3 commits into
base: master
Choose a base branch
from
Open

Domalessi/ssi updates #33195

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
06bca3f
update sections for adding sdk-dependent functionality such that they…
domalessi Dec 5, 2025
4a2d9b6
add note about EKS and ECS Fargate
domalessi Dec 5, 2025
841d847
add note about startup times
domalessi Dec 5, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions ...ing/trace_collection/automatic_instrumentation/single-step-apm/compatibility.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,8 @@ Single Step Instrumentation (SSI) has compatibility requirements that vary by op

## Compatibility by application environment

<div class="alert alert-warning">ECS Fargate is not supported.</div>

Select your environment to see compatibility requirements and limitations:

{{< tabs >}}
Expand Down Expand Up @@ -57,6 +59,8 @@ Select your environment to see compatibility requirements and limitations:

{{% tab "Kubernetes" %}}

<div class="alert alert-info">EKS Fargate support is in Preview.</div>

### Compatibility

- **Status**: GA
Expand Down
7 changes: 6 additions & 1 deletion ...en/tracing/trace_collection/automatic_instrumentation/single-step-apm/docker.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,8 @@ To enable APM in a Docker Linux container:
1. Copy and run the Agent installation command in your Docker container.
1. Restart your applications.

<div class="alert alert-info">SSI adds a small amount of startup time to instrumented applications. If this overhead is not acceptable for your use case, contact <a href="/help/">Datadog Support</a>.</div>

## Set SDK tracer versions

By default, Single Step Instrumentation installs the latest major versions of Datadog APM SDKs. Minor version updates are applied automatically when they become available.
Expand Down Expand Up @@ -61,7 +63,7 @@ Unified Service Tags (USTs) apply consistent tags across traces, metrics, and lo

## 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.
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][18], [App and API Protection][19], and [trace ingestion controls][20].

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

Expand Down Expand Up @@ -114,6 +116,9 @@ If you encounter problems enabling APM with SSI, see the [SSI troubleshooting gu
[15]: https://app.datadoghq.com/fleet/install-agent/latest?platform=docker
[16]: /getting_started/tagging/unified_service_tagging/?tab=docker#containerized-environment
[17]: /tracing/trace_collection/automatic_instrumentation/single-step-apm/troubleshooting
[18]: /profiler/
[19]: /security/application_security/
[20]: /tracing/trace_pipeline/ingestion_controls/



7 changes: 6 additions & 1 deletion ...racing/trace_collection/automatic_instrumentation/single-step-apm/kubernetes.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,8 @@ Follow these steps to enable Single Step Instrumentation across your entire clus
1. Deploy the Agent using the generated configuration file.
1. Restart your applications.

<div class="alert alert-info">SSI adds a small amount of startup time to instrumented applications. If this overhead is not acceptable for your use case, contact <a href="/help/">Datadog Support</a>.</div>

## Configure Unified Service Tags

Unified Service Tags (USTs) apply consistent tags across traces, metrics, and logs, making it easier to navigate and correlate your observability data. You can configure USTs through label extraction (recommended) or in deployment manifests.
Expand Down Expand Up @@ -128,7 +130,7 @@ For complete instructions, see [setting USTs for Kubernetes services][5].

## 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.
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][37], [Application Security Monitoring][38], and [trace ingestion controls][39].

Use one of the following setup methods:

Expand Down Expand Up @@ -788,6 +790,9 @@ If you encounter problems enabling APM with SSI, see the [SSI troubleshooting gu
[34]: /containers/guide/sync_container_images/#copy-an-image-to-another-registry-using-crane
[35]: /tracing/trace_collection/automatic_instrumentation/single-step-apm/troubleshooting
[36]: /tracing/trace_collection/automatic_instrumentation/single-step-apm/compatibility/
[37]: /profiler/
[38]: /security/application_security/
[39]: /tracing/trace_pipeline/ingestion_controls/



7 changes: 6 additions & 1 deletion .../en/tracing/trace_collection/automatic_instrumentation/single-step-apm/linux.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,8 @@ To enable APM on a Linux host:
1. Copy and run the Agent installation command on your Linux host or VM.
1. Restart your applications.

<div class="alert alert-info">SSI adds a small amount of startup time to instrumented applications. If this overhead is not acceptable for your use case, contact <a href="/help/">Datadog Support</a>.</div>

## Set SDK tracer versions

By default, Single Step Instrumentation installs the latest versions of Datadog APM SDKs.
Expand Down Expand Up @@ -86,7 +88,7 @@ Unified Service Tags (USTs) apply consistent tags across traces, metrics, and lo

## 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.
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][21], [Application Security Monitoring][22], and [trace ingestion controls][23].

Use one of the following setup methods:

Expand Down Expand Up @@ -184,5 +186,8 @@ If you encounter problems enabling APM with SSI, see the [SSI troubleshooting gu
[18]: /tracing/trace_collection/automatic_instrumentation/configure_apm_features_linux/
[19]: /tracing/trace_collection/automatic_instrumentation/single-step-apm/troubleshooting
[20]: https://app.datadoghq.com/apm/service-setup/workload-selection
[21]: /profiler/
[22]: /security/application_security/
[23]: /tracing/trace_pipeline/ingestion_controls/


9 changes: 7 additions & 2 deletions ...n/tracing/trace_collection/automatic_instrumentation/single-step-apm/windows.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -70,13 +70,15 @@ To instrument Java and .NET applications across your entire Windows host:
{{% /tab %}}
{{< /tabs >}}

<div class="alert alert-info">SSI adds a small amount of startup time to instrumented applications. If this overhead is not acceptable for your use case, contact <a href="/help/">Datadog Support</a>.</div>

## Configure Unified Service Tags

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].

## 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.
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][5], [Application Security Monitoring][6], and [trace ingestion controls][7].

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

Expand All @@ -99,4 +101,7 @@ If you encounter problems enabling APM with SSI, see the [SSI troubleshooting gu
[1]: https://app.datadoghq.com/fleet/install-agent/latest?platform=windows
[2]: /integrations/windows-service/#tags
[3]: /tracing/trace_collection/library_config/
[4]: /tracing/trace_collection/automatic_instrumentation/single-step-apm/troubleshooting
[4]: /tracing/trace_collection/automatic_instrumentation/single-step-apm/troubleshooting
[5]: /profiler/
[6]: /security/application_security/
[7]: /tracing/trace_pipeline/ingestion_controls/
Loading