- Alerting
- Alerting status updates in Slack
Alerting
Alerting status updates in Slack
Get status updates in your Slack channel.

Overview of steps
- Set up webhooks for Slack
- Update Mage project settings
Set up webhooks for Slack
Follow these instructions on Slack to setup incoming webhooks for your workspace.
Update Mage project settings
Once you’ve set up webhooks for Slack, you should have a webhook URL that Slack provides.
Here is an example webhook (yours may vary):
https://hooks.slack.com/services/T01XXXXRKMJ/B04XXXXGY67/1UgUkao8pXXXXPmsuXXXX2lk
Follow these steps to add that webhook URL to your project settings:
- Open the Mage tool in your browser (e.g. http://localhost:6789/).
- Open a pipeline and start editing it (e.g. http://localhost:6789/pipelines/example_pipeline/edit).
- In your left sidebar in the file browser, scroll all the way down and click
on a file named
metadata.yaml
. - In the
metadata.yaml
file, add a section with the following configuration or update the existingnotification_config
section:
notification_config:
alert_on:
- trigger_failure
- trigger_passed_sla
If you omit the alert_on
section it will default to trigger_failure
and trigger_passed_sla
.
Options:
trigger_failure
: alert when a run of a trigger failstrigger_success
: alert when a run of a trigger succeedstrigger_passed_sla
: alert when a run of a trigger passes sla
- In the
metadata.yaml
file, add the following values:
notification_config:
alert_on:
...
slack_config:
webhook_url: ...
- Change the
webhook_url
value to be the webhook URL you created from Slack.
What next?
Whenever a pipeline run is successfully completed or fails, a Slack message will appear in the channel you configured the webhook URL for.
Here is an example of what that message could look like:
![]() |