The Perl Toolchain Summit 2025 Needs You: You can help 🙏 Learn more

 / 
Net-Prometheus-0.14
River stage one • 3 direct dependents • 3 total dependents
/ Net::Prometheus::Types

NAME

Net::Prometheus::Types - a collection of support structure types

SYNOPSIS


            

              
              
use Net::Prometheus::Types qw( Sample );
my $ob = Sample( variable => [], 123 );
print "The sample relates to a variable called ", $ob->varname;

DESCRIPTION

This package contains some simple support structures that assist with other parts of the Net::Prometheus distribution.

Each type is exported as a constructor function.

TYPES

Sample

This structure represents an individual value sample; associating a numerical value with a named variable and set of label values.


            

              
              
$sample = Sample( $varname, $labels, $value )

varname


            

              
              
$varname = $sample->varname

The string variable name. This is the basic name, undecorated by label values.

labels


            

              
              
$labels = $sample->labels

A reference to an even-sized ARRAY containing name/value pairs for the labels. Label values should be raw unescaped strings.

value


            

              
              
$sample->value

The numerical value observed.

MetricSamples

This structure represents all the samples made about a given metric, including metadata about the metric itself.


            

              
              
$samples = MetricSamples( $fullname, $type, $help, $samples )

fullname

A string giving the fullname of the metric.

type

A string, one of 'gauge', 'counter', 'summary' or 'histogram'.

help

A string containing the descriptive help message text.

samples

A reference to an ARRAY containing individual "Sample" instances.

AUTHOR

Paul Evans <leonerd@leonerd.org.uk>