1MUNIN-RUN(1) User Contributed Perl Documentation MUNIN-RUN(1)
2
6 munin-run - A program to run Munin plugins from the command line
7
9 munin-run [options] <plugin> [ config | autoconf | snmpconf | suggest ]
10
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
17 --config <configfile>
18 Use <file> as configuration file. [/etc/munin/munin-node.conf]
19 --servicedir <dir>
21 Use <dir> as plugin dir. [/etc/munin/plugins/]
22 --sconfdir <dir>
24 Use <dir> as plugin configuration dir. [/etc/munin/plugin-conf.d/]
25 --sconffile <file>
27 Use <file> as plugin configuration. Overrides sconfdir.
28 [undefined]
29 --paranoia
31 Only run plugins owned by root and check permissions. [disabled]
32 --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 --help
41 View this help message.
42 --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 --pidebug
50 Plugin debug. Sets the environment variable MUNIN_DEBUG to 1 so
51 that plugins may enable debugging. [disabled]
52 --version
54 Show version information.
55
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 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 "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 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
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
86 This is munin-run (munin-node) v2.0.75
87
89 Audun Ytterdal, Jimmy Olsen, Tore Anderson, Nicolai Langfeldt, Lars
90 Kruse.
91
93 Copyright (C) 2002-2009 Audun Ytterdal, Jimmy Olsen, Tore Anderson,
94 Nicolai Langfeldt / Linpro AS. Copyright (C) 2020 Lars Kruse
95 This program is free software; you can redistribute it and/or modify it
97 under the terms of the GNU General Public License as published by the
98 Free Software Foundation; version 2 dated June, 1991.
99 This program is distributed in the hope that it will be useful, but
101 WITHOUT ANY WARRANTY; without even the implied warranty of
102 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
103 General Public License for more details.
104 You should have received a copy of the GNU General Public License along
106 with this program; if not, write to the Free Software Foundation, Inc.,
107 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
108perl v5.38.0 2023-11-06 MUNIN-RUN(1)