[DOCS-14870] Add managed platforms and serverless OTLP ingest docs by brett0000FF · Pull Request #37395 · DataDog/documentation

brett0000FF · 2026-06-09T21:31:41Z

What does this PR do? What is the motivation?

Adds two new pages under Direct OTLP Ingest:

Managed Platforms: Dedicated OTLP endpoints for 25 third-party platforms. All signals.
Serverless Traces: Direct ingest from AWS, Azure, and GCP serverless environments. Traces-focused, but notes that logs (GA) and metrics (endpoint GA, serverless billing not yet live) also work via the general OTLP endpoints.

Also adds an environment-first routing table to the landing page and managed platform cross-references to the logs and metrics pages.

Proposed content decisions

Span mapping removed: Eng preference to keep undocumented while operation name v2 stabilizes. The previously documented header name was a typo that never worked.
Azure detector claims softened: Source doc said SDK detector does not support Container Apps; upstream Java contrib detector does. Changed to "varies by language SDK."

Open items: eng

Azure Functions cloud.resource_id: Should it identify the specific function or the function app?
GKE Autopilot detection: The GCP detector populates host.id for GKE. Does host.id trigger host-based identification instead of serverless? Can intake distinguish Autopilot from Standard GKE?
http/json support: Confirmed for managed platforms (Cloudflare uses it). Does serverless also support http/json?
Serverless endpoint URL format: Confirm the exact endpoint pattern for the serverless page.
RDP config snippets: Eng is working on Collector sidecar/RDP config examples. These vary by language and SDK. We need to determine placement (inline vs. link to Collector docs).

Open items: product

~~Sign-up form link for the Preview~~ → Using https://www.datadoghq.com/product-preview/otel-native-instrumentation/

Follow-ups: traces page header fix (including reconciling dd-otlp-source semantics between traces and serverless pages), Collector sidecar content, compatibility page updates.

Merge instructions

Merge readiness:

Ready for merge

Add two new pages under Direct OTLP Ingest: - Managed Platforms: dedicated OTLP endpoints for 27 platforms - Serverless: traces from AWS, Azure, and GCP environments Update the landing page with a routing table and add cross-reference notes to the logs and metrics pages.

github-actions · 2026-06-09T21:36:14Z

Preview links (active after the `build_preview` check completes)

New or renamed files

Modified Files

Mark open items inline: Preview framing, GCP endpoint ambiguity, Azure semconv verification, AWS attributes, span-mapping decision, GKE scope, and signal scope. Add GKE to routing table.

Lambda: cloud.provider + faas.id (ARN) required, cloud.platform conditional. ECS Fargate: aws.ecs.task.arn + aws.ecs.launchtype required, cloud.provider/cloud.platform optional.

…Traces Settled decisions from review: - Remove span mapping sections from both pages (eng prefers undocumented) - Remove GKE from serverless page (not serverless, not on Serverless product page) - Retitle serverless page to "Serverless Traces" (traces-only scope) - Add Preview callout to serverless page - Fix Azure resource detection claims (Collector vs SDK distinction) - Soften Container Apps detector claim (varies by language SDK) - Add resource attributes note (applies to all signals, not only traces) - Strengthen routing rule on landing and managed platforms pages - Add faas.id deprecation TODO for eng verification

- Restore "Adding a New Platform" CSM escape hatch (from managed platform draft) - Add sampling limitation note to Feature coverage - Add AWS log-correlation attributes to Lambda and Fargate tables - Merge duplicated "This page" sentences in Overview - Smooth Lambda faas.id required/conditional contradiction - Add compute_stats required-vs-optional TODO for eng - Remove names from TODO comments

- GKE → GKE Autopilot throughout (standard GKE is not serverless) - Add note that serverless workloads can also send logs and metrics via the general OTLP endpoints - Link standard GKE users to the general traces endpoint

- Fix _index.md link refs to use canonical paths - Tighten serverless overview (remove redundant clause, deduplicate resource attributes explanation) - Clarify managed platforms dd-otlp-source callout

- azure_app_service → azure.app_service, azure_functions → azure.functions (OTel semconv standard; backend accepts both per eng) - Remove inconsistency callout (all values are now dot-separated) - Move compute_stats=true to required headers (confirmed by outline) - Remove resolved TODOs for Azure values and compute_stats

- compute_stats: explain it's required for platform detection, not just an opt-in for trace metrics - Lambda: clarify manual attributes are for non-ADOT setups

