Overview
Through the centralized Alerts UI you are able to configure alerts based on core sending metrics as well as configure notifications settings for the Mailgun Optimize and Mailgun Validate products.
Important Note:
Please be aware that Alerts are configured by region (Mailgun US or Mailgun EU). Alerts can operate on both regions concurrently, but for each region, you will need to perform the steps configuring notification channels and setting up alerts.
Configuring channel settings for alerts
To configure Mailgun send alerts, navigate to the Alerts option in Mailgun and start configuration by setting up your notification channels.
We'll show you how to do this below:
- First, log in to the Mailgun Control Panel (if you have not already done so).
- Then, at the top-right corner of the page, click the Profile drop-down menu to expand its list of options.
- Next, click the Alerts option. Alternatively, you can use this direct link.
-
Click the Channel Settings button on the following page.
- This will open the notification channel settings slide-out menu to set up your channels.
- Available channels include email, Slack, and webhook.
- Accounts have the option to define all 3 channels.
Configuring Send alerts
Once channel settings are configured, you can move to create your first alert, most likely a Send Alert. Send alerts can be configured for thresholds pertaining to the Complaint Rate, Hard Bounce Rate, Temporary Fail Rate, and/or Delivery Rate.
To configure Send Alerts:
- First, log in to the Mailgun Control Panel (if you have not already done so).
- Then, at the top-right corner of the page, click the Profile drop-down menu to expand its list of options.
-
Next, click the Alerts option. Alternatively, you can use this direct link.
-
Select the Send tab (if you are not taken here by default).
-
Click Channel Settings and configure your notification channels.
Available channels include email, Slack, and webhooks.
-
See section "Configuring channel settings for alerts" above for more details.
-
Configure the Send Alert.
-
Click the Setup Alert button on the right-side of page.
-
Enter the alert information in the alert panel.
From this menu you will name your alert, define the metric for monitoring, the notification channels to be used, the conditions of the monitor, and filtering.
Note: you can set a max of 10 filters per alert.
Click the Setup button.
-
Configuring Optimize and Validate alerts
Primary account users can configure alerts to receive notifications when various Optimize and Validate products encounter status changes with IPs, domains, seed lists, or email validation lists.
To configure Optimize & Validate Alerts:
- First, log in to the Mailgun Control Panel (if you have not already done so).
- Then, at the top-right corner of the page, click the Profile drop-down menu to expand its list of options.
-
Next, click the Alerts option. Alternatively, you can use this direct link.
-
Select the Optimize/Validate tab.
-
Configure the Optimize & Validate Alert(s).
Click the triple elipsis icon on the right-side of the alert row or find the Setup hyperlink in the Channel column (only displayed when an existing alert is not currently configured).
-
Select the Setup option.
-
Enter the alert information in the alert panel.
Click the Setup button.
Configuring Subaccount Alerts
Primary account users can configure alerts to receive notifications when a subaccount reaches specified usage thresholds for its configured limits.
To configure Subaccount Feature Limit Alerts:
- First, log in to the Mailgun Control Panel (if you have not already done so).
- Then, at the top-right corner of the page, click the Profile drop-down menu to expand its list of options.
-
Next, click the Alerts option. Alternatively, you can use this direct link.
-
Select the Account tab.
-
Click Channel Settings and configure your notification channels.
Available channels include email, Slack, and webhooks.
-
See section "Configuring channel settings for alerts" above for more details.
-
Configure the Subaccount Feature Limit Alert.
Click the triple elipsis icon on the right-side of the alert row.
Select the Edit option.
-
Enter the alert information in the alert panel.
Click the Save button.
-
Enable the Subaccount Feature Limit Alert.
Click the triple elipsis icon on the right-side of the alert row.
-
Select the Enable option.
Click the Enable button in the pop-up modal
Alerts are available for the following usage limits:
Messages Sent
Email Previews
Email Validations
Inbox Placement Tests
By default, alerts are triggered at 50%, 75%, and 100% of the configured limit. Admin users can edit the 50% and 75% thresholds. The 100% threshold cannot be modified.
Note:
A usage limit must be configured for a subaccount before the alert can trigger.
Need Support?
Our Support Team here at Sinch Mailgun is happy to help! Reach out to us in the Support page of your Mailgun Control Panel, and we'll be with you shortly!