NAME

multi_snmp_querier - Munin plugin to query several SNMP hosts

SYNOPSIS

This plugin is meant to be called from Munin. You should at least set the 'hosts' environment variable from Munin's configuration (i.e. /etc/munin/munin.conf) to specify which hosts and how to query.

DESCRIPTION

 This plugin expects to receive the following environment variables:
snmp_oid

Which SNMP OID should we query on; it defaults to 1.3.6.1.2.1.43.10.2.1.4.1.1 (total printed pages - of course, it only makes sense to query a printer on this ;-) ).

Other known and useful OIDs for printers are 1.3.6.1.2.1.43.11.1.1.9.1.1 (total number of pages printed with this toner cartridge), 1.3.6.1.2.1.43.11.1.1.9.1.1 (total projected capacity of this toner cartridge - Note that for many makers, the literal '-2' is returning, meaning more or less "I don't know"), You might also be interested in 1.3.6.1.2.1.43.11.1.1.6.1.1 (toner type this printer uses), although as it is a constant string and not indicative of any kind of value, there's no use in putting it into Munin (at least, not via this plugin).

Appropriate labels will be given when Munin requests for configuration on the above mentioned OIDs - Of course, other OIDs will get far more generic labels.

hosts (REQUIRED!)

Comma-separated list of hosts to send SNMP queries to. You can specify SNMP port and community to each of the hosts by listing them as community@host:port - Community defaults to public, port defaults to 161. The following is a valid hosts declaration:

    hosts='192.168.0.15, 192.168.0.18:162, private@192.168.0.20'

It will query host 192.168.0.15 on port 161 with the 'private' community, host 192.168.0.18 on port 162 with the 'private' community and host 192.168.0.20 on port 161 with the 'public' community.

DEPENDS ON

Net::Ping, Net::SNMP

SEE ALSO

munin, munin-node

TO DO

Add a mechanism to specify the labels for unknown OIDs

AUTHOR

Gunnar Wolf <gwolf@gwolf.org>

COPYRIGHT

Copyright 2008 Gunnar Wolf, Instituto de Investigaciones Economicas, UNAM. This plugin 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, or any later version (at your choice).

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., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.