Skip to content

Commit

Permalink
Update model-notifications
Browse files Browse the repository at this point in the history
  • Loading branch information
joellabes authored Nov 27, 2024
1 parent 043adb6 commit 1b65a40
Showing 1 changed file with 38 additions and 6 deletions.
44 changes: 38 additions & 6 deletions website/docs/docs/deploy/model-notifications.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,9 @@ Create configuration YAML files in your project for dbt to send notifications ab

## Configure groups

Add your group configuration in either the `dbt_project.yml` or `groups.yml` file. For example:
Define your groups in any .yml file in your [models directory](/reference/project-configs/model-paths). For example:

<File name='models/groups.yml'>

```yml
version: 2
Expand All @@ -42,22 +44,26 @@ groups:
- name: finance
description: "Models related to the finance department"
owner:
# 'name' or 'email' is required
# Email is required to receive model-level notifications, additional properties are also allowed.
name: "Finance Team"
email: [email protected]
slack: finance-data
favorite_food: donuts

- name: marketing
description: "Models related to the marketing department"
owner:
name: "Marketing Team"
email: [email protected]
slack: marketing-data
favorite_food: jaffles
```
## Set up models
</File>
## Attach groups to models
Attach groups to models as you would any other config, in either the `dbt_project.yml` or `<whatever>.yml` files. For example:

Set up your model configuration in either the `dbt_project.yml` or `groups.yml` file; doing this automatically sets up notifications for tests, too. For example:
<File name='models/marts.yml'>

```yml
version: 2
Expand All @@ -74,6 +80,32 @@ models:
group: marketing
```
</File>

By assigning groups in the `dbt_project.yml` file, you can capture all models in a subdirectory at once. In the below example, all notifications related to staging models will go to the data engineering group, whereas models in `marts/sales` will be routed to the finance team.

<File name='dbt_project.yml'>

```yml
config-version: 2
name: "jaffle_shop"
[...]
models:
jaffle_shop:
staging:
+group: data_engineering
marts:
sales:
+group: finance
campaigns:
+group: marketing
```

</File>
Attaching a group to a model also encompasses its tests, so you will also receive notifications for a model's test failures.

## Enable access to model notifications

Expand Down

0 comments on commit 1b65a40

Please sign in to comment.