histogram - histogram storage and percentile stats

Histogram is a stats library for rust which provides histogram storage with percentile stats. It maintains precision guarentees throughout the range of stored values. The bucketing algorithm makes use of logarithmic outer buckets with linear steps between those buckets. This allows for storing a wide range of values - like latency in nanoseconds from one nanosecond all that way to minutes while maintaining precision of those recorded values.

Code of Conduct

NOTE: All conversations and contributions to this project shall adhere to the Code of Conduct

Usage

To use histogram, first add this to your Cargo.toml:

[dependencies]
histogram = "*"

Then, add this to your crate root:

extern crate histogram;

The API documentation of this library can be found at docs.rs/histogram.

Features

Values are stored with precision guarentees
Pre-allocated on initialization
Retrieve percentile stats

License

Licensed under either of

Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

brayniac / histogram