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