Configure tail sampling in the OpenTelemetry Collector to keep only high-value traces

domain: opentelemetry.io · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Add the tailsampling processor to your Collector pipeline in the processors section of the config
  2. Set decision_wait (e.g., 10s) to control how long the Collector buffers spans before making a sampling decision; ensure this is longer than your slowest service's trace duration
  3. Define policies in the tail_sampling processor: combine latency (threshold_ms), status_code (ERROR), probabilistic (sampling_percentage), and composite policies using the and policy type
  4. Route all OTLP receivers through the tailsampling processor before the exporter so that span data is held in memory during the decision window
  5. In a multi-Collector deployment use the loadbalancing exporter in a gateway tier to route all spans of a given trace_id to the same Collector instance running tail sampling
  6. Monitor Collector memory usage; set memory_limiter processor before tailsampling to emit a backpressure signal and drop data before OOM

Known gotchas

Related routes

Configure the OpenTelemetry Collector tail sampling processor with multiple composite policies for intelligent trace retention
opentelemetry.io · 6 steps · unrated
Configure the OpenTelemetry Collector groupbytrace processor to buffer and group spans by trace ID before a downstream tail-sampling processor
github.com/open-telemetry/opentelemetry-collector-contrib · 6 steps · unrated
Configure OTel Collector tail-based sampling with composite policies
opentelemetry.io · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans