2
0
mirror of https://github.com/munin-monitoring/contrib.git synced 2018-11-08 00:59:34 +01:00
contrib-munin/plugins/solaris/io_disk
Lars Kruse c81c20ab3b unify DIRTYCONFIG handling in shell and python plugins
The following issues were fixed:
* comparison too broad (e.g. "0" misinterpreted as "true")
* python: comparing string with number (is never equal in python)
* unwanted non-zero exitcode (compound command "&&" as last command in
  shell code block (e.g. "case" or "if" branch))
* access to unset variable (shell style issue)
2018-04-07 02:17:06 +02:00

345 lines
8.6 KiB
Bash
Executable File

#!/bin/bash
: << =cut
=head1 NAME
io_disk - Multigraph plugin to monitor disks for Solaris.
These functions are implemented:
ops : similar to iostat r/s, w/s
bytes : similar to iostat kr/s, kw/s
busy : similar to iostat %b, %w (%w usually indicates 0 in Sol10,11)
queue : similar to iostat actv, wait
latency : similar to iostat asvc_t, wsvc_t
size : average io size
This plugin is improved from Solaris io_busy_, io_ops_, io_bytes_ plugins.
Any device found in /usr/bin/kstat can be monitored.
Tested with Solaris 10 and 11, and it should work with Solaris 8, 9.
=head1 CONFIGURATION
Make symlink:
cd /path/to/munin/etc/plugins
ln -s /path/to/munin/lib/plugins/io_disk .
The RRD files generated by io_busy_, io_ops_, io_bytes_ can be taken over
by this plugin.
Thus, please remove symlinks of those plugins before using this plugin.
By default, this plugin monitors disk devices. And also it can monitor
NFS and Tape devices as much as io_* plugins with setting environments.
Note that instance names of nfs (e.g. nfs1) can be changed after reboot or
remount, this plugin may not monitor nfs properly. (same as original ones)
=head1 ENVIRONMENT VARIABLES
env.class - kstat class. See man kstat -c option.
example: env.class /disk|nfs|tape/
default: disk
env.module - Module name. Only used in internal graph name.
example: env.module something
default: sd
If you would not like to take over RRDs generated by io_*_sd plugins,
please change it to another name.
And also, if you would like to take over RRDs of nfs, tape devices,
please set it 'nfs' or 'tape' (and set env.class, env.module_regex).
It may be good to link like ln -s /path/to/io_disk io_nfs if necessary.
env.module_regex - kstat module. See man kstat -m option.
example: env.module_regex /^(s?sd|vdc|zvblk|dad|md|nfs|st)$/
default: /^(s?sd|vdc|zvblk|dad|md)$/
env.title_type - Device type shown in graph title.
example: env.title_type Disk Device, NFS, Tape
default: Disk Device
env.exclude - Device instance name(s) to exclude seperated by white-space.
example: env.exclude sd0 ssd1
default: none
env.graph_width - Graph width in pixel
example: env.graph_width 450
default: none (usually 400)
=head1 AUTHOR
Unknown Author
Improved by K.Cima https://github.com/shakemid
=head1 LICENSE
GPLv2
=head1 MAGIC MARKERS
#%# family=auto
#%# capabilities=autoconf
=cut
# Include plugin.sh
. "${MUNIN_LIBDIR:-}/plugins/plugin.sh"
is_multigraph "$@"
# Shell options
set -o nounset # Like perl use strict;
# Set environment variables
plugin_name=io
functions='ops bytes busy queue latency size'
: "${class:=disk}"
: "${module:=sd}"
: "${module_regex:=/^(s?sd|vdc|zvblk|dad|md)\$/}"
: "${title_type:=Disk Device}"
: "${exclude:=}"
: "${graph_width:=}"
# Create map of instance name (e.g. sd0) and logical device name (e.g. c0t0d0)
# Example:
# name_sd1=c0t0d0
# name_ssd2=c0tAB_1234d0 (shorten long target)
# ...
instance_names=$( iostat -x | sed -e '1,2d' | awk '{print $1}' \
| sed -e 's/^/name_/' )
logical_device_names=$( iostat -xn | sed -e '1,2d' | awk '{print $NF}' \
| sed -e 's/^\(c[0-9]*\)\(t.\{2\}\).*\(.\{4\}\)\(d[0-9]*\)$/\1\2_\3\4/' )
declare $( paste -d= <( echo "$instance_names" ) <( echo "$logical_device_names" ) )
# Functions
preconfig() {
local func
func=$1
case "$func" in
ops)
conf_title='I/O Operations'
conf_gargs='--base 1000'
conf_vlabel='Ops per second write (-) / read (+)'
conf_in=reads
conf_out=writes
;;
bytes)
conf_title='I/O Throughput'
conf_gargs='--base 1024'
conf_vlabel='Bytes per second write (-) / read (+)'
conf_in=nread
conf_out=nwritten
;;
busy)
conf_title='Busy & Wait'
conf_gargs='--base 1000 --lower-limit 0 --upper-limit 100'
conf_vlabel='% wait (-) / busy (+)'
conf_in=rtime
conf_out=wtime
;;
queue)
conf_title='Queue Length'
conf_gargs='--base 1000'
conf_vlabel='Queue length wait (-) / actv (+)'
conf_in=rlentime
conf_out=wlentime
;;
latency)
conf_title='Latency'
conf_gargs='--base 1000'
conf_vlabel='Seconds wsvc_t (-) / asvc_t (+)'
conf_in=rlentime
conf_out=wlentime
;;
size)
conf_title='I/O Size'
conf_gargs='--base 1024'
conf_vlabel='Average size write (-) / read (+)'
conf_in=nread
conf_out=nwritten
;;
*)
echo "Unknown function: $func"
exit 1
;;
esac
}
is_excluded() {
local arg i
arg=$1
for i in ${exclude}
do
if [ "$arg" = "$i" ]; then
return 0
fi
done
return 1
}
do_config() {
local func dev ref devname stat
func=$1
preconfig "$func"
echo "multigraph ${plugin_name}_${func}_${module}"
echo "graph_title $title_type $conf_title"
echo 'graph_category disk'
echo "graph_args $conf_gargs"
echo "graph_vlabel $conf_vlabel"
if [ -n "$graph_width" ]; then
echo "graph_width $graph_width"
fi
# Get device instance names by kstat
kstat -p -c "$class" -m "$module_regex" -s "/^${conf_in}\$/" \
| sed 's/:/ /g' | awk '{ print $3 }' \
| while read -r dev
do
is_excluded "$dev" && continue
# Replace instance name to logical device name if exists
ref="name_$dev"
devname=${!ref:-} # ${!varname} means indirect evaluation (similar to eval)
# reads and writes are necessary to calculate latency, size
case "$func" in
latency|size)
for stat in reads writes
do
echo "${dev}_${stat}.label dummy"
echo "${dev}_${stat}.graph no"
echo "${dev}_${stat}.type DERIVE"
echo "${dev}_${stat}.min 0"
done
;;
esac
# Set CDEF
case "$func" in
busy)
conf_in_cdef="${dev}_${conf_in},100,*"
conf_out_cdef="${dev}_${conf_out},100,*"
;;
latency)
# rlentime / ( reads + writes )
conf_in_cdef="${dev}_${conf_in},${dev}_reads,${dev}_writes,+,/"
conf_out_cdef="${dev}_${conf_out},${dev}_reads,${dev}_writes,+,/"
;;
size)
conf_in_cdef="${dev}_${conf_in},${dev}_reads,/"
conf_out_cdef="${dev}_${conf_out},${dev}_writes,/"
;;
*)
conf_in_cdef=
conf_out_cdef=
;;
esac
# Print data attributes
echo "${dev}_${conf_out}.label dummy"
echo "${dev}_${conf_out}.graph no"
echo "${dev}_${conf_out}.type DERIVE"
echo "${dev}_${conf_out}.min 0"
if [ -n "$conf_out_cdef" ]; then
echo "${dev}_${conf_out}.cdef ${conf_out_cdef}"
fi
echo "${dev}_${conf_in}.label ${devname:-${dev}}"
echo "${dev}_${conf_in}.negative ${dev}_${conf_out}"
echo "${dev}_${conf_in}.type DERIVE"
echo "${dev}_${conf_in}.min 0"
if [ -n "$conf_in_cdef" ]; then
echo "${dev}_${conf_in}.cdef ${conf_in_cdef}"
fi
done
echo
}
do_fetch() {
local func stat_regex dev stat value
func=$1
preconfig "$func"
echo "multigraph ${plugin_name}_${func}_${module}"
case "$func" in
latency|size)
stat_regex="/^($conf_in|$conf_out|reads|writes)\$/"
;;
*)
stat_regex="/^($conf_in|$conf_out)\$/"
;;
esac
# Get device instance names, stat names and values by kstat
# kstat output example:
# $ kstat -p -c disk -m '/^sd$/' -s '/^reads$/'
# sd:0:sd0:reads 51432610
# sd:1:sd1:reads 52671435
# ...
kstat -p -c "$class" -m "$module_regex" -s "$stat_regex" \
| sed 's/:/ /g' | awk '{ print $3,$4,$5 }' \
| while read -r dev stat value
do
is_excluded "$dev" && continue
echo "${dev}_${stat}.value ${value%.*}"
done
echo
}
autoconf() {
if [ -x /usr/bin/kstat ]; then
echo yes
exit 0
else
echo "no (/usr/bin/kstat not found)"
exit 0
fi
}
config() {
local func
for func in $functions
do
do_config "$func"
done
}
fetch() {
local func
for func in $functions
do
do_fetch "$func"
done
}
# Main
case ${1:-} in
autoconf)
autoconf
;;
config)
config
if [ "${MUNIN_CAP_DIRTYCONFIG:-0}" = "1" ]; then fetch; fi
;;
*)
fetch
;;
esac
exit 0