Skip to main content

Job notifications

Set up notifications in dbt Cloud to receive email or Slack alerts when a job run succeeds, fails, or is cancelled.

Email notifications

You can receive email alerts about jobs by configuring the dbt Cloud email notification settings.

Prerequisites

  • You must be either a developer user or an account admin to configure email notifications in dbt Cloud. For more details, refer to Users and licenses.
    • As a developer user, you can set up email notifications for yourself.
    • As an account admin, you can set up notifications for yourself and other team members.

Configure email notifications

  1. From the gear menu, choose Notification settings.

  2. By default, dbt Cloud sends notifications to the email address that's in your User profile page.

    If you're an account admin, you can choose a different email address to receive notifications. Select the Notification email dropdown and choose another address from the list. The list includes Internal Users with access to the account and External Emails that have been added.

    • To add an external email address, select the Notification email dropdown and choose Add external email. After you add the external email, it becomes available for selection in the Notification email dropdown list. External emails can be addresses that are outside of your dbt Cloud account and also for third-party integrations like channels in Microsoft Teams and PagerDuty email integration.
    Example of the Notification email dropdownExample of the Notification email dropdown
  3. Select the Environment for the jobs you want to receive notifications about from the dropdown.

  4. Click Edit to configure the email notification settings. Choose one or more of the run statuses (Succeeds, Fails, Is Canceled) for each job you want to receive notifications about.

  5. When you're done with the settings, click Save.

    As an account admin, you can add more email recipients by choosing another Notification email from the dropdown, Edit the job notification settings, and Save the changes.

    To set up alerts on jobs from a different environment, select another Environment from the dropdown, Edit those job notification settings, and Save the changes.

    Example of the Email notifications pageExample of the Email notifications page

Unsubscribe from email notifications

  1. From the gear menu, choose Notification settings.
  2. On the Email notifications page, click Unsubscribe from all email notifications.

Slack notifications

You can receive Slack alerts about jobs by setting up the Slack integration, then configuring the dbt Cloud Slack notification settings.

note

If there has been a change in user roles or Slack permissions where you no longer have access to edit a configured Slack channel, please contact support for assistance.

Prerequisites

  • You must be an administrator of the Slack workspace.
  • You must be an account admin to configure Slack notifications in dbt Cloud. For more details, refer to Users and licenses.
  • Make sure the notification channel (where you want to receive alerts) is a public channel. The integration only supports public channels in the Slack workspace.

Set up the Slack integration

  1. From the gear menu, select Profile settings. On your User profile page, scroll to the Linked accounts section.
  2. In the Linked accounts section, find the Slack application and click Link.
    Link for the Slack appLink for the Slack app
  3. Allow dbt Labs to access the Slack workspace. If you are a member of multiple workspaces, you can select the appropriate workspace from the dropdown menu in the upper right corner.
    Allow dbt access to SlackAllow dbt access to Slack

Configure Slack notifications

  1. From the gear menu, choose Notification settings.

  2. Select Slack notifications in the left sidebar.

  3. Select the Notification channel you want to receive the job run notifications from the dropdown.

    Example of the Notification channel dropdownExample of the Notification channel dropdown
  4. Select the Environment for the jobs you want to receive notifications about from the dropdown.

  5. Click Edit to configure the Slack notification settings. Choose one or more of the run statuses (Succeeds, Fails, Is Canceled) for each job you want to receive notifications about.

  6. When you're done with the settings, click Save.

    To send alerts to another Slack channel, select another Notification channel from the dropdown, Edit those job notification settings, and Save the changes.

    To set up alerts on jobs from a different environment, select another Environment from the dropdown, Edit those job notification settings, and Save the changes.

    Example of the Slack notifications pageExample of the Slack notifications page

Disable the Slack integration

  1. From the gear menu, select Profile settings. On your User profile page, scroll to the Linked accounts section.
  2. Find the Slack application in the Linked accounts section, click the trash can icon, and click Unlink. Channels that you configured will no longer receive Slack notifications. Channels that are configured by other account admins will continue to receive Slack notifications if they still have active Slack integrations. To migrate ownership of a Slack channel notification configuration, have another account admin edit the configuration.
0