From 20b7afcb891ef9091b97a8bea7fe62cb769d6119 Mon Sep 17 00:00:00 2001 From: Brett Blue Date: Thu, 18 Sep 2025 12:01:41 -0600 Subject: [PATCH 1/5] Updates to align with wider product spec. --- content/en/opentelemetry/compatibility.md | 70 +++++++++-------------- 1 file changed, 28 insertions(+), 42 deletions(-) diff --git a/content/en/opentelemetry/compatibility.md b/content/en/opentelemetry/compatibility.md index ae84adc2f90e7..1d3cab9c0303e 100644 --- a/content/en/opentelemetry/compatibility.md +++ b/content/en/opentelemetry/compatibility.md @@ -13,52 +13,38 @@ Datadog offers multiple setup options to accommodate various use cases, from ful ## Setups -The following setups are supported: +Datadog supports several configurations for using OpenTelemetry. The primary difference between these setups is the choice of SDK (OpenTelemetry or Datadog) and the collector used to process and forward telemetry data. -| Setup Type | API | SDK | Collector/Agent | -|---------------------------------------------------------------|-------------|-------------------------|-----------------------------------------| -| **[Full OpenTelemetry][7]** | OTel API | OTel SDK | OTel Collector | -| **[OTel to Datadog Agent (OTLP)][6]** | OTel API | OTel SDK | Datadog Agent (OTLP Ingest) | -| **[OTel API with Datadog SDK and Agent][8]** | OTel API | Datadog SDK | Datadog Agent | -| **[Datadog Distribution of OTel Collector (DDOT)][9]** | OTel API | OTel SDK or Datadog SDK | Datadog Agent (with DDOT Collector) | -| **[Full Datadog][10]** | Datadog API | Datadog SDK | Datadog Agent | - -
The Datadog Distribution of OTel Collector supports two data flow options: -
  • OTel SDK → DDOT Collector, or
    • -
  • Datadog SDK → Datadog Agent
    • +| Setup Type | API | SDK | Collector/Agent | +|--------------------------------------|------------------------|-------------|----------------------------------| +| **Datadog SDK + DDOT (Recommended)** | Datadog API & OTel API | Datadog SDK | Datadog OTel Collector (DDOT) | +| **OTel SDK + DDOT** | OTel API | OTel SDK | Datadog OTel Collector (DDOT) | +| **OTel SDK + OSS Collector** | OTel API | OTel SDK | OTel Collector (OSS) | +| **Agentless OTLP** | OTel API | OTel SDK | N/A (Direct to Datadog endpoint) | ## Feature compatibility -### Supported Datadog features - -The following table shows Datadog feature compatibility across different setups: - -| Feature | Full OTel | OTel to Datadog Agent (OTLP) | OTel API with Datadog SDK and Agent | DDOT Collector | Full Datadog | -|-----------------------------------------------------|------------------------------------|------------------------------------|-------------------------------------|------------------------------------------------------|--------------| -| [Distributed Tracing][27] | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | -| [Trace Metrics][26] | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | -| [Correlated Traces, Metrics, Logs][19] | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | -| [Runtime Metrics][23] | {{< X >}}
    (Java, .NET, Go only) | {{< X >}}
    (Java, .NET, Go only) | {{< X >}} | {{< X >}}
    (Java, .NET, Go only) | {{< X >}} | -| [Source code integration][24] | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}}
    (Datadog SDK required) | {{< X >}} | -| [Real User Monitoring][22] (RUM) | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | -| [Cloud SIEM][18] | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | -| [Cloud Network Monitoring][21] (CNM) | | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | -| [Live Container Monitoring/Kubernetes Explorer][20] | | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | -| [Live Processes][16] | | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | -| [Universal Service Monitoring][17] (USM) | |{{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | -| [App and API Protection][11] (AAP) | | | {{< X >}} | {{< X >}}
    (Datadog SDK required) | {{< X >}} | -| [Continuous Profiler][12] | | | {{< X >}} | {{< X >}}
    (Datadog SDK required) | {{< X >}} | -| [Data Jobs Monitoring][13] (DJM) | | | {{< X >}}
    (Datadog SDK required) | {{< X >}}
    (Datadog SDK required) | {{< X >}} | -| [Data Streams Monitoring][15] (DSM) | {{< tooltip text="N/A" tooltip="OTel does not offer DSM functionality" >}}| | {{< X >}} | {{< X >}} | {{< X >}} | -| [Database Monitoring][14] (DBM) | {{< tooltip text="N/A" tooltip="OTel does not offer DBM functionality" >}}| | {{< X >}}
    (Datadog SDK required) | {{< X >}}
    (Datadog SDK required) | {{< X >}} | - -### Supported OpenTelemetry features - -The following table shows OpenTelemetry feature compatibility across different setups: - -| Feature | Full OTel | OTel to Datadog Agent (OTLP) | OTel API with Datadog SDK and Agent | DDOT Collector | Full Datadog | -|-----------------------------------------------------|------------------------------------|------------------------------------|-------------------------------------|------------------------------------------------------|--------------| -| [Span Links][25] | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | | +The following table shows feature compatibility across different setups: + +| Feature | Datadog SDK + DDOT (Recommended) | OTel SDK + DDOT | OTel SDK + OSS Collector | Agentless OTLP | +|---|---|---|---|---| +| [Cloud SIEM][18] | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | +| [Correlated Traces, Metrics, Logs][19] | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | +| [Distributed Tracing][27] | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | +| [Real User Monitoring][22] (RUM) | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | +| [Runtime Metrics][23] | {{< X >}} | {{< X >}}
    (Java, .NET, Go only) | {{< X >}}
    (Java, .NET, Go only) | {{< X >}}
    (Java, .NET, Go only) | +| [Span Links][25] | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | +| [Trace Metrics][26] | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}}
    (From sampled spans) | +| [Cloud Network Monitoring][21] (CNM) | {{< X >}} | {{< X >}} | | | +| [Live Container Monitoring/Kubernetes Explorer][20] | {{< X >}} | {{< X >}} | | | +| [Live Processes][16] | {{< X >}} | {{< X >}} | | | +| [Universal Service Monitoring][17] (USM) | {{< X >}} | {{< X >}} | | | +| [App and API Protection][11] (AAP) | {{< X >}} | | | | +| [Continuous Profiler][12] | {{< X >}} | | | | +| [Data Jobs Monitoring][13] (DJM) | {{< X >}} | | | | +| [Data Streams Monitoring][15] (DSM) | {{< X >}} | | {{< tooltip text="N/A" tooltip="OTel does not offer DSM functionality" >}} | {{< tooltip text="N/A" tooltip="OTel does not offer DSM functionality" >}} | +| [Database Monitoring][14] (DBM) | {{< X >}} | | {{< tooltip text="N/A" tooltip="OTel does not offer DBM functionality" >}} | {{< tooltip text="N/A" tooltip="OTel does not offer DBM functionality" >}} | +| [Source code integration][24] | {{< X >}} | | | | ## More details From 83a69a50b23855b39759e3b30bc244549d749d2f Mon Sep 17 00:00:00 2001 From: Brett Blue Date: Thu, 18 Sep 2025 16:11:33 -0600 Subject: [PATCH 2/5] Add links. --- content/en/opentelemetry/compatibility.md | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/content/en/opentelemetry/compatibility.md b/content/en/opentelemetry/compatibility.md index 1d3cab9c0303e..267a9b4fe6502 100644 --- a/content/en/opentelemetry/compatibility.md +++ b/content/en/opentelemetry/compatibility.md @@ -15,12 +15,12 @@ Datadog offers multiple setup options to accommodate various use cases, from ful Datadog supports several configurations for using OpenTelemetry. The primary difference between these setups is the choice of SDK (OpenTelemetry or Datadog) and the collector used to process and forward telemetry data. -| Setup Type | API | SDK | Collector/Agent | -|--------------------------------------|------------------------|-------------|----------------------------------| -| **Datadog SDK + DDOT (Recommended)** | Datadog API & OTel API | Datadog SDK | Datadog OTel Collector (DDOT) | -| **OTel SDK + DDOT** | OTel API | OTel SDK | Datadog OTel Collector (DDOT) | -| **OTel SDK + OSS Collector** | OTel API | OTel SDK | OTel Collector (OSS) | -| **Agentless OTLP** | OTel API | OTel SDK | N/A (Direct to Datadog endpoint) | +| Setup Type | API | SDK | Collector/Agent | +|--------------------------------------------|------------------------|-------------|-----------------------------------------------| +| [**Datadog SDK + DDOT (Recommended)**][29] | Datadog API or OTel API | Datadog SDK | Datadog Distribution of OTel Collector (DDOT) | +| [**OTel SDK + DDOT**][29] | OTel API | OTel SDK | Datadog Distribution of OTel Collector (DDOT) | +| [**OTel SDK + OSS Collector**][7] | OTel API | OTel SDK | OTel Collector (OSS) | +| [**Agentless OTLP**][28] | OTel API | OTel SDK | N/A (Direct to Datadog endpoint) | ## Feature compatibility @@ -108,3 +108,5 @@ When using Datadog and OpenTelemetry together, Datadog recommends the following [25]: /tracing/trace_collection/span_links/ [26]: /tracing/metrics/metrics_namespace/ [27]: /tracing/trace_collection/ +[28]: /opentelmetry/agentless +[29]: /opentelemetry/setup/ddot_collector \ No newline at end of file From 0c448e29fb0624760ce6bb0ceb194a99573be38b Mon Sep 17 00:00:00 2001 From: Brett Blue Date: Fri, 19 Sep 2025 11:59:51 -0600 Subject: [PATCH 3/5] Remove OTLP in Agent reference for live processes. --- content/en/opentelemetry/compatibility.md | 14 +++++--------- 1 file changed, 5 insertions(+), 9 deletions(-) diff --git a/content/en/opentelemetry/compatibility.md b/content/en/opentelemetry/compatibility.md index 267a9b4fe6502..0fa364961cd37 100644 --- a/content/en/opentelemetry/compatibility.md +++ b/content/en/opentelemetry/compatibility.md @@ -15,12 +15,12 @@ Datadog offers multiple setup options to accommodate various use cases, from ful Datadog supports several configurations for using OpenTelemetry. The primary difference between these setups is the choice of SDK (OpenTelemetry or Datadog) and the collector used to process and forward telemetry data. -| Setup Type | API | SDK | Collector/Agent | -|--------------------------------------------|------------------------|-------------|-----------------------------------------------| +| Setup Type | API | SDK | Collector/Agent | +|--------------------------------------------|-------------------------|-------------|-----------------------------------------------| | [**Datadog SDK + DDOT (Recommended)**][29] | Datadog API or OTel API | Datadog SDK | Datadog Distribution of OTel Collector (DDOT) | -| [**OTel SDK + DDOT**][29] | OTel API | OTel SDK | Datadog Distribution of OTel Collector (DDOT) | -| [**OTel SDK + OSS Collector**][7] | OTel API | OTel SDK | OTel Collector (OSS) | -| [**Agentless OTLP**][28] | OTel API | OTel SDK | N/A (Direct to Datadog endpoint) | +| [**OTel SDK + DDOT**][29] | OTel API | OTel SDK | Datadog Distribution of OTel Collector (DDOT) | +| [**OTel SDK + OSS Collector**][7] | OTel API | OTel SDK | OTel Collector (OSS) | +| [**Agentless OTLP**][28] | OTel API | OTel SDK | N/A (Direct to Datadog endpoint) | ## Feature compatibility @@ -62,10 +62,6 @@ Span-level or endpoint-level monitoring is **not** supported. For more information, see [Cloud Network Monitoring Setup][3]. -### Live Processes - -For **OTel to Datadog Agent (OTLP)**, you must enable the [Process Agent][4]. - ### Source Code Integration For unsupported languages in OpenTelemetry setups, [configure telemetry tagging][5] to link data to a specific commit. From ecd79a2ea7d438da486c6c7a22035b00ecc8d516 Mon Sep 17 00:00:00 2001 From: Brett Blue Date: Fri, 19 Sep 2025 12:09:26 -0600 Subject: [PATCH 4/5] Add tooltip to clarify Agentless sampled metrics. --- content/en/opentelemetry/compatibility.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/opentelemetry/compatibility.md b/content/en/opentelemetry/compatibility.md index 0fa364961cd37..112b298ef83cf 100644 --- a/content/en/opentelemetry/compatibility.md +++ b/content/en/opentelemetry/compatibility.md @@ -34,7 +34,7 @@ The following table shows feature compatibility across different setups: | [Real User Monitoring][22] (RUM) | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | | [Runtime Metrics][23] | {{< X >}} | {{< X >}}
    (Java, .NET, Go only) | {{< X >}}
    (Java, .NET, Go only) | {{< X >}}
    (Java, .NET, Go only) | | [Span Links][25] | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | -| [Trace Metrics][26] | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}}
    (From sampled spans) | +| [Trace Metrics][26] | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}}
    ({{< tooltip text="Sampled" tooltip="Trace metrics are calculated on the backend based on ingested spans that have passed through sampling, not on 100% of local traces before sampling." >}}) | | [Cloud Network Monitoring][21] (CNM) | {{< X >}} | {{< X >}} | | | | [Live Container Monitoring/Kubernetes Explorer][20] | {{< X >}} | {{< X >}} | | | | [Live Processes][16] | {{< X >}} | {{< X >}} | | | From 9a97725192e85abd613ac410c7a0a4dce0969067 Mon Sep 17 00:00:00 2001 From: Brett Blue Date: Mon, 22 Sep 2025 09:47:48 -0600 Subject: [PATCH 5/5] Replace Agentless with OTLP ingest. --- config/_default/menus/main.en.yaml | 2 +- content/en/opentelemetry/_index.md | 2 +- content/en/opentelemetry/compatibility.md | 6 +++--- content/en/opentelemetry/reference/otel_metrics.md | 2 +- content/en/opentelemetry/setup/_index.md | 2 +- 5 files changed, 7 insertions(+), 7 deletions(-) diff --git a/config/_default/menus/main.en.yaml b/config/_default/menus/main.en.yaml index e88e731ee6777..626a920d30feb 100644 --- a/config/_default/menus/main.en.yaml +++ b/config/_default/menus/main.en.yaml @@ -711,7 +711,7 @@ menu: identifier: otel-setup-otlp-ingest parent: otel-setup-other weight: 4022 - - name: Agentless Deployment + - name: Direct OTLP Ingest url: /opentelemetry/setup/agentless identifier: otel-setup-intake-endpoint parent: otel-setup-other diff --git a/content/en/opentelemetry/_index.md b/content/en/opentelemetry/_index.md index 81491afb294da..e015dee543e01 100644 --- a/content/en/opentelemetry/_index.md +++ b/content/en/opentelemetry/_index.md @@ -132,7 +132,7 @@ If your applications and services are instrumented with OpenTelemetry libraries, ### Additional setup options -For other setup options, including Agentless deployment, see [Send Data to Datadog][7]. +For other setup options, including direct OTLP ingestion, see [Send Data to Datadog][7]. ## Further reading diff --git a/content/en/opentelemetry/compatibility.md b/content/en/opentelemetry/compatibility.md index 112b298ef83cf..cbc8779103d09 100644 --- a/content/en/opentelemetry/compatibility.md +++ b/content/en/opentelemetry/compatibility.md @@ -20,13 +20,13 @@ Datadog supports several configurations for using OpenTelemetry. The primary dif | [**Datadog SDK + DDOT (Recommended)**][29] | Datadog API or OTel API | Datadog SDK | Datadog Distribution of OTel Collector (DDOT) | | [**OTel SDK + DDOT**][29] | OTel API | OTel SDK | Datadog Distribution of OTel Collector (DDOT) | | [**OTel SDK + OSS Collector**][7] | OTel API | OTel SDK | OTel Collector (OSS) | -| [**Agentless OTLP**][28] | OTel API | OTel SDK | N/A (Direct to Datadog endpoint) | +| [**Direct OTLP Ingest**][28] | OTel API | OTel SDK | N/A (Direct to Datadog endpoint) | ## Feature compatibility The following table shows feature compatibility across different setups: -| Feature | Datadog SDK + DDOT (Recommended) | OTel SDK + DDOT | OTel SDK + OSS Collector | Agentless OTLP | +| Feature | Datadog SDK + DDOT (Recommended) | OTel SDK + DDOT | OTel SDK + OSS Collector | Direct OTLP Ingest | |---|---|---|---|---| | [Cloud SIEM][18] | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | | [Correlated Traces, Metrics, Logs][19] | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | @@ -104,5 +104,5 @@ When using Datadog and OpenTelemetry together, Datadog recommends the following [25]: /tracing/trace_collection/span_links/ [26]: /tracing/metrics/metrics_namespace/ [27]: /tracing/trace_collection/ -[28]: /opentelmetry/agentless +[28]: /opentelemetry/setup/agentless [29]: /opentelemetry/setup/ddot_collector \ No newline at end of file diff --git a/content/en/opentelemetry/reference/otel_metrics.md b/content/en/opentelemetry/reference/otel_metrics.md index a1900c7ba3516..d2537d89562bd 100644 --- a/content/en/opentelemetry/reference/otel_metrics.md +++ b/content/en/opentelemetry/reference/otel_metrics.md @@ -21,7 +21,7 @@ To send OpenTelemetry metrics to Datadog, you have three main options: - [OpenTelemetry Collector][11] - [Datadog Agent][12] -- [Agentless Deployment][13] +- [Direct OTLP Ingest][13] For more information about which setup is right for you, see [Send OpenTelemetry Data to Datadog][10]. diff --git a/content/en/opentelemetry/setup/_index.md b/content/en/opentelemetry/setup/_index.md index 2ac2b85334439..f13033f8ad4cd 100644 --- a/content/en/opentelemetry/setup/_index.md +++ b/content/en/opentelemetry/setup/_index.md @@ -46,7 +46,7 @@ Alternative methods are available for specific use cases, such as maintaining a Best for: Users on platforms other than Kubernetes Linux, or those who prefer a minimal configuration without managing Collector pipelines. {{< /nextlink >}} {{< nextlink href="/opentelemetry/setup/agentless" >}} -

    Agentless Deployment (Preview)

    +

    Direct OTLP Ingest (Preview)

    Best for: Situations requiring direct data transmission to Datadog's intake endpoint without any intermediary components. {{< /nextlink >}} {{< /whatsnext >}}