~ubuntu-branches/ubuntu/gutsy/munin/gutsy

« back to all changes in this revision

Viewing changes to node/munin-node.conf.pod

  • Committer: Bazaar Package Importer
  • Author(s): Tore Anderson
  • Date: 2004-05-21 20:51:19 UTC
  • Revision ID: james.westby@ubuntu.com-20040521205119-oz8bllbjp9hs80ig
Tags: upstream-0+1.0.0pre5
Import upstream version 0+1.0.0pre5

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
=head1 NAME
 
2
 
 
3
node.conf - Munin-node configuration file
 
4
 
 
5
=head1 DESCRIPTION
 
6
 
 
7
Munin-node is the node that Munin fetches data from, graphs, htmlifies
 
8
and optionaly warns nagios about data it gathers. It's designed to let it
 
9
be very easy to graph new datasources.
 
10
 
 
11
"node.conf" is the configuration file for munin-node.
 
12
 
 
13
The format of the file is dictated by the use of Net::Server. A look at
 
14
"perldoc Net::Server" will give a list of options that the file supports
 
15
by using the module.
 
16
 
 
17
Additional options:
 
18
 
 
19
=over 5
 
20
 
 
21
=item B<< host_name <host> >>
 
22
 
 
23
If set, overrides the hostname munin-node uses in its
 
24
'hello'-negotiation with munin. A "telnet localhost 4949" will show the
 
25
hostname munin-node is currently using. If munin-node and the main munin
 
26
installation do not agree on the hostname, munin will skip all the
 
27
plugins of the machine in question.
 
28
 
 
29
=item B<< paranoia <yes|no|true|false|on|off|1|0> >>
 
30
 
 
31
If set, checks permissions of plugin files, and only tries to run files
 
32
owned by root. Default on.
 
33
 
 
34
=item B<< ignore_file <regex> >>
 
35
 
 
36
Files matching &lt;regex&gt; in the node.d/ and node-conf.d/
 
37
directories will be overlooked.
 
38
 
 
39
=head1 EXAMPLE
 
40
 
 
41
A pretty normal configuration file:
 
42
 
 
43
        log_level 4
 
44
        log_file /var/log/munin/munin-node.log
 
45
        port 4949
 
46
        pid_file /var/run/munin-node.pid
 
47
        background 1
 
48
        setseid 1
 
49
 
 
50
        host *
 
51
        user root
 
52
        group root
 
53
        setsid yes
 
54
 
 
55
        ignore_file \.bak$
 
56
        ignore_file \.rpm(save|new)$
 
57
        ignore_file ^README$
 
58
 
 
59
        allow ^127\.0\.0\.1$
 
60
 
 
61
        ignore_file \.dpkg-(old|new)$
 
62
        ignore_file \.rpm(save|new)$
 
63
 
 
64
See the documentation or Munin homepage L<http://munin.sf.net/> for more info.
 
65
 
 
66
=head1 AUTHORS
 
67
 
 
68
Jimmy Olsen.
 
69
 
 
70
=head1 COPYRIGHT
 
71
 
 
72
Copyright � 2002-2004 Audun Ytterdal and Jimmy Olsen / Linpro AS.
 
73
 
 
74
This is free software; see the source for copying conditions. There is NO
 
75
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
 
76
PURPOSE.
 
77
 
 
78
This program is released under the GNU General Public License
 
79
 
 
80
=cut