From 06bca3f82fd9f09b11772091b05c80773fcabf47 Mon Sep 17 00:00:00 2001 From: Dominique Alessi Date: Fri, 5 Dec 2025 14:17:06 -0500 Subject: [PATCH 1/3] update sections for adding sdk-dependent functionality such that they link out to relevant documentation --- .../automatic_instrumentation/single-step-apm/docker.md | 5 ++++- .../single-step-apm/kubernetes.md | 5 ++++- .../automatic_instrumentation/single-step-apm/linux.md | 5 ++++- .../automatic_instrumentation/single-step-apm/windows.md | 7 +++++-- 4 files changed, 17 insertions(+), 5 deletions(-) diff --git a/content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/docker.md b/content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/docker.md index 3d88e405aea..8540ec9fb31 100644 --- a/content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/docker.md +++ b/content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/docker.md @@ -61,7 +61,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. @@ -114,6 +114,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/ diff --git a/content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/kubernetes.md b/content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/kubernetes.md index ed80dbbfeff..e57f8c0ae33 100644 --- a/content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/kubernetes.md +++ b/content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/kubernetes.md @@ -128,7 +128,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: @@ -788,6 +788,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/ diff --git a/content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/linux.md b/content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/linux.md index c4a794c090f..8e1da843f04 100644 --- a/content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/linux.md +++ b/content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/linux.md @@ -86,7 +86,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: @@ -184,5 +184,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/ diff --git a/content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/windows.md b/content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/windows.md index 39249565f4d..f08011eb3e0 100644 --- a/content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/windows.md +++ b/content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/windows.md @@ -76,7 +76,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][5], [Application Security Monitoring][6], and [trace ingestion controls][7]. To enable products, [set environment variables][3] in your application configuration. @@ -99,4 +99,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 \ No newline at end of file +[4]: /tracing/trace_collection/automatic_instrumentation/single-step-apm/troubleshooting +[5]: /profiler/ +[6]: /security/application_security/ +[7]: /tracing/trace_pipeline/ingestion_controls/ \ No newline at end of file From 4a2d9b61efcb44763826828e380fe09e09cb6c7e Mon Sep 17 00:00:00 2001 From: Dominique Alessi Date: Fri, 5 Dec 2025 14:36:07 -0500 Subject: [PATCH 2/3] add note about EKS and ECS Fargate --- .../single-step-apm/compatibility.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/compatibility.md b/content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/compatibility.md index 561ded41a3d..7c7eafec97e 100644 --- a/content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/compatibility.md +++ b/content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/compatibility.md @@ -12,6 +12,8 @@ Single Step Instrumentation (SSI) has compatibility requirements that vary by op ## Compatibility by application environment +
ECS Fargate is not supported.
+ Select your environment to see compatibility requirements and limitations: {{< tabs >}} @@ -57,6 +59,8 @@ Select your environment to see compatibility requirements and limitations: {{% tab "Kubernetes" %}} +
EKS Fargate support is in Preview.
+ ### Compatibility - **Status**: GA From 841d847a32b2443adf4b75a2bce3e543d43bbbe6 Mon Sep 17 00:00:00 2001 From: Dominique Alessi Date: Fri, 5 Dec 2025 14:51:42 -0500 Subject: [PATCH 3/3] add note about startup times --- .../automatic_instrumentation/single-step-apm/docker.md | 2 ++ .../automatic_instrumentation/single-step-apm/kubernetes.md | 2 ++ .../automatic_instrumentation/single-step-apm/linux.md | 2 ++ .../automatic_instrumentation/single-step-apm/windows.md | 2 ++ 4 files changed, 8 insertions(+) diff --git a/content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/docker.md b/content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/docker.md index 8540ec9fb31..c900c2d7d16 100644 --- a/content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/docker.md +++ b/content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/docker.md @@ -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. +
SSI adds a small amount of startup time to instrumented applications. If this overhead is not acceptable for your use case, contact Datadog Support.
+ ## 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. diff --git a/content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/kubernetes.md b/content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/kubernetes.md index e57f8c0ae33..f233deafb29 100644 --- a/content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/kubernetes.md +++ b/content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/kubernetes.md @@ -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. +
SSI adds a small amount of startup time to instrumented applications. If this overhead is not acceptable for your use case, contact Datadog Support.
+ ## 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. diff --git a/content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/linux.md b/content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/linux.md index 8e1da843f04..98a598b80d9 100644 --- a/content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/linux.md +++ b/content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/linux.md @@ -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. +
SSI adds a small amount of startup time to instrumented applications. If this overhead is not acceptable for your use case, contact Datadog Support.
+ ## Set SDK tracer versions By default, Single Step Instrumentation installs the latest versions of Datadog APM SDKs. diff --git a/content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/windows.md b/content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/windows.md index f08011eb3e0..8fcc182195b 100644 --- a/content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/windows.md +++ b/content/en/tracing/trace_collection/automatic_instrumentation/single-step-apm/windows.md @@ -70,6 +70,8 @@ To instrument Java and .NET applications across your entire Windows host: {{% /tab %}} {{< /tabs >}} +
SSI adds a small amount of startup time to instrumented applications. If this overhead is not acceptable for your use case, contact Datadog Support.
+ ## 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].