munin.conf¶
DESCRIPTION¶
This is the configuration file for the munin master. It is used by munin-update, munin-graph, munin-limits. munin-html, munin-cgi-graph and munin-cgi-html.
GLOBAL DIRECTIVES¶
Global directives affect all munin master components unless specified otherwise.
-
dbdir
<path>
¶ The directory where munin stores its database files. Default: /var/lib/munin
-
logdir
<path>
¶ The directory where munin stores its logfiles. Default: /var/log/munin
-
htmldir
<path>
¶ The directory where munin-html stores generated HTML pages, and where munin-graph stores graphs. Default: /var/cache/munin/www
-
rundir
<path>
¶ Directory for files tracking munin’s current running state. Default: /var/run/munin
-
tmpldir
<path>
¶ Directories for templates used by munin-html and munin-cgi-html to generate HTML pages. Default /etc/munin/templates
-
fork
<yes|no>
¶ This directive determines whether munin-update fork when gathering information from nodes. Default is “yes”.
If you set it to “no” munin-update will collect data from the nodes in sequence. This will take more time, but use less resources. Not recommended unless you have only a handful of nodes.
Affects: munin-update
-
palette
<default|old>
¶ The palette used by munin-graph and munin-cgi-graph to colour the graphs. The “default” palette has more colours and better contrast than the “old” palette.
Affects: munin-graph
-
graph_data_size
<normal|huge>
¶ This directive sets the resolution of the RRD files that are created by munin-graph and munin-cgi-graph.
Default is “normal”.
“huge” saves the complete data with 5 minute resolution for 400 days.
Changing this directive has no effect on existing graphs
Affects: munin-graph
-
graph_strategy
<cgi|cron>
¶ If set to “cron”, munin-graph will graph all services on all nodes every run interval.
If set to “cgi”, munin-graph will do nothing. To generate graphs you must then configure a web server to run munin-cgi-graph instead.
Affects: munin-graph
-
html_strategy
<strategy>
¶ Valid strategies are “cgi” and “cron”. Default is “cgi”.
If set to “cron”, munin-html will recreate all html pages every run interval.
If set to “cgi”, munin-html will do nothing. To generate html pages you must configure a web server to run munin-cgi-html instead.
-
ssh_command
<command>
¶ The name of the secure shell command to use. Can be fully qualified or looked up in $PATH.
Defaults to “ssh”.
-
ssh_options
<options>
¶ The options for the secure shell command.
Defaults are “-o ChallengeResponseAuthentication=no -o StrictHostKeyChecking=no”. Please adjust this according to your desired security level.
With the defaults, the master will accept and store the node ssh host keys with the first connection. If a host ever changes its ssh host keys, you will need to manually remove the old host key from the ssh known hosts file. (with: ssh-keygen -R <node-hostname>, as well as ssh-keygen -R <node-ip-address>)
You can remove “StrictHostKeyChecking=no” to increase security, but you will have to manually manage the known hosts file. Do so by running “ssh <node-hostname>” manually as the munin user, for each node, and accept the ssh host keys.
If you would like the master to accept all node host keys, even when they change, use the options “-o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no -o PreferredAuthentications=publickey”.