• Monitoring and Alerts >
• Configure Alert Settings

Configure Alert Settings

For each organization and project, you can select which conditions trigger alerts and how users are notified.

Note

M0 Free Tier and M2/M5 shared starter clusters only trigger alerts related to the metrics supported by those clusters. See Atlas M0 (Free Tier), M2, and M5 Limitations for complete documentation on M0/M2/M5 alert and metric limitations.

Prerequisites

IP Addresses and CIDR Blocks for Alert Webhooks

You have the option to configure alerts to be delivered via webhook. This sends an HTTP POST request to an endpoint for programmatic processing.

If you want to successfully deliver a webhook to the specified endpoint, the endpoint must accept incoming HTTP POST from the following IP addresses and CIDR blocks:

• 107.20.0.247
• 18.210.185.2
• 18.210.245.203
• 18.214.178.145
• 18.235.145.62
• 18.235.48.235
• 34.192.82.120
• 34.233.152.179
• 34.233.179.140
• 34.235.52.68
• 35.171.106.60
• 35.172.148.213
• 35.172.245.18
• 35.174.179.65
• 35.174.230.146
• 35.175.94.38
• 52.206.222.245
• 52.21.89.200
• 52.87.98.128
• 54.173.82.137
• 54.175.147.155
• 4.71.186.128/25
• 4.35.16.128/25

• Organization Alerts
• Project Alerts

Default Alert Settings

Atlas provides no default alerts for organizations.

Atlas provides the following default alerts for a new project:

• Replica set has no primary
• Cluster is missing an active mongos
• Disk space % used on Data Partition is
• Disk I/O % utilization on Data Partition is
• User joined the project
• Credit card is about to expire
• Query Targeting: Scanned Objects / Returned
• Connections % of configured limit is
• System: CPU (Steal) % is
• System: CPU (User) % is

Atlas provides the following default alert for projects using Customer Key Management with AWS KMS:

• AWS encryption key elapsed time since last rotation is above 365 days

Notification Options

When you configure an alert, you select how notifications are sent. You can select multiple notification methods, such as email, text message, or team collaboration tools.

Atlas supports Slack as a notification method. From the organization’s Settings menu, click Add to Slack in Slack Settings and log in to your preferred Slack workspace.

Atlas supports configuring all of the following notification methods during alert configuration:

• PagerDuty
• Flowdock
• HipChat
• DataDog
• Webhook
• VictorOps
• OpsGenie

When you configure an alert, you select how notifications are sent. You can select multiple notification methods, such as email, text message, or team collaboration tools.

To use certain notification methods, you must first set up notification methods in the project’s Settings. If the notification method’s value becomes invalid, Atlas sends an email to the project owner. The following notification methods require set up in the Project’s‘ Settings:

• PagerDuty
• Flowdock
• HipChat
• DataDog
• Slack
• Webhook
• VictorOps
• OpsGenie

Configure an Alert

When you create a new alert, you can clone an existing alert.

1

Click Alerts in the Project section of the left navigation.

2

Choose whether to create a new alert setting or clone an existing one.

To create a new alert:

1. Click Add Alert.

To clone an existing alert setting:

1. Click the Alert Settings tab.
2. Locate the alert setting you want to clone.
3. Click ellipsis h icon then Clone in that alert setting’s row.

3

Choose the Target.

Click User or Billing under Select a Target.

4

Choose the Condition.

Under Select a Condition:

• If you chose User, select:
  • User(s) in the organization do not have 2FA enabled
  • User has joined the organization
  • User has left the organization
  • User's role has been changed
• If you chose Billing:
  1. Select:
     • Credit card is about to expire
     • Monthly pending invoice total is above
     • Daily amount billed is above
  2. If above threshold $ appears, specify the amount in USD where Atlas should trigger the alert if any project in the organization exceeds that value.

5

Select the Notification Method.

Under the Add Notification Method heading, click the button for the particular notification method you want to use.

