Repository
Munin (contrib)
Last change
2020-08-08
Graph Categories
Family
auto
Capabilities
Keywords
Language
Bash
License
GPL-2.0-only
Authors

dm_cache_occupancy_

Name

dm_cache_occupancy_ - Wildcard-plugin to dm-cache occupancy.

Configuration

This plugin does not normally require configuration.

The plugin may need to run as root to determine dm-cache status. This is configured like this:

[dm_cache_*]
        user root

This is a wildcard plugin. To monitor a cached device-mapper volume, link volume to this file. For example,

ln -s /usr/share/munin/plugins/dm_cache_occupancy_ \
      /etc/munin/plugins/dm_cache_occupancy_vg_1122____lv_home

will monitor vg_1122-lv_home.

Please note that ____ (4 underscores) is replaced by - (dash) symbol. This is workaround for http://munin-monitoring.org/ticket/1236

Cached volumes found in dmsetup status can be monitored.

Author

Original idea: Steinar H. Gunderson sgunderson@bigfoot.com Found in Google by keywords “munin dm-cache”

Copyright (C) 2014 Vladimir Stackov amigo.elite@gmail.com

License

GPLv2

Magic Markers

#%# family=auto
#%# capabilities=autoconf suggest
#!/bin/bash
# -*- sh -*-

: << =cut

=head1 NAME

dm_cache_occupancy_ - Wildcard-plugin to dm-cache occupancy.

=head1 CONFIGURATION

This plugin does not normally require configuration.

The plugin may need to run as root to determine dm-cache status.
This is configured like this:

  [dm_cache_*]
	  user root

This is a wildcard plugin. To monitor a cached device-mapper volume,
link volume to this file. For example,

  ln -s /usr/share/munin/plugins/dm_cache_occupancy_ \
        /etc/munin/plugins/dm_cache_occupancy_vg_1122____lv_home

will monitor vg_1122-lv_home.

Please note that ____ (4 underscores) is replaced by - (dash) symbol.
This is workaround for http://munin-monitoring.org/ticket/1236

Cached volumes found in dmsetup status can be monitored.

=head1 AUTHOR

Original idea: Steinar H. Gunderson <sgunderson@bigfoot.com>
Found in Google by keywords "munin dm-cache"

Copyright (C) 2014 Vladimir Stackov <amigo.elite@gmail.com>

=head1 LICENSE

GPLv2

=head1 MAGIC MARKERS

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

=cut

CVOL=${0##*dm_cache_occupancy_}
#workaround for http://munin-monitoring.org/ticket/1236
while [[ $CVOL == *"____"* ]]
do
	CVOL=${CVOL/____/-}
done

case $1 in
	autoconf)
		env dmsetup status > /dev/null 2>&1
		if [[ $? -eq 0 ]]; then
			echo yes
			exit 0
		else
			echo "no (env dmsetup returned value > 0)"
			exit 0
		fi
		;;
	suggest)
		dmsetup status | grep ' cache ' | awk -F: '{print $1}'
		exit $?
		;;
	config)
		echo "graph_title $CVOL dm-cache cache occupancy"
		echo 'graph_args --base 1000'
		echo 'graph_vlabel blocks'
		echo 'graph_category disk'
		echo "graph_info This graph shows the dm-cache cache occupancy of the $CVOL cached volume."
		echo 'cache_used_metadata.label Used metadata'
		echo 'cache_used_metadata.info Used metadata blocks for cache'
		echo 'cache_total_metadata.label Total metadata'
		echo 'cache_total_metadata.info Total metadata blocks for cache'
		echo 'cache_used_blocks.label Used blocks'
		echo 'cache_used_blocks.info Used blocks in cache for cache'
		echo 'cache_total_blocks.label Total blocks'
		echo 'cache_total_blocks.info Total blocks in cache for cache'
		echo 'cache_dirty.label Dirty blocks'
		echo 'cache_dirty.info Dirty blocks for cache'

		exit 0
		;;
esac

dmstatus=$(dmsetup status $CVOL)

echo "cache_used_metadata.value $(echo $dmstatus | awk '{print $5}' | awk -F/ '{print $1}')"
echo "cache_total_metadata.value $(echo $dmstatus | awk '{print $5}' | awk -F/ '{print $2}')"
echo "cache_used_blocks.value $(echo $dmstatus | awk '{print $7}' | awk -F/ '{print $1}')"
echo "cache_total_blocks.value $(echo $dmstatus | awk '{print $7}' | awk -F/ '{print $2}')"
echo "cache_dirty.value $(echo $dmstatus | awk '{print $14}')"