munin-update(8) [debian man page]

MUNIN-UPDATE(8) 						Munin Documentation						   MUNIN-UPDATE(8)

NAME

       munin-update - A program to gather data from machines running munin-node

SYNOPSIS

       munin-update [options]

	Options:
	    --config_file=<file>    Use <file> as configuration file.
	    --[no]debug 	    Enable [or disable] debug messages. [--nodebug]
	    --[no]fork		    Query hosts in parallell (--fork), or
				    sequentially (--nofork). [--fork]
	    --host <host>	    Limit graphed hosts to <host>. Multiple --host
				    options may be supplied.
	    --service <service>     Limit graphed services to <service>. Multiple
				    --service options may be supplied.
	    --timeout=<seconds>     TCP timeout when talking to clients. [$timeout]
	    --help		    View this message.
	    --version		    View version information.

OPTIONS

       --config_file=<file>
	    Use <file> as the configuration file. [/etc/munin/munin.conf]

       --[no]debug
	    If set, log debug messages. [--nodebug]

       --[no]fork
	    If set, will fork off one process for each host. [--fork]

       --host <host>
	    Limit fetched data to those from <host<gt>. Multiple --host options may be supplied. [unset]

       --service <service>
	    Limit fetched data to those of <service>. Multiple --service options may be supplied. [unset]

       --timeout <seconds>
	    Set the network timeout to <seconds>. [180]

       --help
	    Print the help message then exit.

       --version
	    Print version information then exit.

DESCRIPTION

       Munin-update is a part of the package Munin, which is used in combination with Munin's node.  Munin is a group of programs to gather data
       from Munin's nodes, graph them, create html-pages, and optionally warn Nagios about any off-limit values.

       Munin-update does the gathering. It is usually only used from within munin-cron.

       It contacts each host's munin-node in turn, gathers data from it, and stores them in .rrd-files. If necessary, it will create the rrd-files
       and the directories to store them in.

FILES

	       /etc/munin/munin.conf
	       /var/lib/munin/*
	       /var/log/munin/munin-update
	       /var/run/munin/*

BUGS

       For a list of bugs concerning munin-update, see FI.  ticket report"

       Please report bugs in the bug tracker at http://munin-monitoring.org/ <http://munin-monitoring.org/>.

AUTHORS

       The Munin Team. FIX

COPYRIGHT

       Copyright AX 2002-2009 Jimmy Olsen, Audun Ytterdal, Tore Andersson, Kjell-Magne A~Xierud, Linpro AS, Redpill Linpro AS

       This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A
       PARTICULAR PURPOSE.

       This program is released under the GNU General Public License.

2.0.6-4+deb7u2							    2013-11-12							   MUNIN-UPDATE(8)

Munin::Node::Configure::Plugin(3pm)			User Contributed Perl Documentation		       Munin::Node::Configure::Plugin(3pm)

NAME

       Munin::Node::Configure::Plugin - Class representing a plugin, along with its installed and suggested services.

SYNOPSIS

	 my $plugin = Munin::Node::Configure::Plugin->new();

METHODS

       new(%args)
	   Constructor.

	   Required arguments are 'name' and 'path', which should be the basename and full path of the plugin, respectively.

       is_wildcard()
	   Returns true if the plugin is a wildcard.  In the case of SNMP plugins, only double-wild plugins will return true (ie. 'snmp__memory'
	   would return false, but 'snmp__if_' would return true).

       is_snmp()
	   Returns true if the plugin is an SNMP plugin.

       in_family(@families)
	   Returns true if plugin's family is in @families, false otherwise.

       is_installed()
	   Returns 'yes' if one or more links to this plugin exist in the service directory, 'no' otherwise.

       suggestion_string()
	   Returns a string detailing whether or not autoconf considers that the plugin should be installed.  The string may also report the
	   reason why the plugin declined to be installed, or the list of suggestions it provided, if this information is available.

       installed_services_string()
	   Returns a string detailing which wildcards are installed for this plugin.

       services_to_add()
       services_to_remove()
	   Return a list of service names that should be added or removed for this plugin.

       add_instance($name)
	   Associates a link from the service directory with this plugin.

       add_suggestions(@suggestions)
	   Adds @suggestions to the list of suggested wildcards for this plugin.  They are not validated.

       read_magic_markers()
	   Sets the family and capabilities from the magic markers embedded in the plugin's executable, as specified by
	   http://munin-monitoring.org/wiki/ConcisePlugins#Magicmarkers <http://munin-monitoring.org/wiki/ConcisePlugins#Magicmarkers>

       parse_autoconf_response(@response)
	   Parses and validates the autoconf response from the plugin, in the format specified by
	   http://munin-monitoring.org/wiki/ConcisePlugins#autoconf <http://munin-monitoring.org/wiki/ConcisePlugins#autoconf>

	   Invalid input will cause an error to be logged against the plugin.

       parse_suggest_response(@response)
	   Validates the suggestions from the plugin.

	   Invalid suggestions will cause an error to be logged against the plugin.

       parse_snmpconf_response(@response)
	   Parses and validates the snmpconf response from the plugin, in the format specified by
	   http://munin-monitoring.org/wiki/ConcisePlugins#suggest <http://munin-monitoring.org/wiki/ConcisePlugins#suggest>

	   Invalid or inconsistent input will cause an error to be logged against the plugin.

       log_error($message)
	   Logs an error for later retrieval.  The error will also be displayed if debugging output is enabled.

perl v5.14.2							    2013-11-12				       Munin::Node::Configure::Plugin(3pm)