Skip to content

docs(js): Use @sentry/bundler-plugins instead of individual packages - #19865

Merged
Lms24 merged 2 commits into
masterfrom
tim/serene-davinci-jfh1zs
Oct 28, 2026
Merged

Lms24 merged 2 commits into
masterfrom
tim/serene-davinci-jfh1zs

Conversation

@timfish

@timfish timfish commented Oct 8, 2026 •

Copy link
Copy Markdown
Collaborator

Replace @sentry/{vite,rollup,webpack,esbuild}-plugin with @sentry/bundler-plugins/<bundler>. Guides that install @sentry/node import the plugins from @sentry/node/<bundler>. The NestJS guide uses @sentry/nestjs/webpack and the AWS Lambda guide uses @sentry/aws-serverless/esbuild, so they need no new dependency.

Add a Bundler Plugin Options page, based on the option docs in the old plugin READMEs and updated for v11. Links to npm READMEs and the bundler plugins repo now go to this page or to the bundler guides. Pages for old versions are unchanged.

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+

@vercel

vercel Bot commented Oct 8, 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 Oct 27, 2026 4:40pm UTC
sentry-docs Ready Ready Preview Oct 27, 2026 4:40pm UTC

Request Review

@github-actions

This comment was marked as outdated.

…ckages

Replace @sentry/{vite,rollup,webpack,esbuild}-plugin with
@sentry/bundler-plugins/<bundler>. Guides that install @sentry/node
import the plugins from @sentry/node/<bundler>. The NestJS guide uses
@sentry/nestjs/webpack and the AWS Lambda guide uses
@sentry/aws-serverless/esbuild, so they need no new dependency.

Add a Bundler Plugin Options page, based on the option docs in the
old plugin READMEs. Links to npm READMEs and the bundler plugins repo
now go to this page or to the bundler guides. Pages for old versions
are unchanged.
@timfish
timfish marked this pull request as ready for review October 27, 2026 16:33
@codeowner-assignment
codeowner-assignment Bot requested review from a team October 27, 2026 16:33
@timfish
timfish requested a review from Lms24 October 27, 2026 16:33
@cursor

cursor Bot commented Oct 27, 2026 •

Copy link
Copy Markdown
Contributor

The change adds a bundler plugin options page and updates four bundler upload guides. The plan checks the new page, those four guides, and JavaScript 404s. An issue escalates when the new page stays unseen, the four guides drop, or internal 404s appear.

Monitoring in production

Services: sentry-docs.

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

Plan

What changed

JavaScript bundler upload guides now tell readers to install @sentry/bundler-plugins. Those guides import the plugin from @sentry/bundler-plugins/<bundler>. Node SDK guides import the plugin from the SDK package instead. A new Bundler Plugin Options page is reachable on each JavaScript platform. Related sourcemap, tree-shaking, and React component-name pages now link to that page. This change is live after sentry-docs deploys. develop-docs does not ship this change. The pull request only edits user docs content.

Risk

Broken PlatformLink targets send readers from the four guides to a 404 page. Broken PlatformSection markup can hide install steps on Node or browser guides. A failed static page build drops the new options page and the four guides.

Intended effect

The new options page starts to record page loads. Absent means the four guides still load and this path stays at zero.

Signal Baseline Window Rule Source
docs.page.load on path:*bundler-plugin-options* 0 loads 2026-10-26T16:34:00Z to 2026-10-27T16:34:00Z Rise above 0 after deploy Sentry sentry/docs, environment:production path:*bundler-plugin-options*

The four upload guides still load in the same windows. Use that as the population that can reach the new page. Do not treat a quiet new page as confirmed if those four guides also go dark.

Regression watch

This diff can break the four upload guides and any new internal link. Watch internal JavaScript 404s and the load share of the four guides.

Signal Baseline Window Rule Source
docs.page.not_found for requested_path:platforms/javascript and referer_type:internal 0 2026-10-25T16:34:00Z to 2026-10-27T16:34:00Z Hold at 0 Sentry sentry/docs, environment:production requested_path:platforms/javascript referer_type:internal
JavaScript 404 rate: docs.page.not_found / (docs.page.load on path:/platforms/javascript* plus those 404s) 0.60% (24 of 4025) in the later 24h. 0.70% (26 of 3720) in the earlier 24h. Band 0.60-0.70% 2026-10-25T16:34:00Z to 2026-10-27T16:34:00Z Hold in 0.60-0.70%. Escalate if the rate rises above the band Sentry sentry/docs, docs.page.not_found with requested_path:platforms/javascript and docs.page.load with path:/platforms/javascript*
Four-guide load share: docs.page.load on path:*sourcemaps/uploading/{vite,webpack,rollup,esbuild}* / JavaScript platform docs.page.load 1.87% (75 of 4001) in the later 24h. 2.03% (75 of 3694) in the earlier 24h. Band 1.87-2.03% 2026-10-25T16:34:00Z to 2026-10-27T16:34:00Z Hold near 1.87-2.03%. A drop to 0 is a regression. Small swings may be noise Sentry sentry/docs, environment:production path:*sourcemaps/uploading/vite* and the webpack, rollup, and esbuild matches
Node four-guide loads: docs.page.load on path:/platforms/javascript/guides/node/sourcemaps/uploading/{vite,webpack,rollup,esbuild}* 9 loads over 48h 2026-10-25T16:34:00Z to 2026-10-27T16:34:00Z Do not fall to 0 while the unguided four guides still load Sentry sentry/docs, environment:production path:/platforms/javascript/guides/node/sourcemaps/uploading/*

JavaScript platform docs.page.load was 4001 in 2026-10-26T16:34:00Z to 2026-10-27T16:34:00Z and 7695 over the 48h window. Direct JavaScript 404s were 23 in the later 24h and 47 over 48h. Those direct 404s may be bots. Use internal 404s as the link-break signal.

Not observable

docs.page.not_found keeps only two path segments. A 404 on the new options page mixes with other JavaScript 404s. Client errors on these pages are not sliced. A transaction:*platforms/javascript* error search returned no rows. Docs-wide production errors were 818 in 2026-10-26T16:34:00Z to 2026-10-27T16:34:00Z. Do not use that fleet count. docs.snippet_copy keeps only three path segments, so it cannot show the new package name. Pageload traces for these URL transactions returned 0. Sidebar clicks are soft navigations. The install text inside each PlatformSection is not in telemetry.

@Lms24 Lms24 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, looks good to me!

@Lms24
Lms24 merged commit be920e5 into master Oct 28, 2026
30 of 32 checks passed
@Lms24
Lms24 deleted the tim/serene-davinci-jfh1zs branch October 28, 2026 16:00

This branch was successfully deployed

2 active deployments
Preview – sentry-docs — 79d9185b Deployed Oct 27, 2026 by vercel[bot]
Preview – develop-docs — 79d9185b Deployed Oct 27, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Priority: Normal Docs review has no urgent deadline

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants