supervisor-discord

Connects supervisor alerts to discord using webhooks. Supports customizable messages, discord markdown and timestamps.

Install

pip install supervisor-discord

Configure

Either run supervisor-discord -s to run the setup program, or create config.yaml manually using supervisor-discord -c.

config.yaml is typically located at ~/.config/supervisordiscord/config.yaml.

example: # process name or "all" for any process
  alerts: # list of process states that can trigger this message
  - STARTING
  - RUNNING
  - BACKOFF
  - STOPPING
  - FATAL
  - EXITED
  - STOPPED
  - UNKNOWN
  message_format: '{{process_name}} changed to state {{to_state}}'
  webhookURL: # discord webhook url

repeat for each process.

message_format supports strftime and the following formats:

{{process_name}}, {{from_state}}, {{to_state}}

Supervisor.conf

Ensure that supervisor-discord is on your system PATH. Or write out the full path to the command using whereis.

[eventlistener:supervisor-discord]
command=supervisor-discord
events=PROCESS_STATE