Munin contributed plugins

#!/bin/bash

: << =cut

=head1 NAME

  interrupts - Munin plugin to monitor Solaris cpu interrupts and context switches

=head1 CONFIGURATION

  Make symlink:

    cd /path/to/munin/etc/plugins

    ln -s /path/to/munin/lib/plugins/interrupts .

=head1 AUTHOR

  K.Cima https://github.com/shakemid

=head1 LICENSE

  GPLv2

=head1 Magic markers

  #%# family=contrib

  #%# capabilities=autoconf

=cut

# Include plugin.sh

. "${MUNIN_LIBDIR:-}/plugins/plugin.sh"

# Shell options

set -o nounset  # Like perl use strict;

# Graph settings

global_attr="

    graph_title Interrupts and context switches

    graph_category system

    graph_args --base 1000 --lower-limit 0 --rigid

    graph_vlabel count per second

    graph_info Interrupts and context switches

    rw_wrfails.graph no

    rw_rdfails.cdef rw_rdfails,rw_wrfails,+

"

# data_attr format: field type draw label

#   label can contain white-spaces.

data_attr="

    intr           DERIVE LINE interrupts

    intrthread     DERIVE LINE interrupts as threads

    pswitch        DERIVE LINE context switches

    inv_swtch      DERIVE LINE involuntary context switches

    cpumigrate     DERIVE LINE thread migrations

    xcalls         DERIVE LINE inter-processor cross-calls

    mutex_adenters DERIVE LINE spins on mutexes

    rw_rdfails     DERIVE LINE spins on r/w locks

    rw_wrfails     DERIVE LINE dummy

    syscall        DERIVE LINE system calls

    trap           DERIVE LINE traps

"

# They can be shown by vmstat -s or mpstat

# Functions

autoconf() {

    if which kstat >/dev/null ; then

        echo yes

    else

        echo "no (failed to find executable 'kstat')"

    fi

}

config() {

    local label_max_length=45

    # print global attributes

    echo "$global_attr" | sed -e 's/^  *//' -e '/^$/d'

    # print data source attributes

    # split line into field,type,draw,label

    local field type draw label

    echo "$data_attr" | while read -r field type draw label

    do

        [ -z "$field" ] && continue

        echo "${field}.type ${type}"

        echo "${field}.draw ${draw}"

        echo "${field}.label ${label:0:${label_max_length}}"

        if [ "${type}" = DERIVE ]; then

            echo "${field}.min 0"

        fi

    done

}

fetch() {

    local field type draw label

    echo "$data_attr" | while read -r field type draw label

    do

        [ -z "$field" ] && continue

        # kstat output example:

        #   $ kstat -p cpu::sys:intr

        #   cpu:0:sys:intr  5728473528

        #   cpu:1:sys:intr  1060016014

        #   cpu:2:sys:intr  1297441213

        #   ...

        value=$( kstat -p "cpu::sys:${field}" | awk '{ sum += $2 } END { print sum }' )

        echo "${field}.value ${value}"

    done

}

# Main

case ${1:-} in

autoconf)

    autoconf

    ;;

config)

    config

    if [ "${MUNIN_CAP_DIRTYCONFIG:-0}" = "1" ]; then fetch; fi

    ;;

*)

    fetch

    ;;

esac

exit 0