History

Aivars Šterns 230a596e25 update readme		2016-11-08 14:08:48 +02:00
..
images	Add image to slack readme	2016-05-20 12:31:07 +01:00
alerta_slack.py	add proper configuration for emoji, username and ui url	2016-11-08 14:05:42 +02:00
README.md	update readme	2016-11-08 14:08:48 +02:00
setup.py	Set useful logger name for plugins	2016-09-15 10:18:03 +01:00

README.md

Slack Plugin

Send alerts to Slack.

Installation

Run the following command on the Alerta server to install and register the new plugin:

$ python setup.py install

Configuration

To configure the Slack plugin start by setting up an incoming webhook integration for your Slack channel and adding the following configuration settings to alertad.conf:

SLACK_WEBHOOK_URL = 'https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX'
SLACK_ATTACHMENTS = True  # default=False
SLACK_CHANNEL = '' # if empty then uses channel from incoming webhook configuration
ALERTA_UI_URL = 'http://your.alerta.ui.url'
ICON_EMOJI = '' # default :rocket:
ALERTA_USERNAME = '' # default alerta

Lastly, add slack to the list of enabled plugins:

PLUGINS = ['reject', 'slack']

References

Slack Incoming Webhooks: https://api.slack.com/incoming-webhooks