]> git.somenet.org - root/pub/somesible.git/blob - roles/service/munin-server/files/default/munin.conf
[roles/service/munin-server] munin server setup
[root/pub/somesible.git] / roles / service / munin-server / files / default / munin.conf
1 #
2 ################################################
3 ### Managed by someone's ansible provisioner ###
4 ################################################
5 # Part of: https://git.somenet.org/root/pub/somesible.git
6 # 2017-2024 by someone <someone@somenet.org>
7 #
8
9 # The next three variables specifies where the location of the RRD
10 # databases, the HTML output, logs and the lock/pid files.  They all
11 # must be writable by the user running munin-cron.  They are all
12 # defaulted to the values you see here.
13 #
14 #dbdir  /var/lib/munin
15 #htmldir /var/cache/munin/www
16 #logdir /var/log/munin
17 #rundir  /var/run/munin
18
19 # Where to look for the HTML templates
20 #
21 #tmpldir        /etc/munin/templates
22
23 # Where to look for the static www files
24 #
25 #staticdir /etc/munin/static
26
27 # temporary cgi files are here. note that it has to be writable by
28 # the cgi user (usually nobody or httpd).
29 #
30 # cgitmpdir /var/lib/munin/cgi-tmp
31
32 # (Exactly one) directory to include all files from.
33 includedir /etc/munin/munin-conf.d
34
35 # You can choose the time reference for "DERIVE" like graphs, and show
36 # "per minute", "per hour" values instead of the default "per second"
37 #
38 #graph_period second
39
40 # Graphics files are generated either via cron or by a CGI process.
41 # See http://munin-monitoring.org/wiki/CgiHowto2 for more
42 # documentation.
43 # Since 2.0, munin-graph has been rewritten to use the cgi code.
44 # It is single threaded *by design* now.
45 #
46 #graph_strategy cron
47
48 # munin-cgi-graph is invoked by the web server up to very many times at the
49 # same time.  This is not optimal since it results in high CPU and memory
50 # consumption to the degree that the system can thrash.  Again the default is
51 # 6.  Most likely the optimal number for max_cgi_graph_jobs is the same as
52 # max_graph_jobs.
53 #
54 #munin_cgi_graph_jobs 6
55
56 # If the automatic CGI url is wrong for your system override it here:
57 #
58 #cgiurl_graph /munin-cgi/munin-cgi-graph
59
60 # max_size_x and max_size_y are the max size of images in pixel.
61 # Default is 4000. Do not make it too large otherwise RRD might use all
62 # RAM to generate the images.
63 #
64 #max_size_x 4000
65 #max_size_y 4000
66
67 # HTML files are normally generated by munin-html, no matter if the
68 # files are used or not. You can change this to on-demand generation
69 # by following the instructions in http://munin-monitoring.org/wiki/CgiHowto2
70 #
71 # Notes:
72 # - moving to CGI for HTML means you cannot have graph generated by cron.
73 # - cgi html has some bugs, mostly you still have to launch munin-html by hand
74 #
75 #html_strategy cron
76
77 # munin-update runs in parallel.
78 #
79 # The default max number of processes is 16, and is probably ok for you.
80 #
81 # If set too high, it might hit some process/ram/filedesc limits.
82 # If set too low, munin-update might take more than 5 min.
83 #
84 # If you want munin-update to not be parallel set it to 0.
85 #
86 #max_processes 16
87
88 # RRD updates are per default, performed directly on the rrd files.
89 # To reduce IO and enable the use of the rrdcached, uncomment it and set it to
90 # the location of the socket that rrdcached uses.
91 #
92 #rrdcached_socket /var/run/rrdcached.sock
93
94 # Drop somejuser@fnord.comm and anotheruser@blibb.comm an email everytime
95 # something changes (OK -> WARNING, CRITICAL -> OK, etc)
96 #contact.someuser.command mail -s "Munin ${var:worst}: ${var:group}::${var:host}::${var:plugin}" somejuser@fnord.comm
97 #contact.anotheruser.command mail -s "Munin ${var:worst}: ${var:group}::${var:host}::${var:plugin}" anotheruser@blibb.comm
98 #
99 # For those with Nagios, the following might come in handy. In addition,
100 # the services must be defined in the Nagios server as well.
101 #contact.nagios.command /usr/bin/send_nsca nagios.host.comm -c /etc/nsca.conf
102
103 # The maximum time the munin-update may take to get updates from all nodes,
104 # this might be interesting when using munin-async in case of large transactions and/or backlog.
105 # When using the munin protocol to connect to a node, then this value shouldn't be set higher than 240.
106 # In case it's higher, gaps might be seen in the graphs.
107 timeout_fetch_all_nodes 240
108
109 # The maximum amount of time in seconds we may work on 1 node.
110 # The value will be limited with timeout_fetch_all_nodes.
111 timeout_fetch_one_node 180
112
113 # a simple host tree
114 [localhost]
115     address ssh://munin-async@127.0.0.1:2/
116     use_node_name yes
117     fail2ban.graph_category fail2ban
118
119 #
120 # A more complex example of a host tree
121 #
122 ## First our "normal" host.
123 # [fii.foo.com]
124 #       address foo
125 #
126 ## Then our other host...
127 # [fay.foo.com]
128 #       address fay
129 #
130 ## IPv6 host. note that the ip adress has to be in brackets
131 # [ip6.foo.com]
132 #       address [2001::1234:1]
133 #
134 ## Then we want totals...
135 # [foo.com;Totals] #Force it into the "foo.com"-domain...
136 #       update no   # Turn off data-fetching for this "host".
137 #
138 #   # The graph "load1". We want to see the loads of both machines...
139 #   # "fii=fii.foo.com:load.load" means "label=machine:graph.field"
140 #       load1.graph_title Loads side by side
141 #       load1.graph_order fii=fii.foo.com:load.load fay=fay.foo.com:load.load
142 #
143 #   # The graph "load2". Now we want them stacked on top of each other.
144 #       load2.graph_title Loads on top of each other
145 #       load2.dummy_field.stack fii=fii.foo.com:load.load fay=fay.foo.com:load.load
146 #       load2.dummy_field.draw AREA # We want area instead the default LINE2.
147 #       load2.dummy_field.label dummy # This is needed. Silly, really.
148 #
149 #   # The graph "load3". Now we want them summarised into one field
150 #       load3.graph_title Loads summarised
151 #       load3.combined_loads.sum fii.foo.com:load.load fay.foo.com:load.load
152 #       load3.combined_loads.label Combined loads # Must be set, as this is
153 #                                                 # not a dummy field!
154 #
155 ## ...and on a side note, I want them listen in another order (default is
156 ## alphabetically)
157 #
158 # # Since [foo.com] would be interpreted as a host in the domain "com", we
159 # # specify that this is a domain by adding a semicolon.
160 # [foo.com;]
161 #       node_order Totals fii.foo.com fay.foo.com
162 #