Skip to content

Commit fb4ffc0

Browse files
brett0000FFbrett0000FF
authored
OpenTelemetry Compatibility Matrix Update (#31743)
* Updates to align with wider product spec. * Add links. * Remove OTLP in Agent reference for live processes. * Add tooltip to clarify Agentless sampled metrics. * Replace Agentless with OTLP ingest. * Remove RUM support for OTel SDKs; remove Agentless from URL paths. * Adding missing alias. * Fix menu file.
1 parent dcfe679 commit fb4ffc0

File tree

9 files changed

+607
-53
lines changed

9 files changed

+607
-53
lines changed

‎config/_default/menus/main.en.yaml‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -711,18 +711,18 @@ menu:
711711
identifier: otel-setup-otlp-ingest
712712
parent: otel-setup-other
713713
weight: 4022
714-
- name: Agentless Deployment
715-
url: /opentelemetry/setup/agentless
714+
- name: Direct OTLP Ingest
715+
url: /opentelemetry/setup/otlp_ingest
716716
identifier: otel-setup-intake-endpoint
717717
parent: otel-setup-other
718718
weight: 4023
719719
- name: Logs Endpoint
720-
url: /opentelemetry/setup/agentless/logs
720+
url: /opentelemetry/setup/otlp_ingest/logs
721721
parent: otel-setup-intake-endpoint
722722
weight: 40231
723723
identifier: otel_setup_agentless_logs
724724
- name: Metrics Endpoint
725-
url: /opentelemetry/setup/agentless/metrics
725+
url: /opentelemetry/setup/otlp_ingest/metrics
726726
parent: otel-setup-intake-endpoint
727727
weight: 40232
728728
identifier: otel_setup_agentless_metrics

‎content/en/opentelemetry/_index.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -132,7 +132,7 @@ If your applications and services are instrumented with OpenTelemetry libraries,
132132

133133
### Additional setup options
134134

135-
For other setup options, including Agentless deployment, see [Send Data to Datadog][7].
135+
For other setup options, including direct OTLP ingestion, see [Send Data to Datadog][7].
136136

137137
## Further reading
138138

‎content/en/opentelemetry/compatibility.md‎

Lines changed: 30 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -13,52 +13,38 @@ Datadog offers multiple setup options to accommodate various use cases, from ful
1313

1414
## Setups
1515

16-
The following setups are supported:
16+
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.
1717

18-
| Setup Type | API | SDK | Collector/Agent |
19-
|---------------------------------------------------------------|-------------|-------------------------|-----------------------------------------|
20-
| **[Full OpenTelemetry][7]** | OTel API | OTel SDK | OTel Collector |
21-
| **[OTel to Datadog Agent (OTLP)][6]** | OTel API | OTel SDK | Datadog Agent (OTLP Ingest) |
22-
| **[OTel API with Datadog SDK and Agent][8]** | OTel API | Datadog SDK | Datadog Agent |
23-
| **[Datadog Distribution of OTel Collector (DDOT)][9]** | OTel API | OTel SDK or Datadog SDK | Datadog Agent (with DDOT Collector) |
24-
| **[Full Datadog][10]** | Datadog API | Datadog SDK | Datadog Agent |
25-
26-
<div class="alert alert-info">The <strong>Datadog Distribution of OTel Collector</strong> supports two data flow options:
27-
<li>OTel SDK &#8594; DDOT Collector, or</li>
28-
<li>Datadog SDK &#8594; Datadog Agent</li></div>
18+
| Setup Type | API | SDK | Collector/Agent |
19+
|--------------------------------------------|-------------------------|-------------|-----------------------------------------------|
20+
| [**Datadog SDK + DDOT (Recommended)**][29] | Datadog API or OTel API | Datadog SDK | Datadog Distribution of OTel Collector (DDOT) |
21+
| [**OTel SDK + DDOT**][29] | OTel API | OTel SDK | Datadog Distribution of OTel Collector (DDOT) |
22+
| [**OTel SDK + OSS Collector**][7] | OTel API | OTel SDK | OTel Collector (OSS) |
23+
| [**Direct OTLP Ingest**][28] | OTel API | OTel SDK | N/A (Direct to Datadog endpoint) |
2924

3025
## Feature compatibility
3126

32-
### Supported Datadog features
33-
34-
The following table shows Datadog feature compatibility across different setups:
35-
36-
| Feature | Full OTel | OTel to Datadog Agent (OTLP) | OTel API with Datadog SDK and Agent | DDOT Collector | Full Datadog |
37-
|-----------------------------------------------------|------------------------------------|------------------------------------|-------------------------------------|------------------------------------------------------|--------------|
38-
| [Distributed Tracing][27] | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} |
39-
| [Trace Metrics][26] | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} |
40-
| [Correlated Traces, Metrics, Logs][19] | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} |
41-
| [Runtime Metrics][23] | {{< X >}}<br>(Java, .NET, Go only) | {{< X >}}<br>(Java, .NET, Go only) | {{< X >}} | {{< X >}}<br>(Java, .NET, Go only) | {{< X >}} |
42-
| [Source code integration][24] | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}}<br>(Datadog SDK required) | {{< X >}} |
43-
| [Real User Monitoring][22] (RUM) | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} |
44-
| [Cloud SIEM][18] | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} |
45-
| [Cloud Network Monitoring][21] (CNM) | | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} |
46-
| [Live Container Monitoring/Kubernetes Explorer][20] | | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} |
47-
| [Live Processes][16] | | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} |
48-
| [Universal Service Monitoring][17] (USM) | |{{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} |
49-
| [App and API Protection][11] (AAP) | | | {{< X >}} | {{< X >}}<br>(Datadog SDK required) | {{< X >}} |
50-
| [Continuous Profiler][12] | | | {{< X >}} | {{< X >}}<br>(Datadog SDK required) | {{< X >}} |
51-
| [Data Jobs Monitoring][13] (DJM) | | | {{< X >}}<br>(Datadog SDK required) | {{< X >}}<br>(Datadog SDK required) | {{< X >}} |
52-
| [Data Streams Monitoring][15] (DSM) | {{< tooltip text="N/A" tooltip="OTel does not offer DSM functionality" >}}| | {{< X >}} | {{< X >}} | {{< X >}} |
53-
| [Database Monitoring][14] (DBM) | {{< tooltip text="N/A" tooltip="OTel does not offer DBM functionality" >}}| | {{< X >}}<br>(Datadog SDK required) | {{< X >}}<br>(Datadog SDK required) | {{< X >}} |
54-
55-
### Supported OpenTelemetry features
56-
57-
The following table shows OpenTelemetry feature compatibility across different setups:
58-
59-
| Feature | Full OTel | OTel to Datadog Agent (OTLP) | OTel API with Datadog SDK and Agent | DDOT Collector | Full Datadog |
60-
|-----------------------------------------------------|------------------------------------|------------------------------------|-------------------------------------|------------------------------------------------------|--------------|
61-
| [Span Links][25] | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} | |
27+
The following table shows feature compatibility across different setups:
28+
29+
| Feature | Datadog SDK + DDOT (Recommended) | OTel SDK + DDOT | OTel SDK + OSS Collector | Direct OTLP Ingest |
30+
|---|---|---|---|---|
31+
| [Cloud SIEM][18] | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} |
32+
| [Correlated Traces, Metrics, Logs][19] | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} |
33+
| [Distributed Tracing][27] | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} |
34+
| [Runtime Metrics][23] | {{< X >}} | {{< X >}}<br>(Java, .NET, Go only) | {{< X >}}<br>(Java, .NET, Go only) | {{< X >}}<br>(Java, .NET, Go only) |
35+
| [Span Links][25] | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}} |
36+
| [Trace Metrics][26] | {{< X >}} | {{< X >}} | {{< X >}} | {{< X >}}<br>({{< 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." >}}) |
37+
| [Cloud Network Monitoring][21] (CNM) | {{< X >}} | {{< X >}} | | |
38+
| [Live Container Monitoring/Kubernetes Explorer][20] | {{< X >}} | {{< X >}} | | |
39+
| [Live Processes][16] | {{< X >}} | {{< X >}} | | |
40+
| [Universal Service Monitoring][17] (USM) | {{< X >}} | {{< X >}} | | |
41+
| [App and API Protection][11] (AAP) | {{< X >}} | | | |
42+
| [Continuous Profiler][12] | {{< X >}} | | | |
43+
| [Data Jobs Monitoring][13] (DJM) | {{< X >}} | | | |
44+
| [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" >}} |
45+
| [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" >}} |
46+
| [Real User Monitoring][22] (RUM) | {{< X >}} | | | |
47+
| [Source code integration][24] | {{< X >}} | | | |
6248

6349
## More details
6450

@@ -76,10 +62,6 @@ Span-level or endpoint-level monitoring is **not** supported.
7662

7763
For more information, see [Cloud Network Monitoring Setup][3].
7864

79-
### Live Processes
80-
81-
For **OTel to Datadog Agent (OTLP)**, you must enable the [Process Agent][4].
82-
8365
### Source Code Integration
8466

8567
For unsupported languages in OpenTelemetry setups, [configure telemetry tagging][5] to link data to a specific commit.
@@ -122,3 +104,5 @@ When using Datadog and OpenTelemetry together, Datadog recommends the following
122104
[25]: /tracing/trace_collection/span_links/
123105
[26]: /tracing/metrics/metrics_namespace/
124106
[27]: /tracing/trace_collection/
107+
[28]: /opentelemetry/setup/agentless
108+
[29]: /opentelemetry/setup/ddot_collector

‎content/en/opentelemetry/reference/otel_metrics.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ To send OpenTelemetry metrics to Datadog, you have three main options:
2121

2222
- [OpenTelemetry Collector][11]
2323
- [Datadog Agent][12]
24-
- [Agentless Deployment][13]
24+
- [Direct OTLP Ingest][13]
2525

2626
For more information about which setup is right for you, see [Send OpenTelemetry Data to Datadog][10].
2727

‎content/en/opentelemetry/setup/_index.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,7 @@ Alternative methods are available for specific use cases, such as maintaining a
4646
Best for: Users on platforms other than Kubernetes Linux, or those who prefer a minimal configuration without managing Collector pipelines.
4747
{{< /nextlink >}}
4848
{{< nextlink href="/opentelemetry/setup/agentless" >}}
49-
<h3>Agentless Deployment (Preview)</h3>
49+
<h3>Direct OTLP Ingest (Preview)</h3>
5050
Best for: Situations requiring direct data transmission to Datadog's intake endpoint without any intermediary components.
5151
{{< /nextlink >}}
5252
{{< /whatsnext >}}

‎content/en/opentelemetry/setup/agentless/_index.md‎ renamed to ‎content/en/opentelemetry/setup/otlp_ingest/_index.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,7 @@
22
title: Datadog OTLP Intake Endpoint
33
aliases:
44
- /opentelemetry/setup/intake_endpoint/
5+
- /opentelemetry/setup/agentless/
56
further_reading:
67
- link: "/opentelemetry/setup"
78
tag: "Documentation"

‎content/en/opentelemetry/setup/agentless/logs.md‎ renamed to ‎content/en/opentelemetry/setup/otlp_ingest/logs.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@ title: Datadog OTLP Logs Intake Endpoint
33
aliases:
44
- /opentelemetry/otlp_logs
55
- /opentelemetry/setup/intake_endpoint/otlp_logs
6+
- /opentelemetry/setup/agentless/logs
67
further_reading:
78
- link: "https://opentelemetry.io/docs/concepts/sdk-configuration/general-sdk-configuration/"
89
tag: "External Site"

0 commit comments

Comments
 (0)