- Managed Platforms → OTLP Intake for Managed Platforms - Serverless Traces → OTLP Intake for Serverless - Add description frontmatter to both pages - Update nav menu labels

…platforms

egracer

@zarirhamza re: the open task for RDP configuration, my understanding is that we probably can't put list every conceivable configuration setup (any one language could have many OTel SDKs, and we want to remain vendor agnostic). Do I have that right?

egracer · 2026-06-15T14:03:14Z

 <div class="alert alert-danger">Host metadata sent to this endpoint will not populate the <a href="/infrastructure/list/">Infrastructure Host List</a>.</div>

-You might prefer this option if you're looking for a straightforward setup and want to send telemetry directly to Datadog without using the Datadog Agent or OpenTelemetry Collector.
+<!-- TODO: Add Preview sign-up link once product provides it. -->


@asopkin Is someone else handling this or are you looking to me to set up a form for both serverless and managed platforms?

This should be a link to the OSS pipeline: https://www.datadoghq.com/product-preview/otel-native-instrumentation/

We can frame this as, if you want to send data from an OpenTelemetry Collector we recommend enrolling in our Preview to get the full Collector experience.

Cc @dd-mattdunnam

@egracer I don't think we should need new links for managed platform / serverless?

The heading alone scopes the section; users on Standard GKE don't need to be told they're not on Autopilot.

Position direct ingest landing page to lead with the Collector/Agent recommendation for production workloads, and frame direct endpoints as the path for environments where deploying those is not feasible. Remove OpenTelemetry Collector from the routing table row 3 to avoid contradicting the premise of the section.

Rewrite managed platforms limitations to focus on the actual gaps when using direct ingest: no metadata enrichment, limited normalization, and no Collector-level sampling. OTel SDK exporters handle buffering, batching, and retry on their own.

asopkin · 2026-06-16T18:36:44Z

+
+- `dd-api-key`: Your Datadog API key.
+- `dd-otlp-source`: Set to `serverless`.
+- `compute_stats`: Set to `true`. Required for [trace metrics][2] and serverless platform detection.


Do we need compute_stats for serverless platform detection? I don't think so, I think it's just for trace metrics

asopkin · 2026-06-16T18:37:05Z

+
+The following configuration applies to all platforms.
+
+**Protocol**: `http/protobuf` only. `grpc` and `http/json` are not supported.


@egracer I think we do support http/json because Cloudflare relies on it?

asopkin · 2026-06-16T18:38:04Z

+
+{{< callout header="false" btn_hidden="true">}}
+The serverless OTLP traces intake endpoint is in Preview.
+<!-- TODO: Insert Preview sign-up form URL from product -->


I think we want to specifically link to the endpoint itself. It should be something like

https://otlp/.{DD_SITE}/v1/traces

With dd-otlp-source as serverless for serverless

@asopkin - Thanks for all your feedback! Could you please clarify what you are looking for here? The endpoint renders in each code block, so I'm not quite sure where you'd like me to put this.

- Remove compute_stats from managed platforms (on by default) - Remove GCP and GAE rows from managed platforms table - Fix compute_stats description on serverless (trace metrics only) - Add OTel Preview sign-up link on landing page - Update trace metrics limitation to reflect default-on behavior

github-actions Bot added the Architecture Everything related to the Doc backend label Jun 9, 2026

brett0000FF added 5 commits June 9, 2026 15:52

Add TODO comments for open review questions

7da7037

Mark open items inline: Preview framing, GCP endpoint ambiguity, Azure semconv verification, AWS attributes, span-mapping decision, GKE scope, and signal scope. Add GKE to routing table.

Remove names from TODO comments

5036bb4

Update AWS resource attributes from eng draft

b4a7f5c

Lambda: cloud.provider + faas.id (ARN) required, cloud.platform conditional. ECS Fargate: aws.ecs.task.arn + aws.ecs.launchtype required, cloud.provider/cloud.platform optional.

Fix broken tables: move TODO comments outside markdown tables

6380bc5

This comment has been minimized.

Sign in to view

brett0000FF added 8 commits June 10, 2026 11:04

Restore GKE content to serverless page and routing table

46878b1

Scope GKE to Autopilot only, note logs/metrics signal support

fdc5b45

- GKE → GKE Autopilot throughout (standard GKE is not serverless) - Add note that serverless workloads can also send logs and metrics via the general OTLP endpoints - Link standard GKE users to the general traces endpoint

