Struct Sampler 

pub struct Sampler { /* private fields */ }

A sampler that decides whether a trace should be recorded.

Implementations

impl Sampler

pub fn new(config: SamplingConfig) -> Self

Create a new sampler with the given configuration.

pub fn should_sample(&mut self, trace_id_low: u64, now_unix_sec: u64) -> bool

Decide whether a new root trace should be sampled.

For child spans, the decision is inherited from the parent trace context (if the parent is sampled, the child is sampled).

trace_id_low is the low 64 bits of the trace ID, used as a deterministic hash for HeadBased sampling. now_unix_sec is the current Unix timestamp in seconds, used for RateBased windows.

pub fn should_sample_child(parent: &TraceContext) -> bool

Check if a child span should be sampled, given its parent context.

If the parent is sampled, the child is always sampled (propagation).

pub fn config(&self) -> &SamplingConfig

Get the current configuration.