contrib-munin/plugins/mpd/mpdstats_

#!/bin/sh

# vim: set ft=sh :
# -*- sh -*-

: << =cut

=head1 NAME

mpdstats_ - Munin plugin to monitor a MPD database

=head1 DEPENDENCIES

This plugin uses netcat(1) to communicate with the MPD daemon.

Tip: To see if it is already set up correctly, just run this plugin
with the parameter "autoconf". If you get a "yes", everything should
work like a charm already.

=head1 INSTALLATION

This wildcard plugin should be symlinked using one of these names:
mpdstats_artists, mpdstats_albums, mpdstats_songs

=head1 CONFIGURATION

No configuration should be required if run on the same server as
MPD. If the plugin is run from remote or in a non-default configuration,
please use the environment variables 'mpd_host' and 'mpd_port' to connect.

Also, if your netcat(1) binary is anywhere else than /bin/nc please define
it using the 'netcat' environment variable.

=head2 CONFIGURATION EXAMPLE

 [mpd_*]
  env.mpd_host 192.168.0.43
  env.mpd_port 6606
  env.netcat /usr/local/bin/nc

=head1 AUTHOR

Copyright (C) 2012 ToM <tom@leloop.org>

=head1 LICENSE

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; version 2 dated June,
1991.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

=head1 MAGIC MARKERS

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

=cut



MPDHOST=${mpd_host:-localhost}
MPDPORT=${mpd_port:-6600}
NCBIN=${netcat:-/bin/nc}

#
# FUNCTIONS
#

do_autoconf () {
    case "$ACTION" in
        albums|artists|songs)
            ;;
        *)
            echo "no (not a valid symlink name, please read the plugin doc)"
            exit 1
            ;;
    esac

    if [ ! -x $NCBIN ] ; then
        echo "no ($NCBIN: not found or not executable)"
        exit 1
    fi

    echo version | $NCBIN -q 2 $MPDHOST $MPDPORT 1>/dev/null 2>&1
    if [ "$?" != 0 ] ; then
        echo "no (connection failed)"
        exit 1
    fi

    echo "yes"
    exit 0
}

#
# MAIN
#

SCRIPTNAME=${0##*/}
ACTION=${SCRIPTNAME##*_}

case "$1" in
    autoconf)
        do_autoconf
        ;;
    suggest)
        echo "$ACTION"
        exit 0
        ;;
    config)
        echo "graph_category MPD
graph_title $ACTION in the database
graph_info Number of $ACTION in the database.
graph_vlabel $ACTION in the db
graph_args --base 1000 -l 0
graph_scale no
$ACTION.type GAUGE
$ACTION.draw LINE2
$ACTION.label $ACTION"
        exit 0
        ;;
    *)
        printf "$ACTION.value "
        echo stats | $NCBIN -q 2 $MPDHOST $MPDPORT | awk " /^${ACTION}/ {print \$2}"
        ;;
esac