Skip to main content
Version: 1.15.0

Alert about failures

Keep yourself and your stakeholders informed about Expectation failures by configuring alerts in GX Cloud. When a Validation run fails, GX Cloud will send notifications according to your alert settings. Notifications provide high-level information about how many Expectations failed and include a link to detailed Validation Results, where you can investigate the failures to determine next steps.

Alerts are configured at the Data Asset level. A single Data Asset can have multiple alerts configured. An alert can be configured to notify about all Expectation failures or only failures of certain severities.

Alerts can send notifications to email addresses or notifications with @mentions to public Slack channels. Note that to enable @mentions for Slack, your GX Cloud workspace must be integrated with Slack.

More integrations are coming soon

Integrations for Jira, Microsoft Teams, PagerDuty, and ServiceNow are coming soon. In the meantime, you can use email alerts as described below. Contact us to learn more or to request a different integration.

To keep your email alerts secure, your GX Cloud organization has an allowlist of email domains that all alert recipient email addresses must belong to. By default, this includes the email domain of the Organization Owner who created the organization and domains for sending email notifications to the following third-party services: Microsoft Teams, PagerDuty, and ServiceNow.

Here is an example of how a team might configure alerts on their Data Assets to make sure the right people get the right information at the right time.

Silver Data Asset has 3 alerts configured - Data team awareness alert sends notifications about info and warning failures to data@my-company.com, Data team urgent alert sends notifications about critical failures to the Slack channel #data-team pinging @data-engineers, and Sales alert sends notifications about warning and critical failures to sales-managers@my-company.com. Gold Data Asset has 2 alerts configured - Rapid response alert sends notifications about all failures to the Slack channel #data-team pinging @on-call-data and to the #analytics channel pinging @alex and @bela; meanwhile the Marketing alert sends notifications about critical failures to marketing@my-company.com, contractors@contractor-company.com, and the Slack channel #campaign-alerts.

Note that you must have Workspace Editor permissions or greater to manage alerts.

Create an alert​

  1. In the GX Cloud UI, select the relevant Workspace and then click Data Assets.
  2. In the Data Assets list, click the Data Asset name.
  3. Click Settings.
  4. In the Alerts section, click + ADD.
  5. In the Alert name field, enter a name for the alert that will help you quickly identify it later.
  6. Under Severity, select one or more failure severities for the alert to notify about.
  7. To alert an email address, do the following. Under Recipients, next to Emails, click + and enter an email address for the alert to send notifications to. Note that the domain of the email address must belong to your organization’s email domain allowlist. By default, the following third-party domains are allowed for email notifications to third-party services.
  8. To alert a Slack channel, do the following. First, make sure your GX Cloud workspace is integrated with Slack. Then, under Recipients, next to Slack channels, click + and select a channel for the alert to send notifications to. After selecting the channel, you will have the option to specify @mentions to include in the notification message. You can mention any user or user group in your Slack workspace.
  9. Optional. To send the same notification to another recipient, click + and enter another email address or Slack channel. Repeat as needed.
  10. Click Save.

Edit an alert​

  1. In the GX Cloud UI, select the relevant Workspace and then click Data Assets.
  2. In the Data Assets list, click the Data Asset name.
  3. Click Settings.
  4. In the Alerts section, find the alert that you want to edit.
  5. Click pencil icon Edit alert for the alert that you want to edit.
  6. Edit the alert configuration.
  7. Click Save.

Disable or enable an alert​

If you want to temporarily stop an alert from sending notifications, you can disable it instead of deleting it. This makes it easier to restore the alert when you’re ready for it to start sending notifications again.

  1. In the GX Cloud UI, select the relevant Workspace and then click Data Assets.
  2. In the Data Assets list, click the Data Asset name.
  3. Click Settings.
  4. In the Alerts section, find the alert that you want to disable or enable.
  5. Click the ON / OFF toggle switch to disable or enable the alert.

Delete an alert​

  1. In the GX Cloud UI, select the relevant Workspace and then click Data Assets.
  2. In the Data Assets list, click the Data Asset name.
  3. Click Settings.
  4. In the Alerts section, find the alert that you want to delete.
  5. Click trash icon Delete alert for the alert that you want to delete.
  6. Click Delete.

Update your organization’s email domain allowlist​

By default, your organization’s email domain allowlist includes the following:

  • The email domain of the Organization Owner who created the organization
  • *.teams.ms
  • *.pagerduty.com
  • *.service-now.com

If your organization has SSO configured, all of your SSO domains will also be included in your email domain allowlist.

To request changes to your organization’s email domain allowlist, have an Organization Owner contact support.