Final editorial polish before eng review

9b3493d

- Fix _index.md link refs to use canonical paths - Tighten serverless overview (remove redundant clause, deduplicate resource attributes explanation) - Clarify managed platforms dd-otlp-source callout

Clarify compute_stats requirement and Lambda ADOT boundary

af4b000

- compute_stats: explain it's required for platform detection, not just an opt-in for trace metrics - Lambda: clarify manual attributes are for non-ADOT setups

Improve page titles and add descriptions for discoverability

e71dd00

- Managed Platforms → OTLP Intake for Managed Platforms - Serverless Traces → OTLP Intake for Serverless - Add description frontmatter to both pages - Update nav menu labels

Update cross-references to match renamed serverless page

6c79378

brett0000FF requested review from asopkin, egracer and shanelhuang June 12, 2026 22:58

Merge branch 'master' into brett.blue/otlp-ingest-serverless-managed-…

8ea7a62

…platforms

egracer reviewed Jun 15, 2026

View reviewed changes

brett0000FF added 3 commits June 15, 2026 09:45

Remove GKE Autopilot explainer sentence and broken link

5e56d2d

The heading alone scopes the section; users on Standard GKE don't need to be told they're not on Autopilot.

Replace em dash with separate sentence in landing page overview

d1c3b4d

jade-guiton-dd reviewed Jun 16, 2026

View reviewed changes

Comment thread content/en/opentelemetry/setup/otlp_ingest/managed_platforms.md Outdated

asopkin reviewed Jun 16, 2026

View reviewed changes

Comment thread content/en/opentelemetry/setup/otlp_ingest/managed_platforms.md Outdated

asopkin reviewed Jun 16, 2026

View reviewed changes

brett0000FF changed the title ~~Add managed platforms and serverless OTLP ingest docs~~ [DOCS-14870] Add managed platforms and serverless OTLP ingest docs Jun 16, 2026

Add Preview sign-up URL to serverless callout banner

8e9db12

brett0000FF added the editorial review Waiting on a more in-depth review label Jun 16, 2026

brett0000FF marked this pull request as ready for review June 16, 2026 22:18

brett0000FF requested a review from a team as a code owner June 16, 2026 22:18

brett0000FF added 2 commits June 16, 2026 16:20

Surface endpoint URL and dd-otlp-source header in serverless overview

ef3e832

Revert endpoint URL from overview pending clarification

baca1fb

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[DOCS-14870] Add managed platforms and serverless OTLP ingest docs#37395

[DOCS-14870] Add managed platforms and serverless OTLP ingest docs#37395
brett0000FF wants to merge 23 commits into
masterfrom
brett.blue/otlp-ingest-serverless-managed-platforms

brett0000FF commented Jun 9, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Jun 9, 2026

Uh oh!

This comment has been minimized.

egracer left a comment

Uh oh!

Uh oh!

Uh oh!

egracer Jun 15, 2026

Uh oh!

asopkin Jun 16, 2026

Uh oh!

asopkin Jun 16, 2026

Uh oh!

Uh oh!

Uh oh!

asopkin Jun 16, 2026

Uh oh!

asopkin Jun 16, 2026

Uh oh!

asopkin Jun 16, 2026

Uh oh!

brett0000FF Jun 16, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants


		The following configuration applies to all platforms.

		Protocol: `http/protobuf` only. `grpc` and `http/json` are not supported.

Conversation

brett0000FF commented Jun 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What does this PR do? What is the motivation?

Proposed content decisions

Open items: eng

Open items: product

Merge instructions

Uh oh!

github-actions Bot commented Jun 9, 2026

Preview links (active after the build_preview check completes)

New or renamed files

Modified Files

Uh oh!

This comment has been minimized.

egracer left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

egracer Jun 15, 2026

Choose a reason for hiding this comment

Uh oh!

asopkin Jun 16, 2026

Choose a reason for hiding this comment

Uh oh!

asopkin Jun 16, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

asopkin Jun 16, 2026

Choose a reason for hiding this comment

Uh oh!

asopkin Jun 16, 2026

Choose a reason for hiding this comment

Uh oh!

asopkin Jun 16, 2026

Choose a reason for hiding this comment

Uh oh!

brett0000FF Jun 16, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

brett0000FF commented Jun 9, 2026 •

edited

Loading

Preview links (active after the `build_preview` check completes)