munin-node(8) - Linux man page

Name

munin-node - A daemon to gather information in cooperation with the main Munin program

Synopsis

munin-node [--options]

Options

--config <configfile>

Use <file> as configuration file. [/etc/munin/munin-node.conf]

--[no]paranoia

Only run plugins owned by root. Check permissions as well. [--noparanoia]

--help

View this help message.

--debug

View debug messages.

Description

Munin's node is a daemon that Munin connects to fetch data. This data is stored in .rrd-files, and later graphed and htmlified. It's designed to let it be very easy to graph new datasources.

Munin-node is a small perlscript listening to port 4949 using Net::Server. It reads all the plugins in /etc/munin/plugins/ on startup. The node accepts the following commands:

list [node]

list available plugins for host. If no hostname is specified, list plugins on host running munin-node

nodes

List nodes that has plugins in this munin-node.

config <plugin>

output plugin configuration

fetch <plugin>

output plugin values

version

Print versionstring

quit

disconnect

Plugins

These plugins can be in you language of choice: bash, perl, python, C. The plugins can be run in two modes: with and without the "config"-parameter. When run with "config" as parameter, the plugin should output the configuration of the graph. When run without parameters, the plugin should output just values

# /etc/munin/plugins/load config
host_name
graph_title Load average
graph_args --base 1000 -l 0
graph_vlabel load
load.label load
load.draw LINE2
load.warning 10
load.critical 120

# /etc/munin/plugins/load
load.value 0.43

For more information, see the documentation section at <http://munin.sf.net/>.

Files

/etc/munin/munin-node.conf
/etc/munin/plugins/*
/etc/munin/plugin-conf.d/*
/var/run/munin/munin-node.pid
/var/log/munin/munin-node

Version

This is munin-node v1.2.5

Authors

Audun Ytterdal, Jimmy Olsen, and Tore Anderson.

Bugs

munin-node does, as of now, not check the syntax of the configuration file.

Please report other bugs in the bug tracker at <http://munin.sf.net/>.

Copyright

Copyright © 2002 Audun Ytterdal, Jimmy Olsen, and Tore Anderson / Linpro AS .

This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE .

This program is released under the GNU General Public License