2004-04-16

      mailping

      0.0.4

MAILPING-SUCCESS(1)						     Mailping						       MAILPING-SUCCESS(1)

NAME

       mailping-success - Munin plugin to graph time since last mail delivery

SYNOPSIS

       /usr/share/mailping/munin-plugins/mailping-success {[config] | ['']}

DESCRIPTION

	mailping-success is a Munin plugin that monitors time passed since last successful email probe.

   Configuration output
       When passed config, it outputs Munin configuration information. If there are no circuits defined (no subdirectories in /etc/mailping), it
       specifies that Munin should draw no graph either.

       If configuration files /etc/mailping/circuit/warntime and /etc/mailping/circuit/failtime exist, the values in them are passed on to Munin,
       for use in Nagios alert integration.

   Value output
       When passed an empty string '', mailping-success outputs the difference between current time and last successful probe, for each configured
       circuit.

FILES

       /etc/mailping/
	   List of circuits that exist; each subdirectory is a circuit.

       /etc/mailping/circuit/warntime
	   If more than this many seconds have passed since last successful probe, a Nagios warning is triggered by Munin (assuming it has been
	   configured to do that). Default: no warnings.

       /etc/mailping/circuit/failtime
	   If more than this many seconds have passed since last successful probe, a Nagios alert is triggered by Munin (assuming it has been
	   configured to do that). Default: no alerts.

       /var/lib/mailping/state/circuit/success
	   Timestamp in seconds of the last successful probe for circuit.

ENVIRONMENT

       MAILPING_CONFIGDIR
	   Override the location of the configuration directory. Default: /etc/mailping

       MAILPING_STATEDIR
	   Override the location of the state directory. Circuit states are stored in the state subdirectory of this directory, in subdirectories
	   named after the circuit name. Default: /var/lib/mailping

SEE ALSO

	mailping-latency(1), mailping-cron(1), mailping-store(1), munin-run(8), munin-node(8)

AUTHOR

       Tommi Virtanen <tv@havoc.fi>
       Havoc Consulting
	   Author.

COPYRIGHT

       Copyright (C) 2004 Havoc Consulting

mailping 0.							    2004-04-16						       MAILPING-SUCCESS(1)