Struct LogSampler 

pub struct LogSampler { /* private fields */ }

A 1-in-N gate for high-volume log lines. Construct once per high-volume site (or share via Arc) and call LogSampler::should_emit at the log point:

use brainos_observe::LogSampler;

let sampler = LogSampler::one_in(100);
for i in 0..250 {
    if sampler.should_emit() {
        // ~1 in 100 of these run; the other 99 are skipped.
        let _ = i;
    }
}

Implementations

impl LogSampler

pub fn one_in(n: u32) -> Self

Emit 1 in n calls. n <= 1 disables sampling (every call emits).

pub fn unsampled() -> Self

A sampler that emits on every call — the explicit “sampling off” form.

pub fn should_emit(&self) -> bool

Whether this call should emit its log line. Returns true on the 1st call and every one_in_n-th call thereafter, so a freshly built sampler always logs its first occurrence (you never lose the first instance of a newly-hot site).

pub fn rate(&self) -> u64

The configured rate (post-clamp); 1 means unsampled.

Trait Implementations

impl Debug for LogSampler

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.