NAME

       "Net::Prometheus::Histogram" - count the distribution of numeric observations

SYNOPSIS

          use Net::Prometheus;
          use Time::HiRes qw( time );

          my $client = Net::Prometheus->new;

          my $histogram = $client->new_histogram(
             name => "request_seconds",
             help => "Summary request processing time",
          );

          sub handle_request
          {
             my $start = time();

             ...

             $summary->observe( time() - $start );
          }

DESCRIPTION

       This class provides a histogram metric - a count of the distribution of individual numerical observations
       into distinct buckets. These are usually reports of times. It is a subclass of Net::Prometheus::Metric.

CONSTRUCTOR

       Instances of this class are not usually constructed directly, but instead via the Net::Prometheus object
       that will serve it:

          $histogram = $prometheus->new_histogram( %args )

       This takes the same constructor arguments as documented in Net::Prometheus::Metric, and additionally the
       following:

       buckets => ARRAY
           A reference to an ARRAY containing numerical upper bounds for the buckets.

       bucket_min => NUM
       bucket_max => NUM
       buckets_per_decade => ARRAY[ NUM ]
           Since version 0.10.

           A   more   flexible   alternative   to   specifying   literal  bucket  sizes.  The  values  given  in
           "buckets_per_decade" are repeated, multiplied by various powers of  10  to  generate  values  between
           "bucket_min"  (or  a  default of 0.001 if not supplied) and "bucket_max" (or a default of 1000 if not
           supplied).

   bucket_bounds
          @bounds = $histogram->bucket_bounds

       Returns the bounding values for each of the buckets, excluding the final "+Inf" bucket.

   observe
          $histogram->observe( @label_values, $value )
          $histogram->observe( \%labels, $value )

          $child->observe( $value )

       Increment the histogram sum by the given value, and each bucket count by 1 where the value is  less  than
       or equal to the bucket upper bound.

AUTHOR

       Paul Evans <leonerd@leonerd.org.uk>

perl v5.38.2                                       2024-03-31                    Net::Prometheus::Histogram(3pm)