Skip to content

Conversation

tobias-wilfert
Copy link
Member

@tobias-wilfert tobias-wilfert commented Sep 2, 2025

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

@tobias-wilfert tobias-wilfert self-assigned this Sep 2, 2025
Copy link

vercel bot commented Sep 2, 2025

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

Project Deployment Preview Comments Updated (UTC)
sentry-docs Ready Ready Preview Comment Sep 5, 2025 0:08am
1 Skipped Deployment
Project Deployment Preview Comments Updated (UTC)
develop-docs Ignored Ignored Preview Sep 5, 2025 0:08am

Copy link

codecov bot commented Sep 2, 2025

Bundle Report

Changes will increase total bundle size by 621 bytes (0.0%) ⬆️. 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.58MB 777 bytes (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 262 bytes 796.2kB 0.03%
../app/platform-redirect/page.js.nft.json 262 bytes 796.11kB 0.03%
../app/sitemap.xml/route.js.nft.json 262 bytes 793.59kB 0.03%
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%
server/middleware-*.js 5.55kB 6.55kB 555.3% ⚠️
server/middleware-*.js -5.55kB 1.0kB -84.74%
static/gSZWrSeGZKzbCqgwjVicD/_buildManifest.js (New) 684 bytes 684 bytes 100.0% 🚀
static/gSZWrSeGZKzbCqgwjVicD/_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%

Copy link

linear bot commented Sep 3, 2025

@tobias-wilfert 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
@tobias-wilfert tobias-wilfert requested review from a team and Copilot September 4, 2025 15:19
Copy link
Contributor

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

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

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.


## 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.
Copy link
Member Author

Choose a reason for hiding this comment

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

There might be a better way to phrase this.

@tobias-wilfert tobias-wilfert marked this pull request as ready for review September 4, 2025 15:23
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Copy link
Member

@jjbayer jjbayer left a comment

Choose a reason for hiding this comment

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

Looks good but I would keep the develop docs.

tobias-wilfert and others added 2 commits September 5, 2025 13:15
Co-authored-by: Joris Bayer <joris.bayer@sentry.io>
Co-authored-by: Joris Bayer <joris.bayer@sentry.io>
cursor[bot]

This comment was marked as outdated.

Copy link

@cursor cursor bot left a comment

Choose a reason for hiding this comment

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

Bug: Broken Links After Redirect Removal

Removing the redirects for /meta/relay/projects/ and /meta/relay/pii-and-data-scrubbing/ will lead to 404 errors. These redirects previously pointed to pages that are also being deleted, causing users accessing the old URLs to encounter broken links.

src/middleware.ts#L2432-L2447

sentry-docs/src/middleware.ts

Lines 2432 to 2447 in 4c4ea1f

{
from: '/meta/relay/',
to: '/product/relay/',
},
{
from: '/product/security/relay/',
to: '/product/relay/',
},
{
from: '/meta/relay/getting-started/',
to: '/product/relay/getting-started/',
},
{
from: '/meta/relay/options/',
to: '/product/relay/options/',
},

Fix in Cursor Fix in Web


Comment on lines 71 to 102
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"]
}
}
}
}
```
Copy link
Member Author

@tobias-wilfert tobias-wilfert Sep 5, 2025

Choose a reason for hiding this comment

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

@jjbayer Is it ok if I remove this though?

Copy link
Member

Choose a reason for hiding this comment

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

Yes!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants