Skip to content

feat(python): Update the Configuration > Sampling page for Python SDK 3.0 #14275

New issue

Have a question about this project? # for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “#”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? # to your account

Merged
merged 12 commits into from
Jul 15, 2025

Conversation

sentrivana
Copy link
Contributor

@sentrivana sentrivana commented Jul 7, 2025

DESCRIBE YOUR PR

We've made some changes to sampling in the upcoming 3.0 version of the Python SDK. Creating a new 3.x version of the relevant pages.

Also removed some python.<platform>.mdx snippets because as far as I can tell they can never be displayed anywhere (and they're now outdated). They'd only display if the Python docs supported the sub-SDK/platform view like e.g. JS does.

Once 3.x is actually out of alpha, we can make the __3.x page the default and make the base page into a __2.x.

Direct link to the new page: https://sentry-docs-git-ivana-pythonsampling-breaking-changes.sentry.dev/platforms/python/configuration/sampling__v3.x (but note there are other changes too, see diff)

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.

  • Urgent deadline (GA date, etc.):
  • Other deadline:
  • None: Not urgent, can wait up to 1 week+

SLA

  • Teamwork makes the dream work, so please add a reviewer to your PRs.
  • Please give the docs team up to 1 week to review your PR unless you've added an urgent due date to it.
    Thanks in advance for your help!

PRE-MERGE CHECKLIST

Make sure you've checked the following before merging your changes:

  • 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

LEGAL BOILERPLATE

Look, I get it. The entity doing business as "Sentry" was incorporated in the State of Delaware in 2015 as Functional Software, Inc. and is gonna need some rights from me in order to utilize my contributions in this here PR. So here's the deal: I retain all rights, title and interest in and to my contributions, and by keeping this boilerplate intact I confirm that Sentry can use, modify, copy, and redistribute my contributions, under Sentry's choice of terms.

EXTRA RESOURCES

Copy link

vercel bot commented Jul 7, 2025

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
sentry-docs ✅ Ready (Inspect) Visit Preview 💬 Add feedback Jul 15, 2025 7:14am
1 Skipped Deployment
Name Status Preview Comments Updated (UTC)
develop-docs ⬜️ Ignored (Inspect) Visit Preview Jul 15, 2025 7:14am

Copy link

codecov bot commented Jul 7, 2025

Bundle Report

Changes will decrease total bundle size by 1.72kB (-0.01%) ⬇️. This is within the configured threshold ✅

Detailed changes
Bundle name Size Change
sentry-docs-server-cjs 11.9MB -1.72kB (-0.01%) ⬇️
sentry-docs-client-array-push 9.81MB -6 bytes (-0.0%) ⬇️

Affected Assets, Files, and Routes:

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 878.27kB -0.0%
static/chunks/1831-*.js -3 bytes 421.22kB -0.0%
static/OzRdbDBD35PKFE1fprtbI/_buildManifest.js (New) 684 bytes 684 bytes 100.0% 🚀
static/OzRdbDBD35PKFE1fprtbI/_ssgManifest.js (New) 77 bytes 77 bytes 100.0% 🚀
static/PA_EGTlkmGbxwdpP8t47L/_buildManifest.js (Deleted) -684 bytes 0 bytes -100.0% 🗑️
static/PA_EGTlkmGbxwdpP8t47L/_ssgManifest.js (Deleted) -77 bytes 0 bytes -100.0% 🗑️
view changes for bundle: sentry-docs-server-cjs

Assets Changed:

Asset Name Size Change Total Size Change (%)
1729.js -3 bytes 1.67MB -0.0%
../instrumentation.js -3 bytes 997.28kB -0.0%
9523.js -3 bytes 973.22kB -0.0%
../app/[[...path]]/page.js.nft.json -569 bytes 701.68kB -0.08%
../app/platform-redirect/page.js.nft.json -569 bytes 701.59kB -0.08%
../app/sitemap.xml/route.js.nft.json -569 bytes 699.56kB -0.08%

Comment on lines +86 to +106
```python
sentry_sdk.start_transaction(
# kwargs passed to Transaction constructor - will be recorded on transaction
name="GET /search",
op="search",
data={
"query_params": {
"animal": "dog",
"type": "very good"
}
},
# `custom_sampling_context` - won't be recorded
custom_sampling_context={
# PII
"user_id": "12312012",
# too big to send
"search_results": { ... }
}
)
```

Copy link
Contributor Author

@sentrivana sentrivana Jul 7, 2025

Choose a reason for hiding this comment

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

This is the current content of the snippet in performance/custom-sampling-context. Inlined it here on this page for SDK 2.0 so that the snippet can be updated to be 3.x compatible and used from the 3.x page.

Comment on lines +129 to +132
sentry_sdk.start_transaction(
name="GET /search",
sampled=True
)
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Same here

@sentrivana sentrivana changed the title Add a new version of the sampling page for Python SDK 3.0 Update sampling for Python SDK 3.0 Jul 14, 2025
Copy link
Contributor Author

Choose a reason for hiding this comment

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

This and the other python.<platform>.mdx snippets were removed because as far as I can tell they can never be displayed anywhere (and they're now outdated). They'd only display if the Python docs supported the sub-SDK/platform view like e.g. JS does.

Copy link
Member

Choose a reason for hiding this comment

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

hmm ok I see, eventually these tables from the migration guide should probably live in the specific integration pages? not sure what is best..

image

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Yeah was also thinking that might be nice. Might do this in a follow up PR.

@sentrivana sentrivana changed the title Update sampling for Python SDK 3.0 Update the Configuration > Sampling page for Python SDK 3.0 Jul 14, 2025
@sentrivana sentrivana changed the title Update the Configuration > Sampling page for Python SDK 3.0 feat(python): Update the Configuration > Sampling page for Python SDK 3.0 Jul 14, 2025
@sentrivana sentrivana marked this pull request as ready for review July 14, 2025 10:54
@sentrivana sentrivana requested review from a team July 14, 2025 10:55
@sfanahata sfanahata self-requested a review July 14, 2025 17:28
Copy link
Contributor

@sfanahata sfanahata left a comment

Choose a reason for hiding this comment

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

A couple of nits, but otherwise looks good!

Co-authored-by: Shannon Anahata <shannon.anahata@gmail.com>
@sentrivana sentrivana merged commit 7e0635b into master Jul 15, 2025
13 checks passed
@sentrivana sentrivana deleted the ivana/python/sampling-breaking-changes branch July 15, 2025 07:24
# for free to join this conversation on GitHub. Already have an account? # to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants