Prometheus Rust client library
This is the Rust client library for Prometheus. The main Structures and APIs are ported from Go client.
Usage
-
Add this to your
Cargo.toml
:[dependencies] prometheus = "0.3"
-
Add this to your crate in
lib.rs
:extern crate prometheus;
-
Or enable nightly feature for better performance.
[dependencies.prometheus] git = "https://github.com/pingcap/rust-prometheus.git" default-features = false features = ["nightly"]
Example
use prometheus::{Opts, Registry, Counter, TextEncoder, Encoder};
// Create a Counter.
let counter_opts = Opts::new("test_counter", "test counter help");
let counter = Counter::with_opts(counter_opts).unwrap();
// Create a Registry and register Counter.
let r = Registry::new();
r.register(Box::new(counter.clone())).unwrap();
// Inc.
counter.inc();
// Gather the metrics.
let mut buffer = vec![];
let encoder = TextEncoder::new();
let metric_familys = r.gather();
encoder.encode(&metric_familys, &mut buffer).unwrap();
// Output to the standard output.
println!("{}", String::from_utf8(buffer).unwrap());