http://metrics.dropwizard.io/metrics-core: Metrics is a Java library which gives you unparalleled insight into what your code does in production. Metrics provides a powerful toolkit of ways to measure the behavior of critical components in your production environment.
  • Coda Hale
  • Ryan Tenney
  • Artem Prigoda 
package com.codahale.metrics;

import java.util.concurrent.atomic.LongAdder;


A metric which calculates the distribution of a value.

See Also:
/**
 * A metric which calculates the distribution of a value.
 *
 * @see <a href="http://www.johndcook.com/standard_deviation.html">Accurately computing running
 * variance</a>
 */
public class Histogram implements Metric, Sampling, Counting {
    private final Reservoir reservoir;
    private final LongAdder count;

    
Creates a new Histogram with the given reservoir. 
Params:
  • reservoir – the reservoir to create a histogram from
/**
     * Creates a new {@link Histogram} with the given reservoir.
     *
     * @param reservoir the reservoir to create a histogram from
     */
    public Histogram(Reservoir reservoir) {
        this.reservoir = reservoir;
        this.count = new LongAdder();
    }

    
Adds a recorded value.

Params:
  • value – the length of the value
/**
     * Adds a recorded value.
     *
     * @param value the length of the value
     */
    public void update(int value) {
        update((long) value);
    }

    
Adds a recorded value.

Params:
  • value – the length of the value
/**
     * Adds a recorded value.
     *
     * @param value the length of the value
     */
    public void update(long value) {
        count.increment();
        reservoir.update(value);
    }

    
Returns the number of values recorded.

Returns:the number of values recorded
/**
     * Returns the number of values recorded.
     *
     * @return the number of values recorded
     */
    @Override
    public long getCount() {
        return count.sum();
    }

    @Override
    public Snapshot getSnapshot() {
        return reservoir.getSnapshot();
    }
}