#metrics #statsd #graphite #timer #prometheus


A fast, all-purpose metrics library decoupling instrumentation from reporting backends. Similar to popular logging frameworks, but with counters, timers and gauges. Can combine outputs (e.g. log + graphite), do sampling, aggregation, periodical publication, etc.

51 releases

0.9.0 May 25, 2020
0.7.13 Apr 23, 2020
0.7.11 Aug 30, 2019
0.7.10 Jul 11, 2019
0.4.11 Nov 29, 2017

#3 in Visualization

Download history 326/week @ 2020-06-09 589/week @ 2020-06-16 454/week @ 2020-06-23 278/week @ 2020-06-30 189/week @ 2020-07-07 367/week @ 2020-07-14 247/week @ 2020-07-21 191/week @ 2020-07-28 241/week @ 2020-08-04 374/week @ 2020-08-11 460/week @ 2020-08-18 764/week @ 2020-08-25 753/week @ 2020-09-01 1253/week @ 2020-09-08 1042/week @ 2020-09-15 788/week @ 2020-09-22

2,283 downloads per month
Used in spirit-dipstick



crates.io docs.rs Build Status

dipstick a dipstick picture

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.


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)
  • 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. Performance, safety and ergonomy are also prime concerns.


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:

use dipstick::*;

fn main() {
    let bucket = AtomicBucket::new();
    let counter = bucket.counter("counter_a");

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

use dipstick::*;

metrics! { METRICS = "my_app" => {
        pub COUNTER: Counter = "my_counter";

fn main() {

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:

dipstick = "0.8.0"

External features

Configuring dipstick from a text file is possible using the spirit-dipstick crate.


When building the crate prior to PR or release, just run plain old make. This will in turn run cargo a few times to run tests, benchmarks, lints, etc. Unfortunately, nightly Rust is still required to run bench and clippy.

TODO / Missing / Weak points

  • Prometheus support is still primitive (read untested). Only the push gateway approach is supported for now.
  • 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.


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


~52K SLoC