Scroll to navigation

MUNIN-NODE.CONF(5) Munin MUNIN-NODE.CONF(5)

NAME

munin-node.conf - Configuration file for the munin node

DESCRIPTION

This is the configuration file for munin-node and munin-run.

The directives “host_name”, “paranoia” and “ignore_file” are munin node specific.

All other directives in munin-node.conf are passed through to the Perl module Net::Server. Depending on the version installed, you may have different settings available.

Line wrapping and comments work in the same manner as munin.conf.

DIRECTIVES

Native

The hostname used by munin-node to present itself to the munin master. Use this if the local node name differs from the name configured in the munin master.

Files to ignore when locating installed plugins. May be repeated.

If set to a true value, munin-node will only run plugins owned by root.

Inherited

These are the most common Net::Server options used in munin-node.

Ranges from 0-4. Specifies what level of error will be logged. “0” means no logigng, while “4” means very verbose. These levels correlate to syslog levels as defined by the following key/value pairs. 0=err, 1=warning, 2=notice, 3=info, 4=debug.

Default: 2


Where the munin node logs its activity. If the value is Sys::Syslog, logging is sent to syslog

Default: undef (STDERR)


The pid file of the process

Default: undef (none)


To run munin node in background set this to “1”. If you want munin-node to run as a foreground process, comment this line out and set “setsid” to “0”.

The user munin-node runs as

Default: root


The group munin-node runs as

Default: root


If set to “1”, the server forks after binding to release itself from the command line, and runs the POSIX::setsid() command to daemonize.

Default: undef


munin-node holds the connection to Munin master only a limited number of seconds to get the requested operation finished. If the time runs out the node will close the connection.

Timeout for the whole transaction. Units are in sec.

Default: 900 seconds (15 min)


This is the timeout for each plugin. If plugins take longer to run, this will disconnect the master.

Default: 60 seconds


A regular expression defining which hosts may connect to the munin node.

NOTE:

Use cidr_allow if available.



Allowed hosts given in CIDR notation (192.0.2.1/32). Replaces or complements “allow”. Requires the presence of Net::Server, but is not supported by old versions of this module.

Like cidr_allow, but used for denying host access

The IP address the munin node process listens on

Default: * (All interfaces)


The TCP port the munin node listens on

Default: 4949


EXAMPLE

A pretty normal configuration file:

#
# Example config-file for munin-node
#
log_level 4
log_file /var/log/munin-node/munin-node.log
pid_file /var/run/munin/munin-node.pid
background 1
setsid 1
user root
group root
# This is the timeout for the whole transaction.
# Units are in sec. Default is 15 min
#
# global_timeout 900
# This is the timeout for each plugin.
# Units are in sec. Default is 1 min
#
# timeout 60
# Regexps for files to ignore
ignore_file [\#~]$
ignore_file DEADJOE$
ignore_file \.bak$
ignore_file %$
ignore_file \.dpkg-(tmp|new|old|dist)$
ignore_file \.rpm(save|new)$
ignore_file \.pod$
# Set this if the client doesn't report the correct hostname when
# telnetting to localhost, port 4949
#
host_name localhost.localdomain
# A list of addresses that are allowed to connect.  This must be a
# regular expression, since Net::Server does not understand CIDR-style
# network notation unless the perl module Net::CIDR is installed.  You
# may repeat the allow line as many times as you'd like
allow ^127\.0\.0\.1$
allow ^::1$
# If you have installed the Net::CIDR perl module, you can use one or more
# cidr_allow and cidr_deny address/mask patterns.  A connecting client must
# match any cidr_allow, and not match any cidr_deny.  Note that a netmask
# *must* be provided, even if it's /32
#
# Example:
#
# cidr_allow 127.0.0.1/32
# cidr_allow 192.0.2.0/24
# cidr_deny  192.0.2.42/32
# Which address to bind to;
host *
# host 127.0.0.1
# And which port
port 4949


SEE ALSO

See munin for an overview over munin.

munin-node, munin-run

AUTHOR

The Munin project and its contributors

COPYRIGHT

2012-2022, The Munin project and its contributors

February 10, 2022 2.1