fatalmailbatch Documentation¶
fatalmailbatch is a supervisor “event listener”, intended to be
subscribed to PROCESS_STATE
and TICK_60
events. It monitors
all processes running under a given supervisord instance.
fatalmailbatch sends email alerts when processes fail to start too many times such that supervisord gives up retrying. All of the fatal start events generated within the configured time interval are batched together to avoid sending too many emails.
fatalmailbatch is a “console script” installed when you install
superlance
. Although fatalmailbatch is an executable
program, it isn’t useful as a general-purpose script: it must be run as a
supervisor event listener to do anything useful.
Command-Line Syntax¶
$ fatalmailbatch --toEmail=<email address> --fromEmail=<email address> \
[--interval=<batch interval in minutes>] [--subject=<email subject>]
-
-t
<destination email>
,
--toEmail
=<destination email>
¶ Specify comma separated email addresses to which fatal start notification messages are sent.
-
-f
<source email>
,
--fromEmail
=<source email>
¶ Specify an email address from which fatal start notification messages are sent.
-
-i
<interval>
,
--interval
=<interval>
¶ Specify the time interval in minutes to use for batching notifcations. Defaults to 1 minute.
-
-s
<email subject>
,
--subject
=<email subject>
¶ Override the email subject line. Defaults to “Fatal start alert from supervisord”
Configuring fatalmailbatch Into the Supervisor Config¶
An [eventlistener:x]
section must be placed in supervisord.conf
in order for fatalmailbatch to do its work. See the “Events” chapter in
the Supervisor manual for more information about event listeners.
The following example assumes that fatalmailbatch is on your system
PATH
.
[eventlistener:fatalmailbatch]
command=fatalmailbatch --toEmail="alertme@fubar.com" --fromEmail="supervisord@fubar.com"
events=PROCESS_STATE,TICK_60