Struct ObservationBatch 

pub struct ObservationBatch<'a, P>
where
    P: PublishModel,
{ /* private fields */ }

A batch of pending observations for an event, waiting for the magnitude to be specified.

Implementations

impl<P> ObservationBatch<'_, P>

where P: PublishModel,

pub fn observe_once(&self)

Observes a batch of events that have no explicit magnitude.

By convention, this is represented as a magnitude of 1. We expose a separate method for this to make it clear that the magnitude has no inherent meaning.

pub fn observe(&self, magnitude: impl AsPrimitive<Magnitude>)

Observes a batch of events with a specific magnitude.

pub fn observe_millis(&self, duration: Duration)

Observes an event with the magnitude being the indicated duration in milliseconds.

Only the whole number part of the duration is used - fractional milliseconds are ignored. Values outside the i64 range are not guaranteed to be correctly represented.

pub fn observe_duration_millis<F, R>(&self, f: F) -> R

where F: FnOnce() -> R,

Observes the duration of a function call, in milliseconds.

Uses a low-precision clock optimized for high-frequency capture. The measurement has a granularity of roughly 1-20 ms. Durations shorter than the granularity may appear as zero.

Trait Implementations

impl<'a, P> Debug for ObservationBatch<'a, P>

where P: PublishModel + Debug,

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

Formats the value using the given formatter.

impl<P> Observe for ObservationBatch<'_, P>

where P: PublishModel,

fn observe_once(&self)

Observes an event that has no explicit magnitude.

fn observe(&self, magnitude: impl AsPrimitive<Magnitude>)

Observes an event with a specific magnitude.

fn observe_millis(&self, duration: Duration)

Observes an event with the magnitude being the indicated duration in milliseconds.

fn observe_duration_millis<F, R>(&self, f: F) -> R

where F: FnOnce() -> R,

Observes the duration of a function call, in milliseconds.