7 releases (breaking)

0.6.1 Apr 9, 2024
0.6.0 Apr 9, 2024
0.5.0 Apr 2, 2024
0.4.0 Mar 29, 2024
0.1.0 Feb 16, 2024

#140 in Value formatting

Download history 274/week @ 2024-02-16 52/week @ 2024-02-23 309/week @ 2024-03-01 132/week @ 2024-03-08 297/week @ 2024-03-15 526/week @ 2024-03-22 685/week @ 2024-03-29 437/week @ 2024-04-05

1,951 downloads per month

MIT/Apache

30KB
556 lines

metriken

Easily registered distributed metrics.

metriken allows you to easily declare static metrics throughout your codebase. Then, when you want to expose those metrics, you can access them all in one place.

use metriken::{metric, Counter, Gauge, Value};

/// A counter metric named "<crate name>::COUNTER"
#[metric]
static COUNTER: Counter = Counter::new();

/// A gauge metric named "my.metric"
#[metric(name = "my.metric")]
static GAUGE: Gauge = Gauge::new();

fn main() {
    COUNTER.increment();

    for metric in &metriken::metrics() {
        let name = metric.name();

        match metric.value() {
            Some(Value::Counter(val)) => println!("{name}: {val}"),
            Some(Value::Gauge(val)) => println!("{name}: {val}"),
            _ => println!("{name}: <custom>")
        }
    }
}

Code updating the metrics can always access them without needing to go through any indirections. (It just means accessing a static!). Using linkme, the metrics are all gathered into a single global array that can then be used to read all of them and expose them.


lib.rs:

Exposition of Metriken metrics

Provides a standardized struct for a snapshot of the metric readings as well as a way of producing the snapshots.

Dependencies

~3–15MB
~185K SLoC