Ask AI

You are viewing an unreleased or outdated version of the documentation

Managing alert policies in Dagster+#

This guide is applicable to Dagster+.

In this guide, we'll walk you through managing alert policies in Dagster+.

Prefer to work in code? You can also define and set alert policies using the dagster-cloud CLI.


Prerequisites#

To follow the steps in this guide, you'll need:

  • Organization, Admin, or Editor permissions in Dagster+, which are required to create and manage alerts
  • Optional: If using an integration like Microsoft Teams or Slack as a notification service, complete the integration setup before proceeding. Refer to the Supported notification services for a complete list of integrations.

Creating alert policies#

  1. Sign in to your Dagster+ account.

  2. In the top navigation, click Deployment.

  3. Click the Alerts tab.

  4. Click + Create alert policy.

  5. In the Create alert policy window, select an alert type and enter a name and description for the alert.

  6. If creating an asset or run alert policy, you'll be prompted to fill in the following:

    Asset alert policies
    • Target - Select the assets that the alert targets:
      • All assets - All assets in the deployment
      • Group - All assets in a specific asset group in the deployment
      • Asset key - A specific asset key in the deployment
    • Events - Select the event(s) that should trigger the alert. For example: asset materialization failure, asset check passed.
    Run alert policies
    • Tags - Add tag(s) for the alert policy. Jobs with these tags will trigger the alert. For example: level:critical or team:sales
    • Events - Select whether the alert should trigger on job success, failure, or both
  7. In the Notification service section, select how the alert will be delivered. Refer to the Supported notification services section for information about setting up these services.

    Note: If creating an asset alert, an additional Email asset owners (experimental) option will be available.

  8. When finished, click Save policy.


Editing alert policies#

Editing a single policy#

  1. Click the Edit button to the right of the policy.
  2. Make changes as desired.
  3. When finished, click Save policy to save the changes.

Editing policies in bulk#

You can also edit policies in bulk by making changes to the policies' underlying YAML.

  1. Click ⌄ (More actions) > Edit policies, which is next to the Create alert policy button:

    Highlighted More Actions menu in the Dagster+ UI

    This will open a window displaying all alert policies in YAML format:

    Editing YAML for multiple alert policies
  2. Make changes as desired.

  3. When finished, click Save Schema to save the changes.


Enabling and disabling alert policies#

To enable or disable an alert, use the toggle on the left side of the alert policy.


Deleting alert policies#

To delete an alert policy, click the Delete button next to the policy. When prompted, confirm the deletion.