From f7f76ef2d8542778a148eec613ab46edb381001a Mon Sep 17 00:00:00 2001 From: Jay DeLuca Date: Mon, 24 Jun 2024 17:27:47 -0400 Subject: [PATCH] Add context for managing data volume, reword some things --- content/en/docs/languages/java/sampling.md | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/content/en/docs/languages/java/sampling.md b/content/en/docs/languages/java/sampling.md index 3b56e6fa9570..1580e838d110 100644 --- a/content/en/docs/languages/java/sampling.md +++ b/content/en/docs/languages/java/sampling.md @@ -10,8 +10,11 @@ the sampling decision to propagate to other services. ## Default behavior -By default, all spans are sampled, and thus, 100% of traces are sampled. If you -do not need to manage data volume, don't bother setting a sampler. +By default, all spans are sampled, resulting in 100% of traces being sampled. If +your observability backend has constraints or budgetary restrictions on the +amount of data ingested, you can introduce a sampler and adjust the sample rates +accordingly. If you do not need to manage data volume, you don't need to set a +sampler and can use the default. ## Environment variables @@ -89,8 +92,8 @@ Other samplers include: - `traceIdRatioBased`, which samples a fraction of spans, based on the fraction given to the sampler. If you set `0.5`, half of all the spans are sampled. Currently, only the ratio of traces that are sampled can be relied on, not how - the sampled traces are determined. As such, it is recommended to only use this - sampler for root spans using `parentBased`. + the sampled traces are determined. Only use this sampler for root spans that + use `parentBased`. - `parentBased`, which uses the parent span to make sampling decisions, if present. By default, the tracer provider uses a parentBased sampler with the `alwaysOn` sampler.