# Slack Notifications
Prefect lets you easily setup callback hooks to get notified when certain state changes occur within your flows or for a given task. This can be as simple as:
from prefect import Flow, task from prefect.utilities.notifications import slack_notifier @task(name="1/x task", state_handlers=[slack_notifier]) def div(x): return 1 / x @task(name="Add 1 task", state_handlers=[slack_notifier]) def add(x): return x + 1 with Flow('Add Divide Flow') as f: res = div(x=add(-1)) final_state = f.run()
Which will produce the following messages in your channel of choice:
This can be further customized to only report on certain state changes, or you can use this tool as a building block for more complicated notification logic! In the near future, you'll be able to directly access the UI from links provided in the notifications, and even manually resume your workflows, all from within Slack! Before you can begin experimenting though, you need to install the Prefect Slack app to your workspace of choice.
# Installation Instructions
Currently, the Prefect slack app can only be installed with a "secret" installation URL. Eventually it will be installable by searching for it in the Slack App Directory, but not today. Given this, please be mindful of sharing this URL: installation URL.
After navigating to the installation URL, you can select the workspace and specific channel you want Prefect to post to (creating a designated #prefect channel could come in handy here). For example, if I want notifications to come directly to me in a private message:
After making your decisions, click the green "Authorize" button to proceed. Assuming all goes well, you should be greeted with a successful landing page that looks something like:
That's it! Save the URL in your secure location of choice; soon, you will be able to automatically import this into your database of Prefect Secrets.
It's perfectly OK to integrate the Prefect App multiple times into the same workspace; for example, you and a coworker who both use Prefect might want customized notifications. Follow these steps as many times as you desire, but make sure to keep track of which channel each URL is attached to!
# Using your URL to get notifications
Sooner rather than later, you will be able to store your slack webhook URL in your secure database of Prefect Secrets under
"SLACK_WEBHOOK_URL"; until then, you need to include it in the
[context.secrets] section of your prefect configuration file. To do so, create a file
~/.prefect/config.toml and place the following into it:
[context.secrets] SLACK_WEBHOOK_URL = "https://hooks.slack.com/services/XXXXXXXXX/xxxxxxxxx/XXXXXXXXXXX"
This method of storing secrets is intended only for local development and testing!
Almost there - all that's left is to actually hook up the
slack_notifier state handler to your favorite task or flow! All task and flow initializations accept an optional
state_handler keyword argument. This should consist of a list of "state handler" callables with call signature
def generic_state_handler(task_or_flow, old_state, new_state): # ... # implement your favorite custom logic to occur on state changes # ... return new_state # this is important
This function will be called every time your task (or flow) undergoes a state change. In the example at hand,
slack_notifier is already setup as a state handler for you!
Consequently, as we saw in the introduction example, you can provide
slack_notifier as a
state_handler for any task / flow you want.
# Customizing your alerts
The default settings are to be notified on every state change for the task / flow the
slack_notifier is registered with. There are three easy ways of customizing your Prefect slack alerts:
- ignore certain state changes with the
- alert only on certain state changes with the
- implement your own state handler which calls out to
slack_notifier state handler is curried, meaning you can call it early to bind certain keyword arguments. For example, suppose we only wanted to be notified on
Failed states; in that case, we could do:
from prefect import task from prefect.engine.state import Failed from prefect.utilities.notifications import slack_notifier handler = slack_notifier(only_states=[Failed]) # we can call it early @task(state_handlers=[handler]) def add(x, y): return x + y