diff --git a/docs/concepts/otlp/sentry-with-otel.mdx b/docs/concepts/otlp/sentry-with-otel.mdx index 9e7b04ee4acc5..cc20c1c4bdec1 100644 --- a/docs/concepts/otlp/sentry-with-otel.mdx +++ b/docs/concepts/otlp/sentry-with-otel.mdx @@ -16,6 +16,16 @@ This gives you end-to-end visibility: ![Sentry Distributed Trace](./img/sentry-distributed-trace.png) + + +When `propagateTraceparent` is enabled, the frontend SDK encodes its sampling decision in the `traceparent` header. If your OTel backend uses a `parentbased_*` sampler (the default is `parentbased_always_on`), it honors that decision and skips your collector's tail-based sampler entirely. + +To preserve tail-based sampling, set your backend's sampler to `always_on` so all spans reach the collector for evaluation: + +`OTEL_TRACES_SAMPLER=always_on` + + + The following SDKs support the `propagateTraceparent` option:
diff --git a/docs/platforms/android/configuration/options.mdx b/docs/platforms/android/configuration/options.mdx index 656f5dff93aab..028287290ae31 100644 --- a/docs/platforms/android/configuration/options.mdx +++ b/docs/platforms/android/configuration/options.mdx @@ -335,6 +335,8 @@ If is not provided, trace Controls whether the SDK should propagate the W3C `traceparent` HTTP header alongside the `sentry-trace` and `baggage` headers for outgoing HTTP requests. + + diff --git a/docs/platforms/apple/common/configuration/options.mdx b/docs/platforms/apple/common/configuration/options.mdx index 2e6468953fd20..97269394e60d4 100644 --- a/docs/platforms/apple/common/configuration/options.mdx +++ b/docs/platforms/apple/common/configuration/options.mdx @@ -667,6 +667,8 @@ Set this option to `true` if your backend services are instrumented with a W3C T Use to control which requests the `traceparent` header is attached to. + + diff --git a/docs/platforms/dart/guides/flutter/configuration/options.mdx b/docs/platforms/dart/guides/flutter/configuration/options.mdx index fe969649980f2..a9153c83d913e 100644 --- a/docs/platforms/dart/guides/flutter/configuration/options.mdx +++ b/docs/platforms/dart/guides/flutter/configuration/options.mdx @@ -272,6 +272,8 @@ If is not provided, trace Controls whether the SDK should propagate the W3C `traceparent` HTTP header alongside the `sentry-trace` and `baggage` headers for outgoing HTTP requests. + + ## Experimental Features diff --git a/docs/platforms/go/common/configuration/options.mdx b/docs/platforms/go/common/configuration/options.mdx index 6d36c808466ad..a26b24a2cd97b 100644 --- a/docs/platforms/go/common/configuration/options.mdx +++ b/docs/platforms/go/common/configuration/options.mdx @@ -194,6 +194,8 @@ Controls which URLs will have trace propagation enabled. Does not support regex When set to `true`, the W3C Trace Context HTTP `traceparent` header is propagated on outgoing HTTP requests. + + diff --git a/docs/platforms/java/common/configuration/options.mdx b/docs/platforms/java/common/configuration/options.mdx index 826e5d59c491c..1876eea6bbdef 100644 --- a/docs/platforms/java/common/configuration/options.mdx +++ b/docs/platforms/java/common/configuration/options.mdx @@ -289,6 +289,8 @@ If is not provided, trace Controls whether the SDK should propagate the W3C `traceparent` HTTP header alongside the `sentry-trace` and `baggage` headers for distributed tracing. This option defaults to `false` and is available starting from SDK version 8.22.0. + + diff --git a/docs/platforms/javascript/common/configuration/options.mdx b/docs/platforms/javascript/common/configuration/options.mdx index cee6e0d4f9a50..34b2c65e4e320 100644 --- a/docs/platforms/javascript/common/configuration/options.mdx +++ b/docs/platforms/javascript/common/configuration/options.mdx @@ -600,6 +600,8 @@ See De + + diff --git a/docs/platforms/native/common/configuration/options.mdx b/docs/platforms/native/common/configuration/options.mdx index 7accebb88c118..7fc15c9231818 100644 --- a/docs/platforms/native/common/configuration/options.mdx +++ b/docs/platforms/native/common/configuration/options.mdx @@ -82,6 +82,8 @@ Controls how much memory the `native` backend captures in minidumps. This settin Controls whether the SDK should propagate the W3C `traceparent` HTTP header alongside the `sentry-trace` header for [distributed tracing](https://docs.sentry.io/platforms/native/tracing/trace-propagation/custom-instrumentation/). + + diff --git a/docs/platforms/react-native/configuration/options.mdx b/docs/platforms/react-native/configuration/options.mdx index c1058bba9bb60..c0c523a31c3f8 100644 --- a/docs/platforms/react-native/configuration/options.mdx +++ b/docs/platforms/react-native/configuration/options.mdx @@ -322,6 +322,8 @@ If is not provided, trace Controls whether the SDK should propagate the W3C `traceparent` HTTP header alongside the `sentry-trace` and `baggage` headers for outgoing HTTP requests. + + ## Experimental Features diff --git a/includes/platforms/configuration/options/propagate-traceparent-tail-sampling.mdx b/includes/platforms/configuration/options/propagate-traceparent-tail-sampling.mdx new file mode 100644 index 0000000000000..005828048123c --- /dev/null +++ b/includes/platforms/configuration/options/propagate-traceparent-tail-sampling.mdx @@ -0,0 +1 @@ +If your backend uses an OTel collector with tail-based sampling, see [Sentry with OTel](/concepts/otlp/sentry-with-otel/) for an important interaction with this option. \ No newline at end of file