Slack

Slack is a messaging app for business that connects people to the information they need. By bringing people together to work as one unified team, Slack transforms the way organizations communicate.

Metaplane's app for Slack

Metaplane's app for Slack makes it simple for data teams to receive alerts when data issues occur. You can easily route alerts to multiple channels based on rules such as specific data warehouse schemas, tables, and columns. Here is an example of the type of alert that can be sent to your team:

An example of Metaplane sending a freshness alert for an important table in the data warehouse.An example of Metaplane sending a freshness alert for an important table in the data warehouse.

An example of Metaplane sending a freshness alert for an important table in the data warehouse.

Connecting Metaplane's app for Slack

To connect Metaplane's app for Slack, visit the connections page , click on "Add Connection" in the top right hand corner.

Then scroll and select the Slack icon:

This will bring you through an authorization flow and may require a workspace admin to approve the request.

Once you have connected to Slack, you will be redirected to Metaplane. You can select a Slack channel from the dropdown. For organizations with a large number of Slack channels, you may have to manually enter the Slack channel to send alerts to.

Alert routing

Metaplane provides a flexible means of routing alerts based on rules such as the type of alert as well as the alert's content. For example, you can send alerts for a specific database, schema, table, column or custom test to the teams that own those various assets.

In the example above, the #analytics-alerts channel is configured to only get alerted of schema changes and incidents related to analytics assets while #data-awareness is notified of broader alerts.

Configuring a Slack channel alert destination

After connecting Slack, simply visit the Alerts page and choose "+ Add channel".

Configuring alert rules

Once you've added a Slack channel as an alert destination, you can then configure rules that describe how you'd like for Metaplane alerts to get routed.

There are 2 types of alerts:

  1. Incident alerts
  2. Schema change alerts

Incident alerts

Incident alerts are sent when Metaplane has detected data quality issues.

To configure rules for this type of alert click the "+ Add incident rule" button.

You can then configure the rule, e.g., send alerts to this Slack channel for an entire schema or dbt project.

Schema change alerts

Schema change alerts are sent when Metaplane has detected a schema change.

To configure rules for this type of alert click the "+ Add schema change rule" button.

In the example above, changes related to schemas that start with "tmp_" will be filtered out of the schema change alert.

Creating a rule set using the default, unmodified, rules will perform no filtering on the schema change rules.

Schema changes can also be viewed from the the Schema changes page. If you'd like to learn more about how to configure schema changes, head over to the Configure schema changes page.

Private channels

If the channel you'd like to connect is private, it will not appear in the channel dropdown. You'll need to add the Metaplane bot to the desired channel first, and then set the desired channel in Metaplane.

To add the Metaplane bot to your private channel, connect Metaplane to your Slack workspace via the instructions above. Then, add the bot to the channel by typing @Metaplane Notifications in the channel, and clicking to invite the bot in.

Once the bot is in the channel, come back to Metaplane and set the channel name.

Disconnecting Metaplane's app for Slack

If you would like to disconnect Metaplane's app for Slack, you can remove it from your Slack workspace, or you can visit the Alerts page and click the "Disconnect Slack" button in the top right hand corner.