Microsoft Teams & Dagster Cloud#

This guide is applicable to Dagster Cloud.

Dagster Cloud supports sending alerts to Microsoft Teams using incoming webhooks.

Prerequisites#

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

Permissions in Microsoft Teams that allow you to create an incoming webhook
Organization, Admin, or Editor permissions in Dagster Cloud, which are required to create and manage alerts

Step 1: Create an incoming webhook in Microsoft Teams#

To create an incoming webhook, follow the instructions in the Microsoft Teams documentation.

Keep the webhook URL handy - you'll need it in the next step.

Step 2: Create an alert policy in Dagster Cloud#

Creating an alert policy can be done using the Dagster Cloud UI or the dagster-cloud CLI and a YAML file.

In the UI#

Create and configure an alert policy. Refer to the Managing alerts in Dagster Cloud guide for more info.
In the Notification Service section of the Create alert policy window, select the Microsoft Teams option.
Paste the Microsoft Teams webhook URL into the field that displays.
Click Save policy.

dagster-cloud CLI#

To define a Microsoft Teams alert policy in code, use the notification_service.microsoft_teams.webhook_url key to provide the webhook URL. For example:


# alert_policies.yaml

alert_policies:
  - name: "ms-teams-alert-policy"
    description: "An alert policy to send a Microsoft Teams webhook during job failure."
    tags:
      - key: "level"
        value: "critical"
    event_types:
      - "AGENT_UNAVAILABLE"
    notification_service:
      microsoft_teams:
        webhook_url: "https://yourdomain.webhook.office.com/..."

Then, use the dagster-cloud CLI to set the alert policies for the deployment:


dagster-cloud deployment alert-policies sync -a /path/to/alert_policies.yaml

Refer to the Managing alerts using the dagster-cloud CLI guide for more information.