fatalmailbatch is a supervisor “event listener”, intended to be
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.
$ fatalmailbatch --toEmail=<email address> --fromEmail=<email address> \ [--interval=<batch interval in minutes>] [--subject=<email subject>]
Specify an email address to which fatal start notification messages are sent.
Specify an email address from which fatal start notification messages are sent.
Specify the time interval in minutes to use for batching notifcations. Defaults to 1 minute.
Override the email subject line. Defaults to “Fatal start alert from supervisord”
Configuring fatalmailbatch Into the Supervisor Config¶
[eventlistener:x] section must be placed in
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
[eventlistener:fatalmailbatch] command=fatalmailbatch --toEmail="firstname.lastname@example.org" --fromEmail="email@example.com" events=PROCESS_STATE,TICK_60