feat(relay): Update docs to clarify that `managed` mode is available for all and `static` mode is gone #14787

tobias-wilfert · 2025-09-02T12:25:20Z

The static relay mode will be discontinued and in its place every customer will gain access to the managed mode. This PR updates the documentation to reflect this new reality by:

Removing the warnings saying that managed mode is only available to buisness or enterprise customers
Removing the documentation pages that where only needed because of static mode
Removing the mention of static mode except for in the mode docs themself where the docs now tells people to migrate to one of the other modes.

Ref: https://linear.app/getsentry/issue/INGEST-543/update-the-docs

vercel · 2025-09-02T12:25:26Z

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

Project	Deployment	Preview	Comments	Updated (UTC)
sentry-docs	Ready	Preview	Comment	Sep 8, 2025 1:28pm

1 Skipped Deployment

Project	Deployment	Preview	Comments	Updated (UTC)
develop-docs	Ignored	Preview		Sep 8, 2025 1:28pm

codecov · 2025-09-02T12:30:02Z

Bundle Report

Changes will increase total bundle size by 1.6kB (0.01%) ⬆️. This is within the configured threshold ✅

Detailed changes

Bundle name	Size	Change
sentry-docs-edge-server-array-push	352.16kB	-150 bytes (-0.04%) ⬇️
sentry-docs-client-array-push	9.91MB	-6 bytes (-0.0%) ⬇️
sentry-docs-server-cjs	12.59MB	1.75kB (0.01%) ⬆️

Affected Assets, Files, and Routes:

view changes for bundle: sentry-docs-server-cjs

Assets Changed:

Asset Name	Size Change	Total Size	Change (%)
`1729.js`	-3 bytes	1.78MB	-0.0%
`../instrumentation.js`	-3 bytes	1.1MB	-0.0%
`9523.js`	-3 bytes	1.08MB	-0.0%
`../app/[[...path]]/page.js.nft.json`	587 bytes	796.52kB	0.07%
`../app/platform-redirect/page.js.nft.json`	587 bytes	796.44kB	0.07%
`../app/sitemap.xml/route.js.nft.json`	587 bytes	793.91kB	0.07%

view changes for bundle: sentry-docs-client-array-push

Assets Changed:

Asset Name	Size Change	Total Size	Change (%)
`static/chunks/pages/_app-*.js`	-3 bytes	882.71kB	-0.0%
`static/chunks/8321-*.js`	-3 bytes	425.87kB	-0.0%
`static/ASWtjWYHaVtUjqG2bT3fZ/_buildManifest.js` (New)	684 bytes	684 bytes	100.0% 🚀
`static/ASWtjWYHaVtUjqG2bT3fZ/_ssgManifest.js` (New)	77 bytes	77 bytes	100.0% 🚀
~~*`static/mgL-.js`*~~ (Deleted)*	-684 bytes	0 bytes	-100.0% 🗑️
~~*`static/mgL-.js`*~~ (Deleted)*	-77 bytes	0 bytes	-100.0% 🗑️

view changes for bundle: sentry-docs-edge-server-array-push

Assets Changed:

Asset Name	Size Change	Total Size	Change (%)
`src/middleware.js`	-150 bytes	207.44kB	-0.07%

linear · 2025-09-03T15:27:28Z

INGEST-543 Update the Docs

…rects to them.

…om else where in the code.

…-managed-warning

Copilot

Pull Request Overview

This PR updates documentation to reflect changes in Relay mode availability: managed mode is now available to all customers while static mode has been deprecated. The changes remove outdated billing restrictions and deprecated documentation.

Removes warnings that managed mode is only available to Business/Enterprise customers
Deprecates static mode documentation and redirects
Cleans up PII documentation that was primarily needed for static mode

Reviewed Changes

Copilot reviewed 13 out of 13 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
src/middleware.ts	Removes redirect mappings for deprecated PII and static mode documentation
redirects.js	Removes application PII redirect that's no longer needed
docs/product/relay/projects.mdx	Removes entire project configuration documentation for static mode
docs/product/relay/options.mdx	Updates available relay modes from `managed, static, proxy, capture` to `managed, proxy`
docs/product/relay/modes/pii-and-data-scrubbing.mdx	Removes PII scrubbing documentation specific to static mode
docs/product/relay/modes/index.mdx	Removes managed mode billing restrictions and static mode documentation, adds deprecation notice
docs/product/relay/index.mdx	Removes managed mode billing restriction alert
docs/product/relay/getting-started.mdx	Removes managed mode billing warnings and static mode references
develop-docs/backend/application-domains/transaction-clustering/index.mdx	Removes reference to deprecated PII documentation
develop-docs/backend/application-domains/pii/types.mdx	Removes entire PII rule types documentation
develop-docs/backend/application-domains/pii/selectors.mdx	Removes entire PII selectors documentation
develop-docs/backend/application-domains/pii/methods.mdx	Removes entire PII redaction methods documentation
develop-docs/backend/application-domains/pii/index.mdx	Removes entire PII and data scrubbing documentation

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

