Trait glean_core::traits::Timespan[−][src]

pub trait Timespan {
    fn start(&self);

    fn stop(&self);

    fn cancel(&self);

    fn set_raw(&self, elapsed: Duration);

    fn test_get_value<'a, S: Into<Option<&'a str>>>(
        &self, 
        ping_name: S
    ) -> Option<u64>;

    fn test_get_num_recorded_errors<'a, S: Into<Option<&'a str>>>(
        &self, 
        error: ErrorType, 
        ping_name: S
    ) -> 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

fn start(&self)[src]

Expand description

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.

fn stop(&self)[src]

Expand description

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

This will record an error if no start was called.

fn cancel(&self)[src]

Expand description

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

fn set_raw(&self, elapsed: Duration)[src]

Expand description

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.

fn test_get_value<'a, S: Into<Option<&'a str>>>(
    &self,
    ping_name: S
) -> Option<u64>[src]

Expand description

Exported for test purposes.

Gets the currently stored value as an integer.

This doesn’t clear the stored value.

Arguments

  • ping_name - represents the optional name of the ping to retrieve the metric for. Defaults to the first value in send_in_pings.

fn test_get_num_recorded_errors<'a, S: Into<Option<&'a str>>>(
    &self,
    error: ErrorType,
    ping_name: S
) -> i32[src]

Expand description

Exported for test purposes.

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

Arguments

  • error - The type of error
  • ping_name - represents the optional name of the ping to retrieve the metric for. Defaults to the first value in send_in_pings.

Returns

The number of errors reported.

Loading content...

Implementors

Loading content...