Expand description

sig_fig_histogram

This library provides an exponentially distributed histogram type. This is desirable for two reasons. First, it provides the advantages of exponential histograms. Second, it provides a human-readable set of buckets that are congruent to displaying on a log10 scale. Humans don’t operate on log2. Except maybe SREs :-).

Status

Maintenance track. The library is considered stable and will be put into maintenance mode if unchanged for one year.

It is new, however, so the clock will likely reset if problems are discovered.

Scope

This library provides the bucket functions, an unbounded histogram, and a lock-free histogram.

Warts

None.

Documentation

The latest documentation is always available at docs.rs.

#histogram #instrumentation

Structs

  • A basic Histogram type.
  • A LockFreeHistogram. This trades the ability to resize to accomodate new observations as Histogram does in exchange for providing a concurrent, lock-free histogram.
  • SigFigBucketizer provides methods for computing bucket boundaries and the bucket to which a value belongs.

Enums

  • Error captures the error conditions of a histogram.