Skip to content

Conversation

@sfanahata
Copy link
Contributor

@sfanahata sfanahata commented Oct 27, 2025

DESCRIBE YOUR PR

Updated extrapolation docs for clarity and adding an image to make it clearer how extrapolation works.

Trace Explorer updates: https://sentry-docs-git-extrapolation-doc-improvements.sentry.dev/product/explore/trace-explorer/#how-sampling-affects-queries-in-trace-explorer

Extrapolation concept: https://sentry-docs-git-extrapolation-doc-improvements.sentry.dev/concepts/key-terms/extrapolation/

Logs updates: https://sentry-docs-git-extrapolation-doc-improvements.sentry.dev/product/explore/logs/#viewing-and-searching-logs / query volumes: https://sentry-docs-git-extrapolation-doc-improvements.sentry.dev/product/explore/logs/#query-volumes

developer doc: https://develop-docs-git-extrapolation-doc-improvements.sentry.dev/application-architecture/dynamic-sampling/extrapolation/

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

@vercel
Copy link

vercel bot commented Oct 27, 2025

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

Project Deployment Preview Comments Updated (UTC)
develop-docs Ready Ready Preview Comment Nov 4, 2025 9:46pm
sentry-docs Ready Ready Preview Comment Nov 4, 2025 9:46pm


### Confidence
When users filter on data that has a very low count but also a low sample rate, yielding a highly extrapolated but low-sample dataset, developers and users should be careful with the conclusions they draw from the data. The storage platform provides confidence intervals along with the extrapolated estimates for the different aggregation types to indicate when there is elevated uncertainty in the data. These types of datasets are inherently noisy and may contain misleading information. When this is discovered, the user should either be very careful with the conclusions they draw from the aggregate data or switch to non-default mode for investigation of the individual samples.
When you filter on data that has a very low count but also a low sample rate, yielding a highly extrapolated but low-sample dataset, you should be careful with the conclusions you draw from the data. The storage platform provides confidence intervals along with the extrapolated estimates for the different aggregation types to indicate when there is lower confidence in the data. These types of datasets are inherently noisy and may contain misleading information. When this is discovered, you should either be very careful with the conclusions you draw from the aggregate data or switch to sample mode to investigate the individual samples.
Copy link
Contributor

Choose a reason for hiding this comment

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

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I'm feeling mixed on adding this image in. I'm wondering about its usefulness in develop-docs specifically, since these users are not directly using Sentry's UI.

@codecov
Copy link

codecov bot commented Nov 4, 2025

Bundle Report

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

Detailed changes
Bundle name Size Change
sentry-docs-client-array-push 10.16MB -6 bytes (-0.0%) ⬇️
sentry-docs-server-cjs 12.84MB -146.15kB (-1.13%) ⬇️

Affected Assets, Files, and Routes:

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

Assets Changed:

Asset Name Size Change Total Size Change (%)
1729.js -33.51kB 1.74MB -1.89%
../instrumentation.js -33.8kB 1.07MB -3.07%
9523.js -33.51kB 1.04MB -3.11%
../app/[[...path]]/page.js.nft.json -14.71kB 844.77kB -1.71%
../app/platform-redirect/page.js.nft.json -14.71kB 844.68kB -1.71%
../app/sitemap.xml/route.js.nft.json -14.71kB 841.91kB -1.72%
7153.js (New) 30.3kB 30.3kB 100.0% 🚀
../app/api/ip-ranges/route.js -300 bytes 5.79kB -4.92%
../app/robots.txt/route.js -300 bytes 5.02kB -5.64%
2311.js (Deleted) -30.9kB 0 bytes -100.0% 🗑️

App Routes Affected:

App Route Size Change Total Size Change (%)
/ -600 bytes 2.81MB -0.02%
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/Mo8B7MUnQkhORYkwnyi9z/_buildManifest.js (New) 684 bytes 684 bytes 100.0% 🚀
static/Mo8B7MUnQkhORYkwnyi9z/_ssgManifest.js (New) 77 bytes 77 bytes 100.0% 🚀
static/taYY_BVXmDjmgF87Vz2NN/_buildManifest.js (Deleted) -684 bytes 0 bytes -100.0% 🗑️
static/taYY_BVXmDjmgF87Vz2NN/_ssgManifest.js (Deleted) -77 bytes 0 bytes -100.0% 🗑️

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.

3 participants