[sentry-junior]

DESCRIBE YOUR PR

The Data Storage Location page tells SaaS customers that the only way to switch between US and EU is to create a new organization, but it doesn't explain what that involves. Customers who switched regions told us they had to work it out on their own.

This adds a short, user-led checklist under Switching Data Storage Locations for Existing Organizations > SaaS. It covers what stays behind, recreating the setup in the new org, updating DSNs, tokens, and API domains, checking the new org, and retiring the old one. It doesn't suggest that Sentry moves data between SaaS orgs.

Before merging, an SME should confirm the integration and SSO guidance, especially whether any integrations need to be uninstalled from the old org first. Prettier also normalized whitespace in the existing storage location table.

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 paul.jaffre.

--

View Junior Session [Sentry]

[vercel]

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

Project	Deployment	Actions	Updated
sentry-docs	Ready	Preview	Oct 21, 2026 9:29pm UTC

1 Skipped Deployment

Project	Deployment	Actions	Updated
develop-docs	Ignored	Preview	Oct 21, 2026 9:29pm UTC

[sfanahata]

🤘

[cursor]

The plan checks pageload volume on the storage-location guide, pageload duration, and client errors on that URL. An issue escalates when pageload volume falls or those errors rise.

Monitoring in production

Services: sentry-docs.

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

Plan

What changed

Readers of the Data Storage Location page now see a Planning a switch expandable. The expandable lists SaaS steps to create a new organization and update DSNs. sentry-docs must deploy before this copy is live. The deploy workflow maps Vercel Production sentry-docs to this service.

Risk

A broken MDX render or Expandable hydrate can blank that page for readers. New links can send readers to missing organization, integration, or pricing pages. Wrong SSO or integration steps can make customers remove working tools too soon. That guidance error has no runtime signal.

Intended effect

This change is new documentation. Sentry does not record that the checklist appeared. Absent looks the same as confirmed in Sentry. Both show only that the page still loads. Do not treat pageload volume as proof the new copy shipped.

Regression watch

Filter production with url.full:*docs.sentry.io/organization/data-storage-location*. The route transaction is /:path*?. Traces use tracesSampleRate 0.3. Error events are not sampled that way. Compare error counts to the sampled span counts in the same row. Do not treat that ratio as a true user error rate.

Signal	Baseline	Rule	Source
Sampled pageload plus navigation span count	76 spans in 2026-10-21T16:02:11Z to 2026-10-22T16:02:11Z. Complete UTC days 2026-10-16 to 2026-10-21 were 50-123 spans per day.	Hold in 50-123 sampled spans per complete UTC day. Escalate if a complete day falls below 50.	Sentry org sentry project docs. Query span.op:[pageload,navigation] url.full:*docs.sentry.io/organization/data-storage-location*
Pageload p95 span.duration	14700ms in 2026-10-21T16:02:11Z to 2026-10-22T16:02:11Z. 6844ms in 2026-10-15T16:02:11Z to 2026-10-22T16:02:11Z.	Hold in 6.8-14.7s. Escalate if 24h p95 rises above 14.7s.	Same project. Query span.op:pageload url.full:*docs.sentry.io/organization/data-storage-location*
Client error events on that URL	0 events in 2026-10-21T16:02:11Z to 2026-10-22T16:02:11Z against 76 sampled page spans. 6 events in 2026-10-15T16:02:11Z to 2026-10-22T16:02:11Z against 607 sampled page spans. Daily error counts were 0-4.	Hold in 0-4 error events per 24h. Escalate above 4 or if a new Expandable or MDX error title appears.	Sentry org sentry project docs. Query http.url:*organization/data-storage-location* on errors

If error events rise, inspect titles for Expandable hydrate failures on this path.

Not observable

Plausible event Open Expandable with title Planning a switch is not connected. That event would show readers opened the new checklist. Pageload spans on this URL did not return HTTP status codes, so 4xx and 5xx on the page are unknown. Click-through 404s on the new links are not split from other traffic.