1MUNIN-RUN(1)          User Contributed Perl Documentation         MUNIN-RUN(1)
2
3
4

NAME

6       munin-run - A program to run Munin plugins from the command line
7

SYNOPSIS

9       munin-run [options] <plugin> [ config | autoconf | snmpconf | suggest ]
10

DESCRIPTION

12       munin-run is a script to run Munin plugins from the command-line.  It's
13       useful when debugging plugins, as they are run in the same conditions
14       as they are under munin-node.
15

OPTIONS

17       --config <configfile>
18            Use <file> as configuration file. [/etc/munin/munin-node.conf]
19
20       --servicedir <dir>
21            Use <dir> as plugin dir. [/etc/munin/plugins/]
22
23       --sconfdir <dir>
24            Use <dir> as plugin configuration dir. [/etc/munin/plugin-conf.d/]
25
26       --sconffile <file>
27            Use <file> as plugin configuration. Overrides sconfdir.
28            [undefined]
29
30       --paranoia
31            Only run plugins owned by root and check permissions.  [disabled]
32
33       --ignore-systemd-properties
34            Do not try to detect and enforce the locally configured hardening
35            flags of the "munin-node" service unit. This detection is skipped,
36            if systemd is not enabled.  The hardening flags may cause subtile
37            surprises.  For example "ProtectHome=yes" prevents the "df" plugin
38            from determining the state of the "home" partition.  [disabled]
39
40       --help
41            View this help message.
42
43       --debug
44            Print debug messages.  Debug messages are sent to STDOUT and are
45            prefixed with "#" (this makes it easier for other parts of munin
46            to use munin-run and still have --debug on).  Only errors go to
47            STDERR.
48
49       --pidebug
50            Plugin debug.  Sets the environment variable MUNIN_DEBUG to 1 so
51            that plugins may enable debugging.  [disabled]
52
53       --version
54            Show version information.
55

NOTES FOR SYSTEMD USERS

57       The "munin-node" service is usually started by systemd via a
58       "munin-node.service" definition.  Some distributions enable hardening
59       settings in this service file in order to restrict the allowed set of
60       activities for the "munin-node" process.  This may cause surprising
61       differences between the result of "munin-run" and the real "munin-node"
62       service.
63
64       A popular example of such a surprising restriction is "ProtectHome=yes"
65       combined with the "df" plugin.  The restriction silently prevents the
66       plugin from determining the status of mountpoints below /home.
67
68       "munin-run" tries to mimic this behavior of "munin-node" automatically.
69       Thus the execution of "munin-run df" should provide the same output as
70       "echo fetch df | nc localhost munin".
71
72       If you want to debug potential issues of systemd restrictions, then you
73       may want to use the parameters "--ignore-systemd-properties" and
74       "--debug".  Permanent overrides of systemd properties can be configured
75       locally via "systemctl edit munin-node".  See "man systemd.exec" for
76       the documentation of systemd's properties.
77

FILES

79           /etc/munin/munin-node.conf
80           /etc/munin/plugins/*
81           /etc/munin/plugin-conf.d/*
82           /var/run/munin/munin-node.pid
83           /var/log/munin/munin-node.log
84

VERSION

86       This is munin-run (munin-node) v2.0.67
87

AUTHORS

89       Audun Ytterdal, Jimmy Olsen, Tore Anderson, Nicolai Langfeldt, Lars
90       Kruse.
91

BUGS

93       Please see <http://munin-monitoring.org/report/1>.
94
96       Copyright (C) 2002-2009 Audun Ytterdal, Jimmy Olsen, Tore Anderson,
97       Nicolai Langfeldt / Linpro AS.  Copyright (C) 2020 Lars Kruse
98
99       This program is free software; you can redistribute it and/or modify it
100       under the terms of the GNU General Public License as published by the
101       Free Software Foundation; version 2 dated June, 1991.
102
103       This program is distributed in the hope that it will be useful, but
104       WITHOUT ANY WARRANTY; without even the implied warranty of
105       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
106       General Public License for more details.
107
108       You should have received a copy of the GNU General Public License along
109       with this program; if not, write to the Free Software Foundation, Inc.,
110       51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
111
112
113
114perl v5.34.0                      2021-07-22                      MUNIN-RUN(1)
Impressum