Notifications

Monte Carlo's framework for Notifications makes it easy to send the right alerts to a broad variety of different recipients, including Slack, Microsoft Teams, Email, PagerDuty, Webex, OpsGenie, Jira, ServiceNow, and webhooks.

Audiences

To send notifications, first create an audience. An audience is a named group of one or more recipients. For example, an audience could include just a single Slack channel. Or it could include two Slack channels, five email addresses, a Microsoft Teams channel, and a PagerDuty routing key.

Audiences can either be created from within Settings > Notifications, or from the Send Notifications section of monitor creation. They can be easily edited to add, remove, or change recipients.

Adding notifications to an audience

Once an audience is created, you can add it to any existing monitors, by setting their Audiences or Failure audiences properties.

To receive notifications about events related to jobs (Airflow, DBT models, etc.), you can add a notification rule. Click the + button in the Job notifications column in the Notifications tab to add a Job notification for that audience.

Receive monitor lifecycle notifications

You can be notified when monitors are enabled, disabled, or deleted by enabling theReceive notifications when a monitor is enabled, disabled, or deleted setting on any Slack, MS Teams, or email recipient channel when creating or editing an audience. From then on, any monitor with that audience applied will send monitor lifecycle events to that channel.

Viewing all your audiences

You can view all your audiences, their monitors and job notification settings, in Settings > Notifications.
Click on any of the numbers in the Monitors or Job notifications columns to see details of the associated monitors and job notification configurations.

GraphQL API

To create and manage new notifications, you should use the Audiences API.

Here's a simplified guide:

Create or Update Audiences:

• Use createOrUpdateAudience to define an audience by specifying its label and notification settings.
• Delete an audience with deleteMonitorLabel.
• Manage individual recipients within an audience using createOrUpdateAudienceNotificationSetting and deleteAudienceNotificationSetting.

Configure Audience Routing Rules:

• Use createOrUpdateAudienceRoutingRule to link a notification rule to an audience. This operation's parameters align with those in the rules field of createOrUpdateNotificationSetting.
• Remove a rule with deleteAudienceRoutingRule.