NAME

df - Munin plugin to monitor disk usage

APPLICABLE SYSTEMS

Every Linux system with df installed.

CONFIGURATION

The plugin excludes per default the following special, read-only or dynamically allocating file systems from graphing:

  none unknown rootfs iso9660 squashfs udf romfs ramfs debugfs cgroup_root

To change this set the environment variable "exclude" with a list of space separated fs types. The environment variables "warning" and "critical" sets the percentage from which Munin starts to warn about the disk usage.

This configuration snipplet is an example with the defaults:

  [df]
    env.exclude none unknown rootfs iso9660 squashfs udf romfs ramfs debugfs cgroup_root devtmpfs
    env.warning 92
    env.critical 98

Put it in a file in @@CONFDIR@@/plugin-conf.d/ and restart the munin-node.

You may specify filesystem specific warning and critical levels:

    env._dev_sda2_warning 98
    env._dev_sda2_critical 99

Devices can be explicitly included or excluded based on their mountpoint or device name using the include_re and exclude_re environment variables. These environment variables are parsed as whitespace separated regular expressions. For example, if you wish to ignore the filesystem on /dev/sda2 and all filesystems mounted under /var except /var/tmp, these rules would achieve this:

    env.include_re ^/var/tmp$
    env.exclude_re /dev/sda2 ^/var/

Please note that these expressions are tried against both mountpoints and device names, therefore broad matches could potentially filter out desired devices. Anchoring is also useful for avoiding false positives (as seen in the example), but not strictly necessary. Testing with munin-run is always a good idea.

Also note that a mountpoint that is excluded by filesystem type but included by RE will not be included.

USAGE

Link this plugin to @@CONFDIR@@/plugins/ and restart the munin-node.

MAGIC MARKERS

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

BUGS

Uses device names instead of mount points to identify mounted filesystems.

VERSION

  $Id$

AUTHOR

Ingvar Hagelund

LICENSE

GPLv2