Struct Gauge 

pub struct Gauge<N = i64, A = Atomic<i64>> { /* private fields */ }

Open Metrics Gauge to record current measurements.

Single increasing, decreasing or constant value metric.

Gauge is generic over the actual data type tracking the Gauge state as well as the data type used to interact with the Gauge. Out of convenience the generic type parameters are set to use an AtomicI64 as a storage and i64 on the interface by default.

Examples

Using AtomicI64 as storage and i64 on the interface

let gauge: Gauge = Gauge::default();
gauge.set(42);
let _value = gauge.get();

Using AtomicU64 as storage and f64 on the interface

let gauge = Gauge::<f64, AtomicU64>::default();
gauge.set(42.0);
let _value: f64 = gauge.get();

Implementations

impl<N, A> Gauge<N, A>

where A: Atomic<N>,

pub fn inc(&self) -> N

Increase the Gauge by 1, returning the previous value.

pub fn inc_by(&self, v: N) -> N

Increase the Gauge by v, returning the previous value.

pub fn dec(&self) -> N

Decrease the Gauge by 1, returning the previous value.

pub fn dec_by(&self, v: N) -> N

Decrease the Gauge by v, returning the previous value.

pub fn set(&self, v: N) -> N

Sets the Gauge to v, returning the previous value.

pub fn get(&self) -> N

Get the current value of the Gauge.

pub fn inner(&self) -> &A

Exposes the inner atomic type of the Gauge.

This should only be used for advanced use-cases which are not directly supported by the library.

Trait Implementations

impl<N, A> Clone for Gauge<N, A>

fn clone(&self) -> Gauge<N, A>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<N, A> Debug for Gauge<N, A>

where N: Debug, A: Debug,

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

Formats the value using the given formatter.

impl<N, A> Default for Gauge<N, A>

where A: Default,

fn default() -> Gauge<N, A>

Returns the “default value” for a type.

impl<N, A> EncodeMetric for Gauge<N, A>

where N: EncodeGaugeValue, A: Atomic<N>,

fn encode(&self, encoder: MetricEncoder<'_>) -> Result<(), Error>

Encode the given instance in the OpenMetrics text encoding.

fn metric_type(&self) -> MetricType

The OpenMetrics metric type of the instance.

fn is_empty(&self) -> bool

Check if the metric is empty.

impl GaugeExt for Gauge

fn try_set<T: TryInto<GaugeValue>>( &self, value: T, ) -> Result<GaugeValue, T::Error>

Set a gauge from a lossless integer conversion.

fn try_set_max<T: TryInto<GaugeValue> + Copy>( &self, value: T, ) -> Result<GaugeValue, T::Error>

Atomically raise a gauge to at least the provided value.

impl<N, A> TypedMetric for Gauge<N, A>

const TYPE: MetricType = MetricType::Gauge

The OpenMetrics metric type.