Skip to content

docs(dynamic-sampling): Clarify custom sample rates availability for AM3#18490

Open
constantinius wants to merge 3 commits into
masterfrom
constantinius/docs/remove-dynamic-sampling-am3
Open

docs(dynamic-sampling): Clarify custom sample rates availability for AM3#18490
constantinius wants to merge 3 commits into
masterfrom
constantinius/docs/remove-dynamic-sampling-am3

Conversation

@constantinius

@constantinius constantinius commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

DESCRIBE YOUR PR

Customers on AM3 (spans-based billing) don't have access to the dynamic sampling custom sample rates settings, but the docs describe them without any plan restrictions. This causes confusion and support tickets — customers read about the feature, can't find the settings screen, and contact support.

Changes:

  • Add a warning alert at the top of the dynamic sampling page clarifying that custom sample rate configuration is only available on plans enrolled before June 2025
  • Replace the two-flavor plan list with a single description of automatic Sampling Priorities (available on all paid plans)
  • Update the Custom Sample Rates section alert to explain when settings are not visible
  • Simplify the Sampling Priorities availability note

Closes https://linear.app/getsentry/issue/TET-2499/remove-ds-for-am3-docs

IS YOUR CHANGE URGENT?

  • Urgent deadline (GA date, etc.)
  • Other deadline
  • None: 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

Add prominent warnings that the configuration of custom sample rates
is only available on plans enrolled before June 2025. Customers on
newer plans (AM3) do not have access to these settings, and the docs
were causing confusion leading to support tickets.

- Add warning alert at the top of the page about plan availability
- Replace the two-flavor list with a single description of automatic
  Sampling Priorities (available on all paid plans)
- Update the Custom Sample Rates section alert to explain when the
  settings are not visible
- Simplify the Sampling Priorities availability note

Co-Authored-By: Claude <noreply@anthropic.com>
@vercel

vercel Bot commented Jun 19, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
sentry-docs Ready Ready Preview, Comment Jun 19, 2026 4:03pm
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
develop-docs Ignored Ignored Preview Jun 19, 2026 4:03pm

Request Review

Revert "all paid plans" back to "selected Team, Business, and
Enterprise plans" to match the original qualifying language. The
original docs used "selected" deliberately — not all plans may have
Sampling Priorities enabled.

Co-Authored-By: Claude <noreply@anthropic.com>
Comment thread docs/organization/dynamic-sampling/index.mdx
Replace vague "described below" with a direct anchor link to the
Configuration of Custom Sample Rates section. The previous wording
was ambiguous because the paragraph immediately following the warning
describes Sampling Priorities, not custom sample rates.

Co-Authored-By: Claude <noreply@anthropic.com>
@linear-code

linear-code Bot commented Jun 22, 2026

Copy link
Copy Markdown

TET-2499

@constantinius constantinius requested a review from a team June 22, 2026 08:33
@shellmayr

shellmayr commented Jun 22, 2026

Copy link
Copy Markdown
Member

We technically already have a PR open for a kind of clarification (see here) - the point of the ticket would be to actually remove the docs for AM3 and build back the version for AM2 that is applicable

@obostjancic obostjancic self-requested a review June 22, 2026 08:49
@constantinius constantinius requested a review from shellmayr June 22, 2026 08:56
<Alert>
Configuration of custom sample rates has been available on selected Enterprise plans since June 2024.
<Alert level="warning">
Configuration of custom sample rates is only available on plans that enrolled before June 2025. If you don't see these settings in your organization, your plan does not include this feature.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I'm a little worried that people might feel they are missing out on something by not being grandfathered in here. I would suggest adding something similar to the warning above where you pointed out that new plans do this automatically.

@coolguyzone coolguyzone left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

LGTM! Thanks for the clarification 🔎

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.

4 participants