Skip to content

docs(javascript): Document OpenTelemetry interoperability in v11 - #19458

Draft
msonnb wants to merge 5 commits into
masterfrom
ms/document-opentelemetry-integration
Draft

msonnb wants to merge 5 commits into
masterfrom
ms/document-opentelemetry-integration

Conversation

@msonnb

@msonnb msonnb commented Sep 17, 2026

Copy link
Copy Markdown
Member

Document the three v11 OpenTelemetry setups in one guide: Sentry tracing, capturing spans from OpenTelemetry APIs, and running your own OpenTelemetry pipeline. Add a separate integration reference for openTelemetryIntegration() and getOtlpTracesEndpoint(), and make the comparison table wrap so all three columns fit.

Preserve the original v10 overview, two subpages, and setup examples as versioned docs. Their content stays the same, with links and snippet references adjusted to keep readers on v10. Existing unversioned subpage URLs and Markdown exports redirect to the corresponding v11 content.

The v11 guidance follows the SDK implementation and migration guide, including leaving Sentry tracing off when OpenTelemetry owns spans and letting the OpenTelemetry propagator handle outgoing headers. Remove obsolete ESM loader troubleshooting from the installation guides.

Fixes https://linear.app/getsentry/issue/SDK-1470
Fixes https://linear.app/getsentry/issue/SDK-1471
Fixes https://linear.app/getsentry/issue/SDK-1490

IS YOUR CHANGE URGENT?

  • No deadline: Not urgent, can wait up to 1 week+

Replace the legacy custom OpenTelemetry setup with OTLP export examples.
Document openTelemetryIntegration and getOtlpTracesEndpoint.

Fixes SDK-1490
@vercel

vercel Bot commented Sep 17, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
develop-docs Ready Ready Preview Sep 17, 2026 2:09pm UTC
sentry-docs Ready Ready Preview Sep 17, 2026 2:09pm UTC

Request Review

@linear-code

linear-code Bot commented Sep 17, 2026

Copy link
Copy Markdown

SDK-1490

SDK-1471

SDK-1470

@github-actions github-actions Bot added the Priority: Normal Docs review has no urgent deadline label Sep 17, 2026
Fold setup and API reference content into the OpenTelemetry landing page.
Redirect old subpages and Markdown exports to the consolidated guide.

Fixes SDK-1470
@msonnb msonnb changed the title docs(javascript): Migrate OpenTelemetry setup docs to v11 docs(javascript): Consolidate OpenTelemetry docs for v11 Sep 17, 2026
Add the integration reference and wrap the setup comparison table. Align propagation guidance with the v11 SDK.

Refs SDK-1470, SDK-1471, SDK-1490
@msonnb msonnb changed the title docs(javascript): Consolidate OpenTelemetry docs for v11 docs(javascript): Document OpenTelemetry interoperability in v11 Sep 17, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

js-v11-docs Priority: Normal Docs review has no urgent deadline

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant