Struct TraceIdRatioSampler 

pub struct TraceIdRatioSampler { /* private fields */ }

基于 trace_id 比例的确定性采样器。

使用 trace_id 的哈希值与阈值比较，保证同一 trace_id 在所有节点上 做出相同的采样决策（无需共享状态）。

比例范围为 0.0..=1.0：

• 0.0：不采样任何 trace
• 1.0：采样所有 trace
• 0.5：采样约 50% 的 trace

Implementations

impl TraceIdRatioSampler

pub fn new(ratio: f64) -> Self

创建比例采样器

Panics

当 ratio 不在 [0.0, 1.0] 范围内时 panic。

pub fn ratio(&self) -> f64

采样比例

pub fn total_decisions(&self) -> u64

总采样决策次数

pub fn sampled_count(&self) -> u64

被采样的次数

pub fn actual_rate(&self) -> f64

实际采样率（sampled / total），总次数为 0 时返回 0.0

Trait Implementations

impl Sampler for TraceIdRatioSampler

fn should_sample( &self, trace_id: &str, _parent_sampled: Option<bool>, ) -> SamplingDecision

做出采样决策

fn name(&self) -> &'static str

采样器名称（用于可观测性）