[sentry-junior]

DESCRIBE YOUR PR

The "Use Your Own OpenTelemetry Pipeline" page only showed an OpenTelemetry JS v2 setup. OpenTelemetry JS v3 replaces @opentelemetry/sdk-trace-base and @opentelemetry/sdk-trace-node with @opentelemetry/sdk-trace, drops NodeTracerProvider, and changes BatchSpanProcessor to take an options object, so the v2 snippet doesn't work after upgrading.

This adds a v3 tab (NodeSDK + @opentelemetry/sdk-trace) next to the existing v2 example and notes the Node.js 22.15+ requirement. The v3 setup mirrors the e2e app added in getsentry/sentry-javascript#25630.

IS YOUR CHANGE URGENT?

• Urgent deadline (GA date, etc.): YYYY-MM-DD
• Other deadline: YYYY-MM-DD
• No deadline: Not urgent, can wait up to 1 week+

PRE-MERGE CHECKLIST

• Checked Vercel preview for correctness, including links
• PR was reviewed and approved by any necessary SMEs (subject matter experts)
• PR was reviewed and approved by a member of the Sentry docs team

via Andrei Borza.

--

View Junior Session [Sentry]

[vercel]

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

2 Skipped Deployments

Project	Deployment	Actions	Updated
develop-docs	Ignored	Preview	Oct 21, 2026 4:37pm UTC
sentry-docs	Ignored	Preview	Oct 21, 2026 4:37pm UTC

[cursor]

The plan checks loads of the custom OpenTelemetry setup page, client errors on that path, and code-tab errors. An issue escalates when those errors appear or when loads on that path fall to zero.

Services: sentry-docs.

Mention @change-monitor in a comment to update the plan.

Plan

What changed

JavaScript server custom OpenTelemetry setup pages now show an OpenTelemetry JS v3 example tab beside the v2 tab. The v3 tab starts NodeSDK and imports BatchSpanProcessor from @opentelemetry/sdk-trace. The v2 snippet stays on a second tab. This change is live after sentry-docs deploys. The common page is limited to the server category. It is served on JavaScript server guide URLs such as /platforms/javascript/guides/node/opentelemetry/custom-setup/.

Risk

A broken tab group can crash the code-tab client on this page. Readers then lose both the new v3 snippet and the old v2 snippet. If the page fails to generate, those guide URLs return not found. Wrong tab content can send readers to an API that does not match their OpenTelemetry JS version.

Intended effect

This change is a documentation content edit. No metric records that the v3 tab is visible. The executor cannot set intended_effect to confirmed from telemetry. absent would mean the v3 tab is missing while the page still loads. Telemetry cannot show that case.

Regression watch

Client traces use a 30 percent sample rate. Error events are not sampled the same way. A 24 hour sampled count of 0 is a real drop. A miss of one or two sampled loads may be sample noise.

Signal	Baseline	Window	Source	Rule
Client error rate on custom-setup URLs	0 errors over 13 sampled pageload and navigation spans. Rate 0 percent.	2026-10-19T16:22:00Z to 2026-10-21T16:22:00Z	Sentry project docs. Errors: environment:production (http.url:*opentelemetry/custom-setup* OR transaction:*opentelemetry/custom-setup*). Spans: span.op:[pageload,navigation] url.full:*opentelemetry/custom-setup* environment:production.	Hold at 0 percent. Any error on this path is a regression.
Sampled pageload and navigation count on custom-setup URLs	Last 24h: 7 spans. Prior 24h: 6 spans. Band 6-7 spans per 24h.	Last: 2026-10-20T16:22:00Z to 2026-10-21T16:22:00Z. Prior: 2026-10-19T16:22:00Z to 2026-10-20T16:22:00Z	Sentry project docs. span.op:[pageload,navigation] url.full:*opentelemetry/custom-setup* environment:production with count()	Hold in the 6-7 band. A 24h count of 0 means the page may be missing.
Code-tab client errors	0 events. Query returned no results.	2026-10-19T16:22:00Z to 2026-10-21T16:22:00Z	Sentry project docs. environment:production CodeTabs with count()	Hold at 0. This page now feeds CodeTabs a new two-tab group.
p95 pageload and navigation duration on custom-setup URLs	Last 24h p95 1409 ms. 48h pooled p95 1683 ms. Band 1400-1700 ms.	Last 24h: 2026-10-20T16:22:00Z to 2026-10-21T16:22:00Z. 48h: 2026-10-19T16:22:00Z to 2026-10-21T16:22:00Z	Sentry project docs. Same span query with p95(span.duration)	Hold in the 1400-1700 ms band. Rise above the band may mean the heavier tabbed block slowed the page. Low sample count can move p95.

If the error rate rises, check client error titles for CodeTabs or a failed MDX render on these URLs.

Not observable

No signal shows which tab is selected or whether the v3 snippet text is present. No http.server spans matched this path, so server status codes on these URLs are not available. docs.snippet_copy stores only the first three path segments, so copy on this page cannot be isolated. A grouped URL query for these page loads returned no per-guide split.