GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
MUNIN-RUN(1) User Contributed Perl Documentation MUNIN-RUN(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. [/usr/local/etc/munin/munin-node.conf]
--servicedir <dir>
Use <dir> as plugin dir. [/usr/local/etc/munin/plugins/]
--sconfdir <dir>
Use <dir> as plugin configuration dir. [/usr/local/etc/munin/plugin-conf.d/]
--sconffile <file>
Use <file> as plugin configuration. Overrides sconfdir. [undefined]
--paranoia
Only run plugins owned by root and check permissions. [disabled]
--ignore-systemd-properties
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]
--help
View this help message.
--debug
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.
--pidebug
Plugin debug. Sets the environment variable MUNIN_DEBUG to 1 so that plugins may enable debugging. [disabled]
--version
Show version information.

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.

    /usr/local/etc/munin/munin-node.conf
    /usr/local/etc/munin/plugins/*
    /usr/local/etc/munin/plugin-conf.d/*
    /var/run/munin/munin-node.pid
    /var/log/munin/munin-node.log

This is munin-run (munin-node) v2.0.69

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

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, 1991.

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.

2022-04-12 perl v5.32.1

Search for    or go to Top of page |  Section 1 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.