Notification Option	User Alerts	Billing Alerts	Description
Atlas Organization	check icon	check icon	Sends the alert by email or text message to users with specific roles in the Organization. Select the Organization roles that should receive the alerts from the Select Role(s) check boxes or select All Roles for all users in the Organization to receive the alert. Select SMS to send these alerts to the mobile number configured for each Atlas Organization user in their Account page. Select Email to send these alerts to the email address configured for each Atlas Organization user in their Account page. Email is checked by default.
Atlas User	check icon	check icon	Sends the alert by email or text message to a specified Atlas user. Select SMS to send these alerts to the mobile number configured for the Atlas user in their Account page. Select Email to send these alerts to the email address configured for the Atlas user in their Account page. Email is checked by default.
Email	check icon	check icon	Sends the alert to any email address you provide.
Mobile Number	check icon	check icon	Sends the alert to a mobile number. Atlas removes all punctuation and letters and uses only the digits. If you are outside of the United States or Canada, include 011 and the country code because Atlas uses the U.S.-based Twilio to send text messages. As an alternative to your non-U.S. telephone number, use a Google Voice telephone number. Example For New Zealand enter 01164 before the phone number.
HipChat	check icon	check icon	Sends the alert to a HipChat room message stream. Enter the HipChat room name and API token.
Slack	check icon	check icon	Sends the alert to a Slack channel in the authorized Slack workplace for the Organization. To learn more about Slack authorization, see Authorize Slack to Receive Organization Alerts. Enter the channel name.
Flowdock	check icon	check icon	Sends the alert to a Flowdock account. Enter the following: Org Name: The Flowdock organization name in lower-case letters. This is the name that appears after www.flowdock.com/app/ in the URL string. Flow Name: The flow name in lower-case letters. The flow name appears after the organization name in the URL string: www.flowdock.com/app/<organization-name>/<flow-name> User API Token: Your Flowdock personal API token found on the https://www.flowdock.com/account/tokens page of your Flowdock account.
PagerDuty		check icon	Sends the alert to a PagerDuty account. Enter only the PagerDuty service key. Define escalation rules and alert assignments directly in PagerDuty. This option is available only for alerts that require acknowledegment. Informational alerts, such as the alert that a Atlas user has joined a project, cannot use this notification method. Atlas users can acknowledge PagerDuty alerts only from the PagerDuty dashboard.
DataDog	check icon	check icon	Sends the alert to a DataDog account as a DataDog event. When the alert is first opened, Atlas sends the alert as an “error” event. Subsequent updates are sent as “info” events. When the alert is closed, Atlas sends a “success” event. If prompted, enter your DataDog API key under API Key and click Validate Datadog API Key.
VictorOps		check icon	Sends the alert to a VictorOps account. Enter a VictorOps API key and an optional routing key for routing alerts to a specific VictorOps group. Define escalation and routing rules directly in VictorOps. Users can acknowledge VictorOps alerts only from the VictorOps dashboard.
OpsGenie		check icon	Sends the alert to an OpsGenie account. Enter only the OpsGenie API key. Define escalation rules and alert assignments directly in OpsGenie. Users can acknowledge OpsGenie alerts only from the OpsGenie dashboard.

6

Click Save.

1

Click Alerts in the Project section of the left navigation.

2

Choose whether to create a new alert setting or clone an existing one.

To create a new alert without cloning an existing setting:

1. Click Add.
2. Select New Alert.

To clone an existing alert setting:

1. Click the Alert Settings tab.
2. Locate the alert setting you want to clone.
3. Click ellipsis h icon then Clone in that alert setting’s row.

3

Select the condition that triggers the alert.

In the Alert if section, select the target component and the condition. To learn more about alert conditions, see Alert Conditions.

4

Apply the alert only to specific targets. (Optional)

If the options in the For section are available, you can optionally filter the alert to apply only to a subset of the targets.

The matches field can use regular expressions.

5

Select the alert recipients and delivery methods.

In the Send to section, click Add and select from the options described in the following table.

To help eliminate false positives, set the time to elapse before the condition triggers the alert.

Notification Option	Description
Atlas Project	Sends the alert by email or text message to users with specific roles in the Project. Select the Project roles that should receive the alerts from the Select Role(s) check boxes or select All Roles for all users in the Project to receive the alert. Select SMS to send these alerts to the mobile number configured for each Atlas Project user in their Account page. Select Email to send these alerts to the email address configured for each Atlas Project user in their Account page. Email is checked by default.
Atlas Organization	Sends the alert by email or text message to users with specific roles in the Organization. Select the Organization roles that should receive the alerts from the Select Role(s) check boxes or select All Roles for all users in the Organization to receive the alert. Select SMS to send these alerts to the mobile number configured for each Atlas Organization user in Account page. Select Email to send these alerts to the email address configured for each Atlas Organization user in Account page. Email is checked by default.
Atlas User	Sends the alert by email or text message to a specified Atlas user. Select SMS to send these alerts to the mobile number configured for the Atlas user in their Account page. Select Email to send these alerts to the email address configured for the Atlas user in their Account page. Email is checked by default.
Email	Sends the alert to an email address.
SMS	Sends the alert to a mobile number. Atlas removes all punctuation and letters and uses only the digits. If you are outside of the United States or Canada, include 011 and the country code because Atlas uses the U.S.-based Twilio to send text messages. As an alternative to your non-U.S. telephone number, use a Google Voice telephone number. Example For New Zealand enter 01164 before the phone number.
HipChat	Sends the alert to a HipChat room message stream. Enter the HipChat room name and API token.
Slack	Sends the alert to a Slack channel. Enter the channel name and either an API token or a Bot token. To create an API token, see the https://api.slack.com/web page in your Slack account. To learn more about Bot users in Slack, see https://api.slack.com/bot-users.
Flowdock	Sends the alert to a Flowdock account. Enter the following: Org Name: The Flowdock organization name in lower-case letters. This is the name that appears after www.flowdock.com/app/ in the URL string. Flow Name: The flow name in lower-case letters. The flow name appears after the organization name in the URL string: www.flowdock.com/app/<organization-name>/<flow-name> User API Token: Your Flowdock personal API token found on the https://www.flowdock.com/account/tokens page of your Flowdock account.
PagerDuty	Sends the alert to a PagerDuty account. Enter only the PagerDuty service key. Define escalation rules and alert assignments directly in PagerDuty. This option is available only for alerts that require acknowledegment. Informational alerts, such as the alert that a user has joined a project, cannot use this notification method. Users can acknowledge PagerDuty alerts only from the PagerDuty dashboard.
DataDog	Sends the alert to a DataDog account as a DataDog event. When the alert is first opened, Atlas sends the alert as an “error” event. Subsequent updates are sent as “info” events. When the alert is closed, Atlas sends a “success” event. If prompted, enter your DataDog API key under API Key and click Validate Datadog API Key.
VictorOps	Sends the alert to a VictorOps account. Enter a VictorOps API key and an optional routing key for routing alerts to a specific VictorOps group. Define escalation and routing rules directly in VictorOps. This option is available only for alerts that require acknowledgement. Informational alerts, such as the alert that a user has joined a project, cannot use this notification method. Users can acknowledge VictorOps alerts only from the VictorOps dashboard.
OpsGenie	Sends the alert to an OpsGenie account. Enter only the OpsGenie API key. Define escalation rules and alert assignments directly in OpsGenie. This option is available only for alerts that require acknowledgement. Informational alerts, such as the alert that a user has joined a project, cannot use this notification method. Users can acknowledge OpsGenie alerts only from the OpsGenie dashboard.
Webhook	Sends an HTTP POST request to an endpoint for programmatic processing. The request body contains a JSON document that uses the same format as the Atlas API’s Alerts resource. This option is available only if you have configured Webhook settings on the Project Settings page. To successfully deliver a webhook to the specified endpoint, the endpoint must accept incoming HTTP POST requests from the following IP addresses and CIDR blocks: 18.214.178.145 18.235.48.235 18.235.145.62 34.235.52.68 35.171.106.60 35.174.179.65 35.174.230.146 35.175.94.38 52.87.98.128 107.20.0.247 4.35.16.128/25 4.71.186.128/25 Important MongoDB reserves the right to change these IP addresses at any time without user notice.

6

Click Save.

Disable an Alert

1

Navigate to Alert Settings.

Click Alerts then Alert Settings.

2

Choose the alert setting to disable.

On the row for a specific alert, click ellipsis h icon then Disable.

Note

Click ellipsis h icon then Enable to re-enable the alert at any time.

If you disable an alert setting, Atlas cancels active alerts related to the setting. A disabled alert setting remains visible but grayed-out and can be later re-enabled.

Delete an Alert

1

Navigate to Alert Settings.

Click Alerts then Alert Settings.

2

Choose the alert setting to delete.

1. On the row for a specific alert, click ellipsis h icon then Delete.
2. Click Confirm in the Confirm Delete modal or click Cancel to leave the alert as configured.

If you delete an alert setting, Atlas cancels active alerts related to the setting. A deleted alert setting does not remain visible.

←   Respond to Alerts Alert Conditions  →

© MongoDB, Inc 2008-present. MongoDB, Mongo, and the leaf logo are registered trademarks of MongoDB, Inc.