feat(browser): Add option to sample linked traces consistently

[Lms24]

This PR implements consistent sampling across traces as outlined in #15754. For a detailed write up see the issue.

Concrete changes:

• Add consistentTraceSampling option
• Emit beforeSampling hook before sampling and creating SentrySpan's in the coreSDK (this hook is already called in Otel-based spans).
• Allow beforeSampling hook subscribers to alter span attributes and parentSampled flag
• Subscribe to beforeSampling hook when consistentTraceSampling is enabled and linkPreviousTrace is not disabled
  • modify attributes and parentSampled flag based on the sampling decision, sample rate and sample rand of the previous trace
  • this will ensure that the newly started trace is sampled postitively/negatively depending on the decision of the previous trace
  • we also directly modify the propagation context to ensure that the previous trace's sampling decision, rate and rand are propagated correctly to downstream services and in the trace envelope header. This is necessary to ensure correct span metrics extrapolation.
• sampling decisions from <meta> tags still have precedence for the first pageload over the previous trace's sampling decision. This is necessary because we need to prioritize inter-trace completeness over intra-trace completeness
• explicit sampling decisions from tracesSampler still have precedence over the previous trace's sampling decision
• added a bunch of browser integration tests describing the behaviour in various edge cases and sampling configurations

closes #15754

[Copilot]

Copilot reviewed 20 out of 20 changed files in this pull request and generated 1 comment.

[github-actions]

size-limit report 📦

Path	Size	% Change	Change
@sentry/browser	23.34 KB	+0.12%	+28 B 🔺
@sentry/browser - with treeshaking flags	23.16 KB	+0.13%	+30 B 🔺
@sentry/browser (incl. Tracing)	37.21 KB	+0.63%	+237 B 🔺
@sentry/browser (incl. Tracing, Replay)	74.43 KB	+0.39%	+294 B 🔺
@sentry/browser (incl. Tracing, Replay) - with treeshaking flags	68.3 KB	+1.21%	+833 B 🔺
@sentry/browser (incl. Tracing, Replay with Canvas)	79.09 KB	+0.37%	+293 B 🔺
@sentry/browser (incl. Tracing, Replay, Feedback)	90.92 KB	+0.36%	+326 B 🔺
@sentry/browser (incl. Feedback)	39.73 KB	+0.03%	+9 B 🔺
@sentry/browser (incl. sendFeedback)	27.96 KB	+0.08%	+22 B 🔺
@sentry/browser (incl. FeedbackAsync)	32.73 KB	+0.07%	+21 B 🔺
@sentry/react	25.14 KB	+0.06%	+14 B 🔺
@sentry/react (incl. Tracing)	39.21 KB	+0.65%	+259 B 🔺
@sentry/vue	27.6 KB	+0.21%	+57 B 🔺
@sentry/vue (incl. Tracing)	38.98 KB	+0.65%	+255 B 🔺
@sentry/svelte	23.36 KB	+0.08%	+17 B 🔺
CDN Bundle	24.55 KB	+0.13%	+32 B 🔺
CDN Bundle (incl. Tracing)	37.28 KB	+0.78%	+295 B 🔺
CDN Bundle (incl. Tracing, Replay)	72.3 KB	+0.38%	+275 B 🔺
CDN Bundle (incl. Tracing, Replay, Feedback)	77.6 KB	+0.34%	+262 B 🔺
CDN Bundle - uncompressed	71.62 KB	+0.07%	+46 B 🔺
CDN Bundle (incl. Tracing) - uncompressed	110.26 KB	+0.78%	+870 B 🔺
CDN Bundle (incl. Tracing, Replay) - uncompressed	221.54 KB	+0.39%	+870 B 🔺
CDN Bundle (incl. Tracing, Replay, Feedback) - uncompressed	234.08 KB	+0.37%	+870 B 🔺
@sentry/nextjs (client)	40.81 KB	+0.64%	+264 B 🔺
@sentry/sveltekit (client)	37.71 KB	+0.7%	+267 B 🔺
@sentry/node	143.47 KB	+0.02%	+19 B 🔺
@sentry/node - without tracing	96.56 KB	+0.03%	+28 B 🔺
@sentry/aws-serverless	120.88 KB	+0.02%	+19 B 🔺

View base workflow run