Guides
Adding Alerts For Workflow
Pre-Requisites
Setup a Notification Channel Integration
on the Integrations page. Please follow this document to add an integration.
Currently two types of Notification Channels are supported:
- Slack (Webhook URL based): For this, please create a webhook for your slack and then add it as an integration in Slack Provider Account (Slack Webhook Integration)
- Slack (Bot Token based): For this, please create a bot token for your slack and then add it as an integration in Slack Provider Account (Slack Bot Integration). It requires chat:write and chat:write:public scope. You can add slack channels to send to respective slack channel.
- Email (SMTP credentials Integration): This can be found in Custom Provider Account. You can configure the SMTP Credentials of the mail server, from_email and to_emails and use it to send notifications.
How to Configure
Define alerts in workflow Decorator
- You can define or configure the alerts in the workflow decorator in your workflow file.
⚠️Make sure that the truefoundry package version is set to latest version in task config.
For example in pip_packages filed in python task config, make sure that trufoundry[workflow] version is 0.6.3 or newer and not older one, or make sure that version which you are mentioning supports alerts.
- Right now the alert notification is supported only for workflow completion(successful completio and workflow failure(failure includes failed executions and aborted as well as timed out workflow executions).
- There are three types of targets, one is email and the others are slack webhook and slack bot, you need to add an email/slack webhook/slack bot integration respectively and select it in notification channel field to use that integration for sending notifications.
- Now when you will deploy the workflow, the alerts will be set.
Define alerts in deploy.py file
- Another way to define alerts is to define workflow in deploy.py file and set alerts in it.
- After defining this, you can just run
python deploy.py
and your workflow will be deployed and alerts will be set.