dipstick

A one-stop shop metrics library for Rust applications with lots of features,
minimal impact on applications and a choice of output to downstream systems.

Features

Dipstick is a toolkit to help all sorts of application collect and send out metrics. As such, it needs a bit of set up to suit one's needs. Skimming through the handbook and many examples should help you get an idea of the possible configurations.

In short, dipstick-enabled apps can:

• Send metrics to console, log, statsd, graphite or prometheus (one or many)
• Serve metrics over HTTP
• Locally aggregate the count, sum, mean, min, max and rate of metric values
• Publish aggregated metrics, on schedule or programmatically
• Customize output statistics and formatting
• Define global or scoped (e.g. per request) metrics
• Statistically sample metrics (statsd)
• Choose between sync or async operation
• Choose between buffered or immediate output
• Switch between metric backends at runtime

For convenience, dipstick builds on stable Rust with minimal, feature-gated dependencies.

Non-goals

Dipstick's focus is on metrics collection (input) and forwarding (output). Although it will happily aggregate base statistics, for the sake of simplicity and performance Dipstick will not - plot graphs - send alerts - track histograms

These are all best done by downstream timeseries visualization and monitoring tools.

Show me the code!

Here's a basic aggregating & auto-publish counter metric:

$rust,skt-run let bucket = AtomicBucket::new(); bucket.set_drain(Stream::to_stdout()); bucket.flush_every(std::time::Duration::from_secs(3)); let counter = bucket.counter("counter_a"); counter.count(8);

Persistent apps wanting to declare static metrics will prefer using the metrics! macro:

```$rust,skt-run metrics! { METRICS = "myapp" => { pub COUNTER: Counter = "mycounter"; } }

fn main() { METRICS.settarget(Graphite::sendto("localhost:2003").unwrap().input()); COUNTER.count(32); } ```

For sample applications see the examples. For documentation see the handbook.

To use Dipstick in your project, add the following line to your Cargo.toml in the [dependencies] section:

toml dipstick = "0.7.0"

TODO / Missing / Weak points

• Prometheus support is still primitive. Official prometheus-rust crate is used but Labels/Tags are not passed to it.
• No backend for "pull" metrics yet. Should at least provide tiny-http listener capability.
• No quick integration feature with common frameworks (Actix, etc.) is provided yet.
• Thread Local buckets could be nice.
• "Rolling" aggregators would be nice for pull metrics. Current bucket impl resets after flush.

License

Dipstick is licensed under the terms of the Apache 2.0 and MIT license.