solti-prometheus 0.0.2

Solti SDK Prometheus metrics.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

//! Build-time identity exposed as `solti_build_info` gauge (value always `1`).
//!
//! Labels carry the identity fields — dashboards and alerts use them to pin
//! observations to a specific build. Typical labels:
//!
//!  - `version`
//!  - `git_sha`
//!  - `rustc`
//!  - `built_at`

use prometheus::{IntGauge, Opts, Registry};

/// Register a `solti_build_info{labels...}` gauge with value `1`.
///
/// Labels are set as *constant* labels: they live on the metric descriptor and never change during process lifetime.
///
/// ## Example
///
/// ```text
/// solti_prometheus::register_build_info(&registry, &[
///     ("version", env!("CARGO_PKG_VERSION")),
///     ("rustc",   "1.90.0"),
/// ])?;
/// ```
pub fn register_build_info(
    registry: &Registry,
    labels: &[(&str, &str)],
) -> Result<(), prometheus::Error> {
    let mut opts =
        Opts::new("build_info", "Build-time identity (value always 1).").namespace("solti");
    for (k, v) in labels {
        opts = opts.const_label((*k).to_string(), (*v).to_string());
    }
    let gauge = IntGauge::with_opts(opts)?;
    gauge.set(1);
    registry.register(Box::new(gauge))?;
    Ok(())
}