munin-node.conf¶
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.
DIRECTIVES¶
Native¶
- host_name¶
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.
- ignore_file¶
Files to ignore when locating installed plugins. May be repeated.
- paranoia¶
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.
- log_level¶
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
- log_file¶
Where the munin node logs its activity. If the value is Sys::Syslog, logging is sent to syslog
Default: undef (STDERR)
- port¶
The TCP port the munin node listens on
Default: 4949
- pid_file¶
The pid file of the process
Default: undef (none)
- background¶
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”.
- host¶
The IP address the munin node process listens on
Default: * (All interfaces)
- user¶
The user munin-node runs as
Default: root
- group¶
The group munin-node runs as
Default: root
- setsid¶
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
- ignore_file¶
Files to ignore when locating installed plugins. May be repeated.
- host_name¶
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.
- allow¶
A regular expression defining which hosts may connect to the munin node.
Note
Use cidr_allow if available.
- cidr_allow¶
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.
- cidr_deny¶
Like cidr_allow, but used for denying host access
- timeout¶
Number of seconds after the last activity by the master until the node will close the connection.
If plugins take longer to run, this may disconnect the master.
Default: 20 seconds
EXAMPLE¶
A pretty normal configuration file:
host *
port 4949
cidr_allow 127.0.0.0/8
cidr_allow 192.0.2.0/24
user root
group root
background 1
setsid 1
log_level 4
log_file /var/log/munin/munin-node.log
pid_file /var/run/munin-node.pid
ignore_file \.bak$
ignore_file ^README$
ignore_file \.dpkg-(old|new)$
ignore_file \.rpm(save|new)$
ignore_file \.puppet-new$