man mailping-success (1): 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

AUTHOR

Tommi Virtanen <[email protected]>
Havoc Consulting

: Author.