Trait glean_core::traits::Timespan

source · 
pub trait Timespan: TestGetValue<Output = u64> {
    // Required methods
    fn start(&self);
    fn stop(&self);
    fn cancel(&self);
    fn set_raw(&self, elapsed: Duration);
    fn test_get_num_recorded_errors(&self, error: ErrorType) -> i32;
}
Expand description

A description for the TimespanMetric type.

When changing this trait, make sure all the operations are implemented in the related type in ../metrics/.

Required Methods§

source

fn start(&self)

Starts tracking time for the provided metric.

This uses an internal monotonic timer.

This records an error if it’s already tracking time (i.e. start was already called with no corresponding stop): in that case the original start time will be preserved.

source

fn stop(&self)

Stops tracking time for the provided metric. Sets the metric to the elapsed time.

This will record an error if no start was called.

source

fn cancel(&self)

Aborts a previous start call. No error is recorded if no start was called.

source

fn set_raw(&self, elapsed: Duration)

Explicitly sets the timespan value.

This API should only be used if your library or application requires recording spans of time in a way that cannot make use of start/stop/cancel.

§Arguments
  • elapsed - The elapsed time to record.
source

fn test_get_num_recorded_errors(&self, error: ErrorType) -> i32

Exported for test purposes.

Gets the number of recorded errors for the given metric and error type.

§Arguments
  • error - The type of error
§Returns

The number of errors reported.

Implementors§