docs/product/relay/modes/index.mdx

tobias-wilfert · 2025-09-04T15:23:25Z

docs/product/relay/modes/index.mdx

+
+## Static Mode
+
+Static mode has been deprecated as of Relay version 25.9.0. Pleas use `managed` or `proxy` mode instead. When switching to `managed` mode don't forget to migrate any local scrubbing rules by configuring them in the Sentry UI.


There might be a better way to phrase this.

Co-authored-by: Copilot <[email protected]>

jjbayer

Looks good but I would keep the develop docs.

develop-docs/backend/application-domains/pii/index.mdx

docs/product/relay/modes/index.mdx

Co-authored-by: Joris Bayer <[email protected]>

…-managed-warning

tobias-wilfert · 2025-09-05T11:35:35Z

develop-docs/backend/application-domains/pii/index.mdx

+After iterating on the config, paste it back into the project config located at
+`.relay/projects/<PROJECT_ID>.json`
+
+For example:
+
+```json
+{
+  "publicKeys": [
+    {
+      "publicKey": "___PUBLIC_KEY___",
+      "isEnabled": true
+    }
+  ],
+  "config": {
+    "allowedDomains": ["*"],
+    "piiConfig": {
+      "rules": {
+        "device_id": {
+          "type": "pattern",
+          "pattern": "d/[a-f0-9]{12}",
+          "redaction": {
+            "method": "hash"
+          }
+        }
+      },
+      "applications": {
+        "freeform": ["device_id"]
+      }
+    }
+  }
+}
+```


@jjbayer Is it ok if I remove this though?

jjbayer

See two more suggestions, but nothing blocking.

jjbayer · 2025-09-08T09:47:49Z

develop-docs/backend/application-domains/transaction-clustering/index.mdx

 to aggregate performance data and provide more valuable insights.

 In terms of user experience, this feature plays a similar role as [Issue Grouping](/backend/grouping/).
-In terms of technical implementation, it is similar to [Data Scrubbing](/backend/pii/).


Can we leave this item in place now that not all pii docs are gone from dev docs?

Yeah that is a fair point.

docs/product/relay/modes/index.mdx

Co-authored-by: Joris Bayer <[email protected]>

This needs to be coordinated with changes in Sentry that make managed mode available to everyone and an updating of the docs telling people managed mode is now available. Sentry PRs: getsentry/sentry#98696 & getsentry/sentry#98688 Docs PR: getsentry/sentry-docs#14787 Ref: https://linear.app/getsentry/issue/INGEST-545/update-relay --------- Co-authored-by: Joris Bayer <[email protected]>

Remove managed warning

b4d9a61

tobias-wilfert self-assigned this Sep 2, 2025

tobias-wilfert mentioned this pull request Sep 2, 2025

feat(relay): Remove static mode getsentry/relay#5108

Merged

vercel bot had a problem deploying to Preview – sentry-docs September 2, 2025 13:08 Failure

tobias-wilfert mentioned this pull request Sep 4, 2025

feat(relay): Managed Relay for all (front-end) getsentry/sentry#98688

Merged

Remove file that where only necessary for static mode and web or redi…

e8386fc

…rects to them.

vercel bot deployed to Preview – develop-docs September 4, 2025 14:42 View deployment

vercel bot deployed to Preview – sentry-docs September 4, 2025 14:59 View deployment

Rephrase static and Proxy sections and remove references to static fr…

3264f27

…om else where in the code.

tobias-wilfert changed the title ~~feat(relay): Remove managed warning~~ feat(relay): Update docs to clarify that managed mode is available for all and static mode is gone Sep 4, 2025

Merge branch 'master' into tobias-wilfert/docs/remove-static-mode-and…

a1d4ab2

…-managed-warning

