Slack & Dagster+#

This guide is applicable to Dagster+.

Dagster+ supports sending alerts to Slack channels using a Slack workplace app. Messages will be posted using a @Dagster+ bot user.

Prerequisites#

To follow the steps in this guide, you'll need:

Permissions in Slack that allow you to add apps to your Slack workspace
Organization, Admin, or Editor permissions in Dagster+, which are required to create and manage alerts

Step 1: Connect Slack to Dagster+#

Sign in to your Dagster+ account.
In the top navigation, click Deployment.
Click the Alerts tab.
Click Connect to Slack and complete the installation process.

Step 2: Invite the Dagster+ bot to Slack channels#

After the app is installed in your Slack workspace, invite the @Dagster+ bot user to the channel where notifications should be sent.

Step 3: Create an alert policy in Dagster+#

Creating an alert policy can be done using the Dagster+ UI or the dagster-cloud CLI and a YAML file.

In the UI#

Create and configure an alert policy. Refer to the Managing alerts in Dagster+ guide for more info.
In the Notification Service section of the Create alert policy window, select the Slack option.
In the field that displays, enter the name of the Slack channel you added the @Dagster+ bot user to.
Note: One channel is allowed per alert policy. To post alerts to multiple channels, first invite the @Dagster+ bot and then create a new alert policy that posts to that channel.
Click Save policy.

dagster-cloud CLI#

To define a Slack alert policy in code, use the following keys to configure the alert:

notification_service.slack.slack_workspace_name - The name of the Slack workspace connected to Dagster+
notification_service.slack.slack_channel_name - The name of the Slack channel the @Dagster+ user is a member of


# alert_policies.yaml

alert_policies:
  - name: "slack-alert-policy"
    description: "An alert policy to send a Slack notification to sales on job failure or success."
    tags:
      - key: "team"
        value: "sales"
    event_types:
      - "JOB_SUCCESS"
      - "JOB_FAILURE"
    notification_service:
      slack:
        slack_workspace_name: "hooli"
        slack_channel_name: "sales-notifications"

Then, use the dagster-cloud CLI to set the alert policies for the deployment:


dagster-plus deployment alert-policies sync -a /path/to/alert_policies.yaml

Refer to the Managing alerts using the dagster-cloud CLI guide for more information.

Disconnecting Slack#

To disconnect Dagster+ from Slack, remove the Dagster+ app from your Slack workspace. Refer to Slack's documentation for more info and instructions.

Once the app is removed, refresh the Alerts page in Dagster+ and the Connect to Slack option will be displayed.