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

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

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

1 participant