tobias-wilfert requested review from a team and Copilot September 4, 2025 15:19

Copilot AI reviewed Sep 4, 2025

View reviewed changes

docs/product/relay/modes/index.mdx Outdated Show resolved Hide resolved

tobias-wilfert commented Sep 4, 2025

View reviewed changes

tobias-wilfert marked this pull request as ready for review September 4, 2025 15:23

Update docs/product/relay/modes/index.mdx

580179a

Co-authored-by: Copilot <[email protected]>

vercel bot had a problem deploying to Preview – sentry-docs September 4, 2025 15:55 Failure

jjbayer requested changes Sep 5, 2025

View reviewed changes

develop-docs/backend/application-domains/pii/index.mdx Show resolved Hide resolved

docs/product/relay/modes/index.mdx Outdated Show resolved Hide resolved

docs/product/relay/modes/index.mdx Outdated Show resolved Hide resolved

tobias-wilfert and others added 2 commits September 5, 2025 13:15

Update docs/product/relay/modes/index.mdx

cdeb884

Co-authored-by: Joris Bayer <[email protected]>

Update docs/product/relay/modes/index.mdx

51885b7

Co-authored-by: Joris Bayer <[email protected]>

This comment was marked as outdated.

Sign in to view

tobias-wilfert and others added 3 commits September 5, 2025 13:28

Re-add the developer docs

d00e3a3

Typo

0d31ece

Merge branch 'master' into tobias-wilfert/docs/remove-static-mode-and…

4c4ea1f

…-managed-warning

This comment was marked as outdated.

Sign in to view

tobias-wilfert commented Sep 5, 2025

View reviewed changes

vercel bot deployed to Preview – sentry-docs September 5, 2025 12:08 View deployment

Remove reference to project config

b444138

tobias-wilfert requested a review from jjbayer September 8, 2025 06:56

vercel bot deployed to Preview – develop-docs September 8, 2025 07:00 View deployment

jjbayer approved these changes Sep 8, 2025

View reviewed changes

tobias-wilfert and others added 2 commits September 8, 2025 15:06

Re add line

92bdfd7

Update docs/product/relay/modes/index.mdx

f4355bb

Co-authored-by: Joris Bayer <[email protected]>

vercel bot deployed to Preview – sentry-docs September 8, 2025 13:28 View deployment

tobias-wilfert merged commit 789e4c1 into master Sep 8, 2025
15 checks passed

tobias-wilfert deleted the tobias-wilfert/docs/remove-static-mode-and-managed-warning branch September 8, 2025 13:32

github-actions bot locked and limited conversation to collaborators Sep 24, 2025


		## Static Mode

		Static mode has been deprecated as of Relay version 25.9.0. Pleas use `managed` or `proxy` mode instead. When switching to `managed` mode don't forget to migrate any local scrubbing rules by configuring them in the Sentry UI.

Uh oh!

feat(relay): Update docs to clarify that managed mode is available for all and static mode is gone #14787

feat(relay): Update docs to clarify that managed mode is available for all and static mode is gone #14787

Uh oh!

Conversation

tobias-wilfert commented Sep 2, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

vercel bot commented Sep 2, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

codecov bot commented Sep 2, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Bundle Report

Affected Assets, Files, and Routes:

Assets Changed:

Assets Changed:

Assets Changed:

Uh oh!

linear bot commented Sep 3, 2025

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Reviewed Changes

Uh oh!

Uh oh!

tobias-wilfert Sep 4, 2025

Choose a reason for hiding this comment

Uh oh!

jjbayer left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

This comment was marked as outdated.

Uh oh!

This comment was marked as outdated.

Uh oh!

tobias-wilfert Sep 5, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

jjbayer Sep 5, 2025

Choose a reason for hiding this comment

Uh oh!

jjbayer left a comment

Choose a reason for hiding this comment

Uh oh!

jjbayer Sep 8, 2025

Choose a reason for hiding this comment

Uh oh!

tobias-wilfert Sep 8, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

feat(relay): Update docs to clarify that `managed` mode is available for all and `static` mode is gone #14787

feat(relay): Update docs to clarify that `managed` mode is available for all and `static` mode is gone #14787

tobias-wilfert commented Sep 2, 2025 •

edited

Loading

vercel bot commented Sep 2, 2025 •

edited

Loading

codecov bot commented Sep 2, 2025 •

edited

Loading

tobias-wilfert Sep 5, 2025 •

edited

Loading