MUNIN-NODE

Section: Munin Documentation (8) Updated: 2009-11-07 Local index Up

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