Adding New Alert Destinations
QUICK NAV
Intro
Whenever an Alert triggers, it sends a blob of related data (called the Alert Template) to its designated Alert Destinations. Destinations can use this blob of data to fire off emails, Slack messages, or custom web hooks. You can set up new Alert Destinations from the settings screen.
Only Admins can add new alert destinations. Destinations are available to all users once configured.
Add A New Alert Destination
There are a few types of destinations to choose from:
- Slack
- PagerDuty
- Mattermost
- Google Hangouts Chat
- HipChat
- ChatWork
- Generic WebHook
The default destination for any alert is the email address for the user who created it. If you made an alert and need to be notified by email then you don’t need to setup a new Alert Destination. Instead, toggle the switch beside your email address on the alert setup screen.
To configure one, select it from Create a New Alert Destination dialogue and follow its prompts.
PagerDuty
First you need to obtain the PagerDuty Integration Key from your PagerDuty console.
Services > Service Details > Integrations
If you don’t have an API v2 Integration yet, you need to create it.
After obtaining the Integration Key:
- Open “Alert Destinations” tab in the settings screen, and click on ”+ New Alert Destination”.
- In the form that opens pick “PagerDuty” as the type.
- The mandatory fields are Name and Integration Key.
- You add this new destination for any alert that you want to trigger PagerDuty incident.
Slack
- Open “Alert Destinations” tab in the settings screen, and click on ”+ New Alert Destination”.
- In the form that opens pick “Slack” as the type.
- Set the name, channel, etc. and provide a “Slack Webhook URL”, which you can create here: https://my.slack.com/services/new/incoming-webhook/. If the Webhook target is a channel in the channel field make sure to prefix the channel name with
#
(i.e.#marketing
). If the destination is a direct message to a user, prefix it with@
(i.e.@smartguy
). - You add this new destination for any alert that you want to be sent to Slack.