Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update job-notifications.md #6328

Merged
merged 1 commit into from
Oct 21, 2024
Merged

Update job-notifications.md #6328

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 7 additions & 7 deletions website/docs/docs/deploy/job-notifications.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@

### Configure email notifications

1. From the gear menu, choose **Notification settings**.
1. Select your profile icon and then click **Notification settings**.
1. 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.
Expand All @@ -44,12 +44,12 @@
<Lightbox src="/img/docs/deploy/example-email-notification-settings-page.png" width="100%" title="Example of the Email notifications page"/>

### Unsubscribe from email notifications
1. From the gear menu, choose **Notification settings**.
1. Select your profile icon and click on **Notification settings**.
1. 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. dbt Cloud integrates with Slack via OAuth to ensure secure authentication.
You can receive Slack alerts about jobs by setting up the Slack integration and then configuring the dbt Cloud Slack notification settings. dbt Cloud integrates with Slack via OAuth to ensure secure authentication.

:::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](mailto:[email protected]) for assistance.
Expand All @@ -62,7 +62,7 @@

### Set up the Slack integration

1. From the gear menu, select **Account settings** and then select **Integrations** from the left sidebar.
1. Select **Account settings** and then select **Integrations** from the left sidebar.

Check warning on line 65 in website/docs/docs/deploy/job-notifications.md

View workflow job for this annotation

GitHub Actions / vale

[vale] website/docs/docs/deploy/job-notifications.md#L65 

[custom.UIElements] UI elements like 'Account settings' should be bold.
Raw output 
{"message": "[custom.UIElements] UI elements like 'Account settings' should be bold.", "location": {"path": "website/docs/docs/deploy/job-notifications.md", "range": {"start": {"line": 65, "column": 13}}}, "severity": "WARNING"}
1. Locate the **OAuth** section with the Slack application and click **Link**.
<Lightbox src="/img/docs/dbt-cloud/Link-your-Slack-Profile.png" width="75%" title="Link for the Slack app"/>

Expand All @@ -76,13 +76,13 @@

1. Complete the field defining the Slack workspace you want to integrate with dbt Cloud.
<Lightbox src="/img/docs/dbt-cloud/define-workspace.png" width="60%" title="Define the workspace"/>
2. Sign in with an existing identity or use email address and password.
2. Sign in with an existing identity or use the email address and password.
3. Once you have authenticated successfully, accept the permissions.
<Lightbox src="/img/docs/dbt-cloud/accept-permissions.png" width="65%" title="Allow dbt access to Slack"/>

### Configure Slack notifications

1. From the gear menu, choose **Notification settings**.
1. Select your profile icon and then click on **Notification settings**.
1. Select **Slack notifications** in the left sidebar.
1. Select the **Notification channel** you want to receive the job run notifications from the dropdown.
<Lightbox src="/img/docs/deploy/example-notification-slack-channels.png" width="100%" title="Example of the Notification channel dropdown"/>
Expand All @@ -98,5 +98,5 @@

### Disable the Slack integration

1. From the gear menu, select **Account settings**. On the **Integrations** page, scroll to the **OAuth** section.
1. Select **Account settings** and on the **Integrations** page, scroll to the **OAuth** section.

Check warning on line 101 in website/docs/docs/deploy/job-notifications.md

View workflow job for this annotation

GitHub Actions / vale

[vale] website/docs/docs/deploy/job-notifications.md#L101 

[custom.UIElements] UI elements like 'Account settings' should be bold.
Raw output 
{"message": "[custom.UIElements] UI elements like 'Account settings' should be bold.", "location": {"path": "website/docs/docs/deploy/job-notifications.md", "range": {"start": {"line": 101, "column": 13}}}, "severity": "WARNING"}
1. Click the trash can icon (on the far right of the Slack integration) and click **Unlink**. Channels that you configured will no longer receive Slack notifications. _This is not an account-wide action._ Channels 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 their configuration.
Loading