diff --git a/src/connections/reverse-etl/images/mapping-alerting.jpeg b/src/connections/reverse-etl/images/mapping-alerting.jpeg new file mode 100644 index 0000000000..a8d643e9b8 Binary files /dev/null and b/src/connections/reverse-etl/images/mapping-alerting.jpeg differ diff --git a/src/connections/reverse-etl/manage-retl.md b/src/connections/reverse-etl/manage-retl.md index b03b681ad5..925283fab9 100644 --- a/src/connections/reverse-etl/manage-retl.md +++ b/src/connections/reverse-etl/manage-retl.md @@ -53,9 +53,12 @@ To reset a sync: You can choose to replay syncs. To replay a specific sync, contact [friends@segment.com](mailto:friends@segment.com). Keep in mind that triggering a replay resyncs all records for a given sync. ## Alerting -You can opt in to receive email, Slack, and in-app alerts about Reverse ETL sync failures and partial successes. +You can opt in to receive email, Slack, and in-app alerts about Reverse ETL sync failures and fluctuations in the volume of events successfully delivered to your mapping. -To subscribe to alerts: +The notification channels that you select for one alert will apply to all alerts in your workspace. + +### Failed or partially successful syncs +To subscribe to alerts for a failed or partially successful sync: 1. Navigate to **Settings > User Preferences**. 2. Select **Reverse ETL** in the **Activity Notifications** section. 3. Click the Reverse ETL sync status that you'd like to receive notifications for. You can select one or more of the following sync statuses: @@ -69,3 +72,42 @@ To subscribe to alerts: > success "" > If you opted to receive notifications by email, you can click **View active email addresses** to see the email addresses that are currently signed up to receive notifications. + + + +### Mapping-level successful delivery rate fluctuations + +You can create an alert that notifies you when the volume of events successfully received by your mapping in the last 24 hours falls below a percentage you set. For example, if you set a percentage of 99%, Segment notifies you if your destination had a successful delivery rate of 98% or below. + +To receive a successful delivery rate fluctuation alert in a Slack channel, you must first create a Slack webhook. For more information about Slack webhooks, see Slack's [Sending messages using incoming webhooks](https://api.slack.com/messaging/webhooks){:target="_blank”} documentation. + +![A screenshot of the Alerts tab for a Mapping, with the new mapping sidesheet partially filled out.](images/mapping-alerting.jpeg) + +To subscribe to alerts for successful delivery fluctuations at the mapping level: +1. Navigate to your intended mapping and select the **Alerts** tab. +2. Click **Create alert**. +3. Set an *alert threshold*, or the percentage of successfully delivered events that would prompt an alert. +4. Select one or more of the following notification channels: + - **Email**: Enter an email address or alias that should receive alerts. + - **Slack notification**: Enter a Webhook URL and a Slack channel name to receive alerts in a Slack channel. + - **In-app notifications**: Select this to receive notifications in the Segment app. To view your notifications, select the bell next to your user icon in the Segment app. +5. Toggle the **Enable alert** setting on and click **Create**. + +To edit or disable your alert, navigate to your mapping's Alerts tab and select the Actions menu for the alert you'd like to edit.