munin-node(8) · carta

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.6

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

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