2004-04-16

      mailping

      0.0.4

MAILPING-LATENCY(1)						     Mailping						       MAILPING-LATENCY(1)

NAME

       mailping-latency - Munin plugin to graph latency of mail deliveries

SYNOPSIS

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

DESCRIPTION

	mailping-latency is a Munin plugin that monitors the time spent between email submit and it's delivery.

   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/warnlatency and /etc/mailping/circuit/faillatency exist, the values in them are passed on to
       Munin, for use in Nagios alert integration.

   Value output
       When passed an empty string '', mailping-latency outputs latency of last successful probe message, for each configured circuit.

FILES

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

       /etc/mailping/circuit/warnlatency
	   If latency is greater than this many seconds, a Nagios warning is triggered by Munin (assuming it has been configured to do that).
	   Default: no warnings.

       /etc/mailping/circuit/faillatency
	   If latency is greater than this many seconds, a Nagios alert is triggered by Munin (assuming it has been configured to do that).
	   Default: no alerts.

       /var/lib/mailping/state/circuit/latency
	   Amount of latency 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-success(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-LATENCY(1)