docs(telemetry): fix head sampling at 1.0, remove configurable ratio

Document that head sampling is intentionally fixed at 100% and no longer
exposes a sampling_ratio config knob. A per-node ratio let nodes make
divergent keep/drop decisions for the same distributed trace, producing
broken/partial traces; pinning at 1.0 with a ParentBased sampler keeps
decisions coherent across the network. Volume reduction is delegated to
collector-side tail sampling.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Pratik Mankawde
2026-06-09 18:22:52 +01:00
parent fe13359024
commit 5598b0eac7
5 changed files with 22 additions and 20 deletions

View File

@@ -53,8 +53,10 @@ public:
bool useTls = false;
std::string tlsCertPath;
// Sampling configuration
double samplingRatio = 1.0; // 1.0 = 100% sampling
// Head sampling: fixed at 1.0 (sample everything), not config-driven.
// Keeps trace keep/drop decisions coherent across nodes; volume
// reduction is delegated to the collector's tail sampling.
double samplingRatio = 1.0;
// Batch processor settings
std::uint32_t batchSize = 512;