.\" Automatically generated by Pod::Man 4.09 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.if !\nF .nr F 0
.if \nF>0 \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    if !\nF==2 \{\
.        nr % 0
.        nr F 2
.    \}
.\}
.\" ========================================================================
.\"
.IX Title "Monitoring::Plugin::Performance 3pm"
.TH Monitoring::Plugin::Performance 3pm "2018-07-26" "perl v5.26.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
Monitoring::Plugin::Performance \- class for handling Monitoring::Plugin
performance data.
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
\&  use Monitoring::Plugin::Performance use_die => 1;
\&
\&  # Constructor (also accepts a \*(Aqthreshold\*(Aq obj instead of warning/critical)
\&  $p = Monitoring::Plugin::Performance\->new(
\&      label     => \*(Aqsize\*(Aq,
\&      value     => $value,
\&      uom       => "kB",
\&      warning   => $warning,
\&      critical  => $critical,
\&      min       => $min,
\&      max       => $max,
\&  );
\&
\&  # Parser
\&  @perf = Monitoring::Plugin::Performance\->parse_perfstring(
\&      "/=382MB;15264;15269;; /var=218MB;9443;9448"
\&  )
\&  or warn("Failed to parse perfstring");
\&
\&  # Accessors
\&  for $p (@perf) {
\&    printf "label:    %s\en",   $p\->label;
\&    printf "value:    %s\en",   $p\->value;
\&    printf "uom:      %s\en",   $p\->uom;
\&    printf "warning:  %s\en",   $p\->warning;
\&    printf "critical: %s\en",   $p\->critical;
\&    printf "min:      %s\en",   $p\->min;
\&    printf "max:      %s\en",   $p\->max;
\&    # Special accessor returning a threshold obj containing warning/critical
\&    $threshold = $p\->threshold;
\&  }
\&
\&  # Perfdata output format i.e. label=value[uom];[warn];[crit];[min];[max]
\&  print $p\->perfoutput;
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
Monitoring::Plugin class for handling performance data. This is a public
interface because it could be used by performance graphing routines,
such as nagiostat (http://nagiostat.sourceforge.net), perfparse
(http://perfparse.sourceforge.net), nagiosgraph
(http://nagiosgraph.sourceforge.net) or NagiosGrapher
(http://www.nagiosexchange.org/NagiosGrapher.84.0.html).
.PP
Monitoring::Plugin::Performance offers both a parsing interface (via
parse_perfstring), for turning nagios performance output strings into
their components, and a composition interface (via new), for turning
components into perfdata strings.
.SH "USE'ING THE MODULE"
.IX Header "USE'ING THE MODULE"
If you are using this module for the purposes of parsing perf data, you
will probably want to set use_die => 1 at use time. This forces
&Monitoring::Plugin::Functions::plugin_exit to call \fIdie()\fR \- rather than \fIexit()\fR \-
when an error occurs. This is then trappable by an eval. If you don't set use_die,
then an error in these modules will cause your script to exit
.SH "CLASS METHODS"
.IX Header "CLASS METHODS"
.IP "Monitoring::Plugin::Performance\->new(%attributes)" 4
.IX Item "Monitoring::Plugin::Performance->new(%attributes)"
Instantiates a new Monitoring::Plugin::Performance object with the given
attributes.
.IP "Monitoring::Plugin::Performance\->parse_perfstring($string)" 4
.IX Item "Monitoring::Plugin::Performance->parse_perfstring($string)"
Returns an array of Monitoring::Plugin::Performance objects based on the string
entered. If there is an error parsing the string \- which may consists of several
sets of data \-  will return an array with all the successfully parsed sets.
.Sp
If values are input with commas instead of periods, due to different locale settings,
then it will still be parsed, but the commas will be converted to periods.
.SH "OBJECT METHODS (ACCESSORS)"
.IX Header "OBJECT METHODS (ACCESSORS)"
.IP "label, value, uom, warning, critical, min, max" 4
.IX Item "label, value, uom, warning, critical, min, max"
These all return scalars. min and max are not well supported yet.
.IP "threshold" 4
.IX Item "threshold"
Returns a Monitoring::Plugin::Threshold object holding the warning and critical
ranges for this performance data (if any).
.IP "rrdlabel" 4
.IX Item "rrdlabel"
Returns a string based on 'label' that is suitable for use as dataset name of
an \s-1RRD\s0 i.e. munges label to be 1\-19 characters long with only characters
[a\-zA\-Z0\-9_].
.Sp
This calls \f(CW$self\fR\->clean_label and then truncates to 19 characters.
.Sp
There is no guarantee that multiple N:P:Performance objects will have unique
rrdlabels.
.IP "clean_label" 4
.IX Item "clean_label"
Returns a \*(L"clean\*(R" label for use as a dataset name in \s-1RRD,\s0 ie, it converts
characters that are not [a\-zA\-Z0\-9_] to _.
.Sp
It also converts \*(L"/\*(R" to \*(L"root\*(R" and \*(L"/{name}\*(R" to \*(L"{name}\*(R".
.IP "perfoutput" 4
.IX Item "perfoutput"
Outputs the data in Monitoring::Plugin perfdata format i.e.
label=value[uom];[warn];[crit];[min];[max].
.SH "SEE ALSO"
.IX Header "SEE ALSO"
Monitoring::Plugin, Monitoring::Plugin::Threshold, https://www.monitoring\-plugins.org/doc/guidelines.html
.SH "AUTHOR"
.IX Header "AUTHOR"
This code is maintained by the Monitoring Plugin Development Team: see
https://monitoring\-plugins.org
.SH "COPYRIGHT AND LICENSE"
.IX Header "COPYRIGHT AND LICENSE"
Copyright (C) 2014      by Monitoring Plugin Team
Copyright (C) 2006\-2014 by Nagios Plugin Development Team
.PP
This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself.