Struct MetricsCore 

pub struct MetricsCore { /* private fields */ }

Main metrics interface - the core of everything

Implementations

impl MetricsCore

pub fn new() -> Self

Create new metrics core

pub fn counter(&self, name: &str) -> Arc<Counter>

Get or create a counter by name. Requires the count feature.

name is accepted as &str — string literals ("counter") and owned/borrowed runtime names both work. The first lookup for a given name allocates a String key inside the registry; subsequent lookups of the same name reuse the cached Arc and perform no allocations.

pub fn counter_with(&self, name: &str, labels: &LabelSet) -> Arc<Counter>

Get or create a labeled counter. Requires the count feature.

Routes to the cardinality overflow sink when the cap is full; use Self::try_counter_with to receive an explicit error instead.

pub fn try_counter_with( &self, name: &str, labels: &LabelSet, ) -> Result<Arc<Counter>>

Labeled counter returning Err(CardinalityExceeded) when the cap is full. Requires the count feature.

pub fn gauge(&self, name: &str) -> Arc<Gauge>

Get or create a gauge by name. Requires the gauge feature.

name is accepted as &str — see Self::counter for allocation semantics.

pub fn gauge_with(&self, name: &str, labels: &LabelSet) -> Arc<Gauge>

Get or create a labeled gauge. Requires the gauge feature.

pub fn try_gauge_with( &self, name: &str, labels: &LabelSet, ) -> Result<Arc<Gauge>>

Labeled gauge returning Err(CardinalityExceeded) when the cap is full. Requires the gauge feature.

pub fn timer(&self, name: &str) -> Arc<Timer>

Get or create a timer by name. Requires the timer feature.

name is accepted as &str — see Self::counter for allocation semantics.

pub fn timer_with(&self, name: &str, labels: &LabelSet) -> Arc<Timer>

Get or create a labeled timer. Requires the timer feature.

pub fn try_timer_with( &self, name: &str, labels: &LabelSet, ) -> Result<Arc<Timer>>

Labeled timer returning Err(CardinalityExceeded) when the cap is full. Requires the timer feature.

pub fn time<T>(&self, name: &str, f: impl FnOnce() -> T) -> T

Time a synchronous closure and record the elapsed duration. Requires the timer feature.

pub fn system(&self) -> &SystemHealth

Get system health interface

pub fn registry(&self) -> &Registry

Get registry for advanced operations

Trait Implementations

impl Default for MetricsCore

fn default() -> Self

Returns the “default value” for a type.