Configure Alert Settings
On this page
For each organization and project, you can select which conditions trigger alerts and how users are notified.
Note
M0
free clusters and M2/M5
shared clusters
only trigger alerts related to the metrics supported by
those clusters. See Atlas M0 (Free Cluster), M2, and M5 Limits for complete documentation
on M0/M2/M5
alert and metric limitations.
Required Access
To manage all organization alerts, you must have the
Organization Owner
role for the organization.
The Organization Billing Admin
role grants a
limited authorization to manage billing alerts.
To manage project alerts, you must have
Project Owner
access to the project. Users with
Organization Owner
access must add themselves to the project
as a Project Owner
.
Default Alert Settings
Atlas provides the following default alerts for a new project:
Query Targeting: Scanned Objects / Returned
Note
The default configuration sends an alert only if the ratio of documents scanned to documents returned meets or exceeds the specified threshold for at least 10 minutes.
Atlas provides the following default alert for projects using Manage Customer Keys with AWS KMS:
Atlas provides the following default alert for serverless instances:
Atlas provides no default alerts for organizations.
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.
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:
Atlas Project
Atlas Organization
Atlas User
Email
SMS
PagerDuty
Datadog
VictorOps
Opsgenie
Microsoft Teams
Webhook
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:
Atlas Organization
Atlas User
Email
SMS
PagerDuty
Datadog
VictorOps
Opsgenie
Microsoft Teams
Configure an Alert
When you create a new alert, you can clone an existing alert. You can also update an existing alert configuration.
Navigate to the Alerts page for your project.
If it is not already displayed, select the organization that contains your desired project from the Organizations menu in the navigation bar.
If it is not already displayed, select your desired project from the Projects menu in the navigation bar.
Click the Project Alerts icon in the navigation bar, or click Alerts in the sidebar.
Choose whether to create a new alert setting, clone an existing alert setting, or update an existing alert setting.
To create a new alert without cloning an existing setting:
Click Add.
Select New Alert.
To clone an existing alert setting:
Click the Alert Settings tab.
Locate the alert setting you want to clone.
Click then Clone in that alert setting's row.
To update an existing alert setting:
Click the Alert Settings tab.
Locate the alert setting you want to update.
Click then Edit in that alert setting's row.
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 Review Alert Conditions.
Select the alert recipients and delivery methods.
In the Send to section:
(Optional) To help reduce the false positives that Atlas sends, in the send if condition lasts at least field, specify the minutes to elapse before the condition sends the alert. The next alert check that runs after the specified time elapses sends the alert.
(Optional) In the resend after field, specify the minutes to elapse before the condition resends the alert.
Click Add and select from the options described in the following table.
Notification OptionDescriptionAtlas ProjectSends the alert by email or text message to users with specific roles in the Project.
Note
Atlas Project is the default alert recipient. You can configure the roles the alert is sent to and how it's delivered. You can't add a second Atlas Project as the recipient.
Atlas Project is available as an option in the Add list only if it is not currently in the recipients list.
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 OrganizationSends 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 UserSends 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.
EmailSends the alert to an email address.SMSSends 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.SlackSends 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.
Note
After you create a notification which requires an API or integration key, the key appears partially redacted when you:
View or edit the alert through the Atlas UI.
Query the alert for the notification through the Atlas Administration API.
PagerDutySends the alert to a PagerDuty account. Enter only the PagerDuty service key. Define escalation rules and alert assignments directly in PagerDuty.
Users can acknowledge PagerDuty alerts only from the PagerDuty dashboard.
Note
All new PagerDuty keys use their Events API v2.
If you have an Events API v1 key, you can continue to use that key with Atlas.
Note
After you create a notification which requires an API or integration key, the key appears partially redacted when you:
View or edit the alert through the Atlas UI.
Query the alert for the notification through the Atlas Administration API.
DatadogSends 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.
Enter your DataDog API key under API Key and click Validate Datadog API Key.
Enter your API region.
Atlas supports the following Datadog regions in the Atlas UI:
US1
US3
US5
EU1
AP1
Datadog uses
US1
by default.To learn more about Datadog's regions, see Datadog Sites.
Note
After you create a notification which requires an API or integration key, the key appears partially redacted when you:
View or edit the alert through the Atlas UI.
Query the alert for the notification through the Atlas Administration API.
VictorOpsSends the alert to a VictorOps account.
Enter the alphanumeric API key from VictorOps to integrate the VictorOps endpoint for alerts. Add dashes to the API key so it matches the format
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
. For example,489f7he7-790b-9896-a8cf-j4757def1161
. Enter an optional routing key to route alerts to a specific VictorOps group. Click Post Test Alert to test the VictorOps configuration. Define escalation and routing rules directly in VictorOps.This option is available only for alerts that require acknowledgement. You can recieve informational alerts from this third-party monitoring service in Atlas. However, you must resolve these alerts within the external service. Acknowledge VictorOps alerts from the VictorOps dashboard.
Note
After you create a notification which requires an API or integration key, the key appears partially redacted when you:
View or edit the alert through the Atlas UI.
Query the alert for the notification through the Atlas Administration API.
OpsgenieSends 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. You can recieve informational alerts from this third-party monitoring service in Atlas. However, you must resolve these alerts within the external service. Acknowledge Opsgenie alerts from the Opsgenie dashboard.
Note
After you create a notification which requires an API or integration key, the key appears partially redacted when you:
View or edit the alert through the Atlas UI.
Query the alert for the notification through the Atlas Administration API.
Microsoft TeamsSends the alert to a Microsoft Teams channel as an Adaptive Card.
To send alert notifications to a Microsoft Teams channel, you must create a Microsoft Teams incoming webhook. After creating the webhook, you can use the automatically generated URL to configure your Microsoft Teams integration in Atlas.
To setup the integration, see Integrate with Microsoft Teams.
Note
When you view or edit the alert for a Microsoft Teams notification, the URL appears partially redacted.
WebhookSends 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 Administration API Alerts resource.
This option is available only if you have configured Webhook settings on the Integrations page.
Note
When you view or edit the alert for a webhook notification, the URL appears partially redacted, and the secret appears completely redacted.
In the Webhook URL field, specify the target URL for webhook-based alerts.
(Optional) If you set up your Webhook integration with a secret, in the Webhook Secret field, specify the authentication secret for webhook-based alerts.
To create one alert configuration in the specified project using the Atlas CLI, run the following command:
atlas alerts settings create [options]
To update one alert configuration in the specified project using the Atlas CLI, run the following command:
atlas alerts settings update <alertConfigId> [options]
To learn more about the syntax and parameters for the previous commands, see the Atlas CLI documentation for atlas alerts settings create and atlas alerts settings-update.
Tip
See: Related Links
To list available field types for alert configurations using the Atlas CLI, run the following command:
atlas alerts settings fields type [options]
To learn more about the command syntax and parameters, see the Atlas CLI documentation for atlas alerts settings fields type.
Tip
See: Related Links
Choose whether to create a new alert setting, clone an existing alert setting, or update an existing alert setting.
To create a new alert:
Click Add Alert.
To clone an existing alert setting:
Click the Alert Settings tab.
Locate the alert setting you want to clone.
Click then Clone in that alert setting's row.
To update an existing alert setting:
Click the Alert Settings tab.
Locate the alert setting you want to update.
Click then Edit in that alert setting's row.
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 | Sends the alert by email or text message to users with specific roles in the Organization.
| ||
Atlas User | Sends the alert by email or text message to a specified Atlas user.
| ||
Email | Sends the alert to any email address you provide. | ||
Mobile Number | 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 ExampleFor New Zealand enter | ||
Slack | 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. NoteAfter you create a notification which requires an API or integration key, the key appears partially redacted when you:
| ||
PagerDuty | Sends the alert to a PagerDuty account. Enter only the PagerDuty service key. Define escalation rules and alert assignments directly in PagerDuty. Acknowledge PagerDuty alerts from the PagerDuty dashboard. NoteAll new PagerDuty keys use their Events API v2. If you have an Events API v1 key, you can continue to use that key with Atlas. NoteAfter you create a notification which requires an API or integration key, the key appears partially redacted when you:
| ||
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.
NoteAfter you create a notification which requires an API or integration key, the key appears partially redacted when you:
| ||
VictorOps | Sends the alert to a VictorOps account. Enter the alphanumeric
API key
from VictorOps to integrate the VictorOps endpoint for alerts. Add dashes
to the API key so it matches the format This option is available only for alerts that you must acknowledge. You can recieve informational alerts from this third-party monitoring service in Atlas. However, you must resolve these alerts within the external service. Acknowledge VictorOps alerts from the VictorOps dashboard. NoteAfter you create a notification which requires an API or integration key, the key appears partially redacted when you:
| ||
Opsgenie | Sends the alert to an Opsgenie account. Enter only the Opsgenie API key from an Opsgenie REST API integration. Define escalation rules and alert assignments in Opsgenie. This option is available only for alerts that you must acknowledge. You can recieve informational alerts from this third-party monitoring service in Atlas. However, you must resolve these alerts within the external service. Acknowledge Opsgenie alerts from the Opsgenie dashboard. NoteAfter you create a notification which requires an API or integration key, the key appears partially redacted when you:
| ||
Microsoft Teams | Sends the alert to a Microsoft Teams channel. You can view these alerts in the Adaptive Card displayed in your channel. To send alert notifications to a Microsoft Teams channel, you must create a Microsoft Teams incoming webhook. After creating the webhook, you can use the automatically generated URL to configure your Microsoft Teams integration in Atlas. To setup the integration, see Integrate with Microsoft Teams. NoteWhen you view or edit the alert for a Microsoft Teams notification, the URL appears partially redacted. |
Configure a Maintenance Window Alert
You can configure Maintenance Window Alerts for projects with configured maintenance windows.
Navigate to the Alerts page for your project.
If it is not already displayed, select the organization that contains your desired project from the Organizations menu in the navigation bar.
If it is not already displayed, select your desired project from the Projects menu in the navigation bar.
Click the Project Alerts icon in the navigation bar, or click Alerts in the sidebar.
Select the alert recipients and delivery methods.
In the Send to section, click Add and select from the options described in the following table.
Notification Option | Description |
---|---|
Atlas Project | Sends the alert by email or text message to users with specific roles in the Project. NoteAtlas Project is the default alert recipient. You can configure the roles the alert is sent to and how it's delivered. You can't add a second Atlas Project as the recipient. Atlas Project is available as an option in the Add list only if it is not currently in the recipients list.
|
Atlas Organization | Sends the alert by email or text message to users with specific roles in the Organization.
|
Atlas User | Sends the alert by email or text message to a specified Atlas user.
|
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 ExampleFor New Zealand enter |
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. NoteAfter you create a notification which requires an API or integration key, the key appears partially redacted when you:
|
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 Administration API Alerts resource. This option is available only if you have configured Webhook settings on the Integrations page. NoteWhen you view or edit the alert for a webhook notification, the URL appears partially redacted, and the secret appears completely redacted.
|
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.
NoteAfter you create a notification which requires an API or integration key, the key appears partially redacted when you:
|
Microsoft Teams | Sends the alert to a Microsoft Teams channel as an Adaptive Card. To send alert notifications to a Microsoft Teams channel, you must create a Microsoft Teams incoming webhook. After creating the webhook, you can use the automatically generated URL to configure your Microsoft Teams integration in Atlas. To setup the integration, see Integrate with Microsoft Teams. NoteWhen you view or edit the alert for a Microsoft Teams notification, the URL appears partially redacted. |
View Alert Configurations
You can view open alerts, closed alerts, and alert settings on the Project Alerts page. Atlas sends notifications for all alerts that appear on the Open tab. To learn more, see Alerts Workflow.
To view your alert configurations, navigate to the Alerts page for your project using the following steps:
To list all alert configurations for the specified project using the Atlas CLI, run the following command:
atlas alerts settings list [options]
To return the details for the specified alert settings for your project using the Atlas CLI, run the following command:
atlas alerts settings describe <alertConfigId> [options]
To learn more about the syntax and parameters for the previous commands, see the Atlas CLI documentation for atlas alerts settings list and atlas alerts settings describe.
Tip
See: Related Links
You can view all alerts, alert settings, and deleted alerts on the Organization Alerts page. To learn more, see Alerts Workflow.
To view your alert configurations, navigate to the Alerts page for your organization using the following steps:
Disable an Alert
Navigate to the Alerts page for your project.
If it is not already displayed, select the organization that contains your desired project from the Organizations menu in the navigation bar.
If it is not already displayed, select your desired project from the Projects menu in the navigation bar.
Click the Project Alerts icon in the navigation bar, or click Alerts in the sidebar.
If you disable an alert setting, Atlas cancels active alerts related to the setting. A disabled alert setting remains visible but grayed-out. You can re-enable it at any time.
To disable one alert configuration in the specified project using the Atlas CLI, run the following command:
atlas alerts settings disable <alertConfigId> [options]
To learn more about the command syntax and parameters, see the Atlas CLI documentation for atlas alerts settings disable.
Tip
See: Related Links
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.
Enable an Alert
To enable an alert that you previously disabled:
Navigate to the Alerts page for your project.
If it is not already displayed, select the organization that contains your desired project from the Organizations menu in the navigation bar.
If it is not already displayed, select your desired project from the Projects menu in the navigation bar.
Click the Project Alerts icon in the navigation bar, or click Alerts in the sidebar.
To enable one alert configuration in the specified project using the Atlas CLI, run the following command:
atlas alerts settings enable <alertConfigId> [options]
To learn more about the command syntax and parameters, see the Atlas CLI documentation for atlas alerts settings enable.
Tip
See: Related Links
Delete an Alert
Warning
Don't delete the Maintenance Window Alerts that are created when you configure a maintenance window.
If you delete a maintenance window alert, disable and then re-enable your maintenance window to re-create the alerts.
Navigate to the Alerts page for your project.
If it is not already displayed, select the organization that contains your desired project from the Organizations menu in the navigation bar.
If it is not already displayed, select your desired project from the Projects menu in the navigation bar.
Click the Project Alerts icon in the navigation bar, or click Alerts in the sidebar.
To delete one alert configuration in the specified project using the Atlas CLI, run the following command:
atlas alerts settings delete <alertConfigId> [options]
To learn more about the command syntax and parameters, see the Atlas CLI documentation for atlas alerts settings delete.
Tip
See: Related Links
If you delete an alert setting, Atlas cancels active alerts related to the setting. A deleted alert setting does not remain visible.
Choose the alert setting to delete.
On the row for a specific alert, click then Delete.
Click Delete in the Delete Alert modal or click Cancel to leave the alert as configured.
Note
If you have not logged in within the five minutes of pushing Delete, you need to re-enter your password, then click Delete again.
If you delete an alert setting, Atlas cancels active alerts related to the setting. A deleted alert setting does not remain visible.