NAME

quota2percent_

Example Graph

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

APPLICABLE SYSTEMS

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

Systems with multiple users and individual storage space limitations administered via 'quota'

CONFIGURATION

The following is the default configuration

  [quota2percent_*]
  user root

You could define two alert levels, the graph language, min. human UID and dealing with system users

  [quota2percent_*]
  env.warning   [value]        (default: 90)
  env.critical  [value]        (default: 95)
  env.language  [en|de|es]     (default: en)
  env.humanuid  [value]        (default: 1000, only need if there is an other value define for UID_MIN in /etc/login.defs)
  env.low_uid   [never|no|yes] (default: never)
                                set to no for producing rrd files for system user, but don't show those graphs (e.g. for later analyses)
                                if set to yes system user graphs are drawn  

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:

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

MAGIC MARKERS

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

VERSION

17.0214

HISTORY

V17.0214

  fix    hard reading logic operation for skipping by Low_UID=never
  fix    some slips
  fix    some nitpicking details

  add    env.low_uid
  add    env.humanid
  add    env.language
  add    check if device exist
  add    if no limitations administered via 'quota' for the device the total line is shown only
  add    a few comments
  add    POD documentation
  add    example graph for Munin Plugin Gallery

  remove setting a PATH
  remove German comments  

V17.0124

  not pubish, first version

AUTHOR

Jo Hartmann

LICENSE

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