Section: User Contributed Perl Documentation (1)
munin-run - A program to run Munin plugins from the command line
munin-run [options] <plugin> [ config | autoconf | snmpconf | suggest ]
munin-run is a script to run Munin plugins from the command-line.
It's useful when debugging plugins, as they are run in the same conditions
as they are under munin-node.
- --config <configfile>
Use <file> as configuration file. [/etc/munin/munin-node.conf]
- --servicedir <dir>
Use <dir> as plugin dir. [/etc/munin/plugins/]
- --sconfdir <dir>
Use <dir> as plugin configuration dir. [/etc/munin/plugin-conf.d/]
- --sconffile <file>
Use <file> as plugin configuration. Overrides sconfdir. [undefined]
Only run plugins owned by root and check permissions. [disabled]
Do not try to detect and enforce the locally configured hardening flags of the
``munin-node'' service unit. This detection is skipped, if systemd is not enabled.
The hardening flags may cause subtile surprises.
For example ``ProtectHome=yes'' prevents the ``df'' plugin from determining the
state of the ``home'' partition. [disabled]
View this help message.
Print debug messages. Debug messages are sent to STDOUT and are
prefixed with ``#'' (this makes it easier for other parts of munin to
use munin-run and still have --debug on). Only errors go to STDERR.
Plugin debug. Sets the environment variable MUNIN_DEBUG to 1 so
that plugins may enable debugging. [disabled]
Show version information.
NOTES FOR SYSTEMD USERS
The ``munin-node'' service is usually started by systemd via a
``munin-node.service'' definition. Some distributions enable hardening
settings in this service file in order to restrict the allowed set of
activities for the ``munin-node'' process.
This may cause surprising differences between the result of ``munin-run''
and the real ``munin-node'' service.
A popular example of such a surprising restriction is ``ProtectHome=yes''
combined with the ``df'' plugin. The restriction silently prevents the
plugin from determining the status of mountpoints below /home.
``munin-run'' tries to mimic this behavior of ``munin-node'' automatically.
Thus the execution of ``munin-run df'' should provide the same output as
``echo fetch df | nc localhost munin''.
If you want to debug potential issues of systemd restrictions, then you
may want to use the parameters ``--ignore-systemd-properties'' and
``--debug''. Permanent overrides of systemd properties can be configured
locally via ``systemctl edit munin-node''.
See ``man systemd.exec'' for the documentation of systemd's properties.
This is munin-run (munin-node) v2.0.66
Audun Ytterdal, Jimmy Olsen, Tore Anderson, Nicolai Langfeldt,
Please see <http://munin-monitoring.org/report/1
Copyright (C) 2002-2009 Audun Ytterdal, Jimmy Olsen, Tore Anderson,
Nicolai Langfeldt / Linpro AS.
Copyright (C) 2020 Lars Kruse
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; version 2 dated June,
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
MA 02110-1301 USA.