Microsoft Teams & Dagster+#

This guide is applicable to Dagster+.

Dagster+ 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+, 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+#

Creating an alert policy can be done using the Dagster+ 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+ 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-plus deployment alert-policies sync -a /path/to/alert_policies.yaml