From fff69eb8cdafea375a04352500d5388d866eb668 Mon Sep 17 00:00:00 2001 From: Brandon Morelli Date: Fri, 27 Oct 2023 10:39:15 -0700 Subject: [PATCH 1/2] Update sampling.asciidoc --- docs/sampling.asciidoc | 19 ++++++++++++++----- 1 file changed, 14 insertions(+), 5 deletions(-) diff --git a/docs/sampling.asciidoc b/docs/sampling.asciidoc index 7db04caecb4..e41c506ebe3 100644 --- a/docs/sampling.asciidoc +++ b/docs/sampling.asciidoc @@ -47,11 +47,20 @@ image::./images/dt-sampling-example-2.png[Distributed tracing and head based sam **OpenTelemetry with head-based sampling** -Head-based sampling is implemented in the APM agents and SDKs, and -requires the sample rate to be propagated between services and the APM Server. -This functionality is not currently supported by OpenTelemetry, -which results in inaccurate APM throughput, latency, and error metrics. +Head-based sampling is implemented directly in the APM agents and SDKs. +The sample rate must be propagated between services and the managed intake service in order to produce accurate metrics. + +OpenTelemetry offers multiple samplers. However, most samplers do not propagate the sample rate. +This results in inaccurate span-based metrics, like APM throughput, latency, and error metrics. + +For accurate span-based metrics when using head-based sampling with OpenTelemetry, you must use +a [consistent probability sampler](https://opentelemetry.io/docs/specs/otel/trace/tracestate-probability-sampling/). +These samplers propagate the sample rate between services and the managed intake service, resulting in accurate metrics. + +NOTE: At the time of this writing, OpenTelemetry does not offer consistent probability samplers in all languanges. OpenTelemetry users should consider using tail-based sampling instead. ++ +Refer to the documentation of your favorite OpenTelemetry agent or SDK for more information on the availability of consistent probability samplers. [float] [[tail-based-sampling]] @@ -196,4 +205,4 @@ include::./configure/sampling.asciidoc[tag=tbs-top] **Policy settings:** include::./configure/sampling.asciidoc[tag=tbs-policy] -:leveloffset: -3 \ No newline at end of file +:leveloffset: -3 From 7238be73f7795bd042b89241cab4ada50e6444a6 Mon Sep 17 00:00:00 2001 From: Brandon Morelli Date: Fri, 27 Oct 2023 12:09:11 -0700 Subject: [PATCH 2/2] Update sampling.asciidoc --- docs/sampling.asciidoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/sampling.asciidoc b/docs/sampling.asciidoc index e41c506ebe3..6b9ae285a1e 100644 --- a/docs/sampling.asciidoc +++ b/docs/sampling.asciidoc @@ -57,7 +57,7 @@ For accurate span-based metrics when using head-based sampling with OpenTelemetr a [consistent probability sampler](https://opentelemetry.io/docs/specs/otel/trace/tracestate-probability-sampling/). These samplers propagate the sample rate between services and the managed intake service, resulting in accurate metrics. -NOTE: At the time of this writing, OpenTelemetry does not offer consistent probability samplers in all languanges. +NOTE: OpenTelemetry does not offer consistent probability samplers in all languanges. OpenTelemetry users should consider using tail-based sampling instead. + Refer to the documentation of your favorite OpenTelemetry agent or SDK for more information on the availability of consistent probability samplers.