Struct SampledTimer 

pub struct SampledTimer { /* private fields */ }

Counts every timed operation and samples elapsed latency into a histogram.

Durations are recorded in nanoseconds.

Implementations

impl SampledTimer

pub fn new(bounds_nanos: &[u64], shard_count: usize, sample_stride: u64) -> Self

Create a sampled timer with custom histogram bounds in nanoseconds.

sample_stride is rounded up to a power of two. A stride of 1 records every call.

pub fn with_latency_buckets(shard_count: usize, sample_stride: u64) -> Self

Create a sampled timer with default latency buckets in nanoseconds.

pub fn start(&self) -> SampledTimerGuard<'_>

Start timing one operation.

pub fn record_elapsed(&self, elapsed: Duration)

Record an already-measured duration if this call should be sampled.

pub fn calls(&self) -> u64

Total operation calls, sampled or not.

pub fn sample_count(&self) -> u64

Number of latency samples recorded.

pub fn sample_sum_nanos(&self) -> u64

Sum of sampled latency values in nanoseconds.

pub fn avg_sample_nanos(&self) -> Option<f64>

Average sampled latency in nanoseconds.

pub fn calls_metric(&self) -> &Counter

Access the underlying call counter for export.

pub fn histogram(&self) -> &Histogram

Access the underlying sampled histogram for export.

Trait Implementations

impl ClickHouseExport for SampledTimer

fn export_clickhouse( &self, batch: &mut ClickHouseMetricBatch, name: &str, description: &str, time_unix_nano: u64, )

impl DogStatsDExport for SampledTimer

fn export_dogstatsd( &self, output: &mut String, name: &str, tags: &[(&str, &str)], )

Export this metric to the output string in DogStatsD format.

impl OtlpExport for SampledTimer

fn export_otlp( &self, metrics: &mut Vec<Metric>, name: &str, description: &str, time_unix_nano: u64, )

impl PrometheusExport for SampledTimer

fn export_prometheus(&self, output: &mut String, name: &str, help: &str)

Export this metric to the output string.