Munin contributed plugins

# -*- sh -*-

: <<=cut

=head1 NAME

quota2percent - Plugin to show disk usage in percent of quota hard limit.

=head1 APPLICABLE SYSTEMS

All systems with "bash", "quota", "repquota" and "munin"

=head1 CONFIGURATION

The following is the default configuration

  [quota2percent_*]

  user root

You could define two alert levels and the graph language

  [quota2percent_*]

  env.warning   [value]        (default: 90)

  env.critical  [value]        (default: 95)

  env.language  [en|de|es]     (default: en)   

=head1 DESCRIPTION

Wild card Plugin for monitoring the utilization of devices with quota rules. 

A graph is drawn for each user, which shows the usage as a percentage of his hard limit. System accounts (UID <1000) are suppressed. 

In addition, a graph is displayed which indicates the ratio device size to device coverage. 

The script repqutoa, usually part of the package quota, is needed. 

The plugin itself can be stored in any directory. For example, the device sdb1 shell be monitored, a symbolic link must be created

in the /etc/munin/plugins/ directory as follows: 

=over  

I<<<  ln -s /<path to file>/quota2percent_  quota2percent_sdb1 >>>

=back

=head1 MAGIC MARKERS

  #%# family=auto

  #%# capabilities=autoconf

=head1 VERSION

17.0131

=head1 HISTORY

V17.0131

  add    POD documentation

  add    env.language

  add    example graph for Munin Plugin Gallery

  remove German comments  

V17.0124

  first version, not munin rules conform

=head1 AUTHOR

Jo Hartmann

=head1 LICENSE

GPLv2 (L<http://www.gnu.org/licenses/gpl-2.0.html>)

=cut

###################################################

# Preparation section                             #

###################################################

# Load munin's shell libary

  . "$MUNIN_LIBDIR/plugins/plugin.sh"

# if any fetch from munin-node file

     Warning=${warning:-90}

     Critical=${critical:-95}

     Language=${language:-en}

# Ensure that the 'root' path is valid

  PATH="/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"

# Checking if repquota installed and on the path

  repquota -V &> /dev/null

  if ! repquota -V &> /dev/null ; then

     echo "The script 'repquota' is not installed or on the path"

     # Send the exit code FATAL ERROR happens

     exit 127

  fi

  Id=${0##*_}

###################################################

# Data reading sections                           #

###################################################

  readarray Quotas < <( repquota "/dev/$Id" | grep " -- " )

  readarray Totals < <( df "/dev/$Id" )

# Munin Configuration Section                     #

            echo graph_title  "Quota-Hard-Limit von $Id"

            echo graph_vlabel "Nutzung in % Hardlimit"

            echo graph_title  "Cuota de límite absoluto de $Id" 

            echo graph_vlabel "el % de uso del límite duro" 

            echo graph_title  "quota hard limit of $Id"

            echo graph_vlabel "Usage in %"

            Total_txt="all users"

       for((i=0; i<"$Users"; i++));do

         UserName=${Quota[0]}

         #Passwd=$(cat /etc/passwd | grep $UserName)

         Passwd=$(grep "$UserName" /etc/passwd)

         UserInfo=${Infos[4]}

         UserInfo=${UserInfo%%,*}

         UserName="$(clean_fieldname "$UserName")"

         UserInfo="$(clean_fieldname "$UserInfo")"

         [ ! -n "$UserInfo"  ] && UserInfo="$UserName"

         [ "$(id -u "${Quota[0]}")" -lt 1000 ] && echo "$UserName.graph no"

         echo "$UserName.label $UserInfo"

         echo "$UserName.warning  $Warning"

         echo "$UserName.critical $Critical"

     # configure the total line and send exit code NO ERROR happens

       echo total.label    "$Total_txt"

       echo total.warning  "$Warning"

       echo total.critical "$Critical"

       echo total.info     "$Total_info"

       exit 0

# Munin value section                             #

  for((i=0; i<"$Users"; i++));do

    UserName="$(clean_fieldname "${Quota[0]}")"

    echo "${Quota[2]} ${Quota[4]} $UserName.value" | awk '{printf "%s %.2f\n", $3 ,$1*100/$2}'

  echo "${Total[2]} ${Total[1]} total.value" | awk '{printf "%s %.2f\n", $3, $1*100/$2}'

# send the exit code NO ERROR happens

###################################################

# Script end                                      #

###################################################