Repository
Munin (2.0)
Last change
2018-08-17
Graph Categories
Family
manual
Capabilities
Keywords
Language
Bash
License
GPL-2.0-only

df_abs

Example graph: month

Name

df_abs - Plugin to monitor absolute disk usage

Configuration

The following configuration parameters are used by this plugin

[df_abs]
 env.exclude  - space separated list of file system types to exclude
 env.warning  - Warning percentage
 env.critical - Critical percentage
 env.total    - Enable/Disable graph total [on|off]

Default Configuration

[df_abs]
 env.exclude  iso9660
 env.warning  92
 env.critical 98
 env.total    on

Authors

Unknown author

License

GPLv2

Bugs

Does not handle cases where the block device is the same for multiple mounts.

Magic Markers

#%# family=manual
#%# capabilities=autoconf
#!@@BASH@@
# -*- sh -*-

: <<EOF

=head1 NAME

df_abs - Plugin to monitor absolute disk usage

=head1 CONFIGURATION

The following configuration parameters are used by this plugin

 [df_abs]
  env.exclude  - space separated list of file system types to exclude
  env.warning  - Warning percentage
  env.critical - Critical percentage
  env.total    - Enable/Disable graph total [on|off]

=head2 DEFAULT CONFIGURATION

 [df_abs]
  env.exclude  iso9660
  env.warning  92
  env.critical 98
  env.total    on

=head1 AUTHORS

Unknown author

=head1 LICENSE

GPLv2

=head1 BUGS

Does not handle cases where the block device is the same
for multiple mounts.

=head1 MAGIC MARKERS

 #%# family=manual
 #%# capabilities=autoconf

=cut

EOF

. "$MUNIN_LIBDIR/plugins/plugin.sh"

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

# Append $mnt in case $dev is not a real block device
get_fieldname() {
	local dev="$1"
	local mnt="$2"
	case "$dev" in
		/* )
			clean_fieldname "$dev"
			;;
		* )
			clean_fieldname "$dev $mnt"
			;;
	esac
}

total=${total:-on}

exclude=${exclude:-iso9660}
exclude=$(echo "$exclude" | sed -r -e 's/ +/ -x /g' -e 's/^/-x /')

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

	echo 'graph_title Filesystem usage (in bytes)'
	echo 'graph_args --base 1024 --lower-limit 0'
	echo 'graph_vlabel bytes'
	echo 'graph_category disk'
	if [ "$total" = "on" ]; then
		echo 'graph_total Total'
	fi
	# shellcheck disable=SC2086
	df -P -l $exclude | sed 1d | grep -v "//" |
	while read -r dev size used avail cap mnt; do
		name="$(get_fieldname "$dev" "$mnt")"
		echo "$name.label $mnt"
		echo "$name.cdef $name,1024,*"
		warn=$(get_warning "$name")
		crit=$(get_critical "$name")
		if [ -n "$warn" ]; then
			echo "$name.warning $((size * warn / 100))"
		fi
		if [ -n "$crit" ]; then
			echo "$name.critical $((size * crit / 100))"
		fi
	done
	exit 0
fi

# shellcheck disable=SC2034,SC2086
df -P -l $exclude | sed 1d | grep -v "//" |
	while read -r dev size used avail cap mnt; do
		echo "$(get_fieldname "$dev" "$mnt").value $used"
	done