This documentation has an index for AI agents at /llms.txt. A Markdown version of this page is available at https://explorer.opentelemetry.io/collector/components/contrib/tailsamplingprocessor.md.

Tail Sampling Processor

OpenTelemetry Collector processor · contrib distribution

  • Component ID: contrib-tailsamplingprocessor
  • Name: tailsamplingprocessor
  • Type: processor
  • Distribution: contrib
  • Repository: opentelemetry-collector-contrib

Stability

LevelSignals
betatraces

Internal telemetry

MetricTypeValue typeUnitStabilityEnabledAttributesDescription
processor_tail_sampling_count_bytes_sampledsum (monotonic)intBydevelopmentyesdecision (string), policy (string), sampled (bool)Count of bytes that were sampled or not per sampling policy
processor_tail_sampling_count_spans_sampledsum (monotonic)int{spans}developmentyesdecision (string), policy (string), sampled (bool)Count of spans that were sampled or not per sampling policy
processor_tail_sampling_count_spans_with_unparseable_tracestatesum (monotonic)int{spans}developmentyesCount of spans skipped while rewriting the effective th because their tracestate could not be parsed
processor_tail_sampling_count_traces_sampledsum (monotonic)int{traces}developmentyesdecision (string), policy (string), sampled (bool)Count of traces that were sampled or not per sampling policy
processor_tail_sampling_early_releases_from_cache_decisionsum (monotonic)int{spans}developmentyessampled (bool)Number of spans that were able to be immediately released due to a decision cache hit.
processor_tail_sampling_global_count_traces_sampledsum (monotonic)int{traces}developmentyesdecision (string), sampled (bool)Global count of traces that were sampled or not by at least one policy
processor_tail_sampling_new_trace_id_receivedsum (monotonic)int{traces}developmentyesCounts the arrival of new traces
processor_tail_sampling_sampling_decision_timer_latencyhistogramintmsdevelopmentyesLatency (in milliseconds) of each run of the sampling decision timer
processor_tail_sampling_sampling_late_span_agehistogramintsdevelopmentyesTime (in seconds) from the sampling decision was taken and the arrival of a late span
processor_tail_sampling_sampling_policy_evaluation_errorsum (monotonic)int{errors}developmentyesCount of sampling policy evaluation errors
processor_tail_sampling_sampling_policy_execution_countsum (monotonic)int{executions}developmentyespolicy (string)Total number of executions of a specific sampling policy
processor_tail_sampling_sampling_policy_execution_time_sumsum (monotonic)intusdevelopmentyespolicy (string)Total time spent (in microseconds) executing a specific sampling policy
processor_tail_sampling_sampling_trace_dropped_too_earlysum (monotonic)int{traces}developmentyesCount of traces that needed to be dropped before the configured wait time
processor_tail_sampling_sampling_trace_removal_agehistogramintsdevelopmentyesTime (in seconds) from arrival of a new trace until its removal from memory
processor_tail_sampling_sampling_traces_on_memorygaugeint{traces}developmentyesTracks the number of traces current on memory
processor_tail_sampling_traces_dropped_too_largesum (monotonic)int{traces}developmentyesCount of traces that were dropped because they were too large

Attributes

AttributeTypeDescription
decisionstringThe sampling decision
policystringName of the policy
sampledboolWhether the sampling decision was sampled or not, false can mean either not sampled or dropped

Data

  • JSON (latest): /data/collector/components/contrib-tailsamplingprocessor/latest.json
  • JSON (pinned): /data/collector/components/contrib-tailsamplingprocessor/contrib-tailsamplingprocessor-ee91184a7786.json
  • Explore: /collector/components/contrib/tailsamplingprocessor