diff --git a/docs/content/dagster-cloud/managing-deployments/setting-up-alerts.mdx b/docs/content/dagster-cloud/managing-deployments/setting-up-alerts.mdx index 3a5d81bc83ecb..83ac0e596f555 100644 --- a/docs/content/dagster-cloud/managing-deployments/setting-up-alerts.mdx +++ b/docs/content/dagster-cloud/managing-deployments/setting-up-alerts.mdx @@ -8,6 +8,12 @@ title: "Setting up alerts in Dagster Cloud | Dagster Docs" In this guide, we'll walk you through configuring alerts in Dagster Cloud. +Dagster Cloud can send alerts to: + +- Email +- Slack +- Microsoft Teams + --- ## Understanding alert policies @@ -22,8 +28,6 @@ Alert policies define which events will trigger an alert, the conditions under w Alert policies are configured on a per-deployment basis. For example, asset alerts configured in a `prod` deployment are only applicable to assets in that deployment. -Currently, Slack and email notifications are supported. - --- ## Managing alert policies in Dagster Cloud @@ -96,6 +100,17 @@ Currently, Slack and email notifications are supported. height={514} /> + - **Microsoft Teams** - Send alerts to Teams incoming webhooks. + + First, follow the instructions in the [Microsoft Teams documentation](https://docs.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/how-to/add-incoming-webhook) to create an incoming webhook. Then, paste the url into the alert form. + + Microsoft Teams alert configured with a webhook url + 7. When finished, click **Save policy**. ### Editing alert policies @@ -216,6 +231,26 @@ alert_policies: - "nelson.bighetti@hooli.com" ``` +### Configuring a Microsoft Teams alert policy + +In this example, we'll configure a Teams alert for when a Hybrid Agent goes down. + +```yaml +alert_policies: + - name: "email-alert-policy" + description: "An alert policy to email company executives during job failure." + tags: + - key: "level" + value: "critical" + event_types: + - "AGENT_UNAVAILABLE" + notification_service: + microsoft_teams: + webhook_url: "https://yourdomain.webhook.office.com/..." +``` + +If the agent stops heartbeating, a message will be sent via the [incoming webhook URL](https://docs.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/how-to/add-incoming-webhook). + --- ### Compatible event types diff --git a/docs/next/public/images/dagster-cloud/alerts/cloud-ms-teams-alert-creation.png b/docs/next/public/images/dagster-cloud/alerts/cloud-ms-teams-alert-creation.png new file mode 100644 index 0000000000000..8e238899532fa Binary files /dev/null and b/docs/next/public/images/dagster-cloud/alerts/cloud-ms-teams-alert-creation.png differ