dhcp_leases

#!/bin/sh
# -*- sh -*-

: << =cut

=head1 NAME

dhcp_leases - Plugin to monitor the number of active dhcp leases 

=head1 CONFIGURATION

The following environment variables are used by this plugin:

=over 4

=item leases_warning <int>

Threshold for when to report a warning

=item leases_critical <int>

Threshold for when to report a critical

=back

=head2 EXAMPLE CONFIGURATION

 [load]
  env.leases_warning 400
  env.leases_critical 500

=head1 NOTES

If run with the "autoconf"-parameter, give our opinion on whether we
should be run on this system or not. This is optional, and only used
by munin-config. In the case of this plugin, we should most probably
always be included.

=head1 MAGIC MARKERS

 #%# family=auto
 #%# capabilities=autoconf

=cut

. $MUNIN_LIBDIR/plugins/plugin.sh

if [ "$1" = "autoconf" ]; then
        echo yes
        exit 0
fi

# If run with the "config"-parameter, give out information on how the
# graphs should look.

if [ "$1" = "config" ]; then

        # The host name this plugin is for. (Can be overridden to have
        # one machine answer for several)

        # The title of the graph
        echo 'graph_title Active DHCP Leases'
        # Arguments to "rrdtool graph". In this case, tell it that the
        # lower limit of the graph is '0', and that 1k=1000 (not 1024)
        echo 'graph_args --base 1000 -l 0'
        # The Y-axis label
        echo 'graph_vlabel leases'
        # We want Cur/Min/Avg/Max unscaled (i.e. 0.42 load instead of
        # 420 milliload)
        echo 'graph_scale no'
        # Graph category. Defaults to 'other'
        echo 'graph_category network'
        # The fields. "label" is used in the legend. "label" is the only
        # required subfield.
        echo 'dhcp_leases.label leases'
        # These two read the environment for warning values for the field
        # "load".  If "load_warning" or "warning" aren't set in the
        # environment, no warning levels are set.  Likewise for "load_critical"
        # and "critical".
        print_warning leases
        print_critical leases
        # This one is purely to add an explanation to the web page. The first
        # one is for the graph itself, while the second one is for the field
        # "load".
        echo 'graph_info This graph shows the curretly active leases'
        echo 'dhcp_leases.info currently active leases'

        # Last, if run with the "config"-parameter, quit here (don't
        # display any data)
        exit 0
fi

# If not run with any parameters at all (or only unknown ones), do the
# real work - i.e. display the data. Almost always this will be
# "value" subfield for every data field.

echo -n "dhcp_leases.value "
python /usr/local/bin/dhcp-leases.py | grep "Total Active Leases" | cut -f2 -d":"|sed -e's/ //g'