mirror of
https://github.com/munin-monitoring/contrib.git
synced 2025-07-21 18:41:03 +00:00
58 lines
1.3 KiB
Text
58 lines
1.3 KiB
Text
=head1 NAME
|
|
|
|
munin2snmp - SNMP Agent to query munin-node over snmp
|
|
|
|
=head1 REQUIREMENTS
|
|
|
|
Net::SNMP and IO::Socket perl modules, munin-node with some plugins
|
|
|
|
=head2 Example configuration
|
|
|
|
/etc/snmp/snmpd.conf
|
|
|
|
master agentx
|
|
agentAddress udp:127.0.0.1:161
|
|
rocommunity public 127.0.0.1
|
|
|
|
On a newer system it is enough to define "master" option only
|
|
|
|
MUNIN-MIB should be installed on the client,
|
|
it goes to /usr/local/share/snmp/mibs or /usr/share/munin/mibs
|
|
or another place where snmpd expects to find the MIB files.
|
|
|
|
See also http://www.net-snmp.org/wiki/index.php/FAQ:MIBs_03
|
|
|
|
|
|
=head2 Usage
|
|
|
|
After setting up snmpd, start the agent:
|
|
|
|
./munin2snmp.pl
|
|
|
|
Now one can query the agent
|
|
|
|
snmpwalk -v 2c -mMUNIN-MIB -c public localhost .1.3.6.1.4.1.123456.100.1.1
|
|
|
|
where "1.3.6.1.4.1.123456.100.1.1" is example OID selected as the base
|
|
tree for the agent.
|
|
|
|
You might need to change the host, port, oidbase and munin_plugins you want to use.
|
|
|
|
The defaults:
|
|
|
|
$Munin{PORT} = '4949';
|
|
$Munin{HOST} = 'localhost'
|
|
$oidbase = ".1.3.6.1.4.1.123456.100.1.1"
|
|
@munin_plugins = qw ( load swap users uptime vmstat df );
|
|
|
|
=head1 ACKNOWLEDGEMENTS
|
|
|
|
Heavily inspired by
|
|
Vincent Bernat: https://github.com/vincentbernat/extend-netsnmp
|
|
and Masahito Zembutsu: https://github.com/zembutsu/muninwalk
|
|
|
|
=head1 LICENSE
|
|
|
|
GPLv2
|
|
|
|
|