- Alerts and Monitoring >
- Alerts >
- Manage Alerts
Manage Alerts¶
On this page
Overview¶
Cloud Manager sends an alert notification when a specified alert condition occurs, such as an unresponsive host or an outdated agent. To view all alert notifications, click Alerts in Cloud Manager.
When a condition triggers an alert, you receive the alert at regular intervals until the alert resolves or Cloud Manager cancels it. You can acknowledge an alert for a period of time, but if the alert condition persists, you will again receive notifications once the acknowledgment period ends.
You can temporarily suspend alerts on a resource by creating an alert maintenance window. For example, you can create a maintenance window that suspends host alerts while you shut down hosts for maintenance.
Cloud Manager administrators define alert configurations on a per-project basis.
- Organization Alerts
- Project Alerts
Resolved Alerts¶
Alerts resolve when the alert condition no longer applies. For example, if a replica set’s primary goes down, Cloud Manager issues an alert that the replica set does not have a primary. When a new primary is elected, the alert condition no longer applies, and the alert will resolve. Cloud Manager sends a notification of the alert’s resolution.
Cancelled Alerts¶
Cloud Manager cancels an alert if the alert configuration that triggered the alert is deleted, disabled, or edited, or if the open alert becomes invalid. Some examples of an alert becoming invalid are:
- There is an open “Host Down” alert, and then you delete the target host.
- There is an open “Replication Lag” alert, and the target host becomes the primary.
- There is an open “Replica set has no primary” alert for a replica set whose name is “rs0,” and the target replica set is renamed to “rs1.”
When an alert is canceled, Cloud Manager does not send a notification and does not record an entry on the Cloud Manager Alerts lists.
View Alerts¶
View All Activity¶
- Organization Activity
- Project Activity
Filter the activity feed.¶
You can filter the organization activity feed by event type and time range. You can combine filtering methods together for greater control over the activity feed output.
- Filter by event
Select the event categories or specific events you want to see from the activity feed. To exclude specific categories or events from the activity feed, click Select all categories and events, then deselect the categories and events you want to exclude.
You can filter events based on the following categories:
Category Description Access Events related to Cloud Manager users. Alerts Events related to alert configuration and monitoring. Billing Events related to payments and payment methods. Others Miscellaneous events, including log retrieval and mLab events. Organization Events related to your Cloud Manager organization. Projects Events related to Cloud Manager projects.
- Filter by time range
- Select a Start Date and End Date to view events from within a specified time range. Once you have configured a time range, click Apply Dates to update the activity feed with the specified range.
Filter the activity feed.¶
You can filter the project activity feed by event type, cluster, and time range. You can combine filtering methods together for greater control over the activity feed output.
- Filter by event
Select the event categories or specific events you want to see from the activity feed. To exclude specific categories or events from the activity feed, click Select all categories and events, then deselect the categories and events you want to exclude.
You can filter events based on the following categories:
Category Description Access Events related to Cloud Manager users. Alerts Events related to alert configuration and monitoring. Billing Events related to payments and payment methods. Others Miscellaneous events, including log retrieval and mLab events. Organization Events related to your Cloud Manager organization. Projects Events related to Cloud Manager projects.
- Filter by time range
- Select a Start Date and End Date to view events from within a specified time range. Once you have configured a time range, click Apply Dates to update the activity feed with the specified range.
Retrieve the Activity Feed¶
You can retrieve events for a specified organization or project using the Events API resource.
Acknowledge an Alert¶
When you acknowledge the alert, Cloud Manager sends no further notifications to the alert’s distribution list until the acknowledgement period has passed or until the you resolve the alert. The distribution list receives no notification of the acknowledgment.
If the alert condition ends during the acknowledgment period, Cloud Manager sends a notification of the resolution.
If you configure an alert with PagerDuty, a third-party incident management service, you can only acknowledge the alert on your PagerDuty dashboard.
Navigate to the Alerts page for your organization.¶
- If it is not already displayed, select your desired organization from the Organizations menu in the navigation bar.
- Click Alerts in the sidebar.
Acknowledge alerts¶
To acknowledge a single alert, on the line item for the alert, click Acknowledge.
To acknowledge multiple, but not all, alerts:
- Check the checkbox to the left of each alert to acknowledge.
- Click Mark Acknowledge above the table.
To acknowledge all alerts:
- Select the checkbox in the table header to select every alert.
- Click Mark Acknowledge above the table.
Select the time period for which to acknowledge the alert.¶
Click the time frame for which you no longer wish to receive alerts.
Cloud Manager sends no further alert messages for the period of time you select.
Optional: If all Alerts were checked, select All Visible or All Open Alerts.¶
If all alerts are checked, then another set of radio buttons appear:
- Click Acknowledge all visible checked alerts to acknowledge all alerts that were loaded onto the page.
- Click Acknowledge all open alerts to acknowledge all alerts: checked, unchecked, visible and not visible on the current page.
Click Acknowledge to confirm.¶
Acknowledge alerts¶
To acknowledge a single alert, on the line item for the alert, click Acknowledge.
To acknowledge multiple, but not all, alerts:
- Check the checkbox to the left of each alert to acknowledge.
- Click Mark Acknowledge above the table.
To acknowledge all alerts:
- Select the checkbox in the table header to select every alert.
- Click Mark Acknowledge above the table.
Select the time period for which to acknowledge the alert.¶
Click the time frame for which you no longer wish to receive alerts.
Cloud Manager sends no further alert messages for the period of time you select.
Optional: If all Alerts were checked, select All Visible or All Open Alerts.¶
If all alerts are checked, then another set of radio buttons appear:
- Click Acknowledge all visible checked alerts to acknowledge all alerts that were loaded onto the page.
- Click Acknowledge all open alerts to acknowledge all alerts: checked, unchecked, visible and not visible on the current page.
Click Acknowledge to confirm.¶
Unacknowledge an Alert¶
You can undo an acknowledgment and again receive notifications if the alert condition still applies.
Navigate to the Alerts page for your organization.¶
- If it is not already displayed, select your desired organization from the Organizations menu in the navigation bar.
- Click Alerts in the sidebar.
On the line item for the alert, click Unacknowledge.¶
Click Confirm.¶
If the alert condition continues to exist, Cloud Manager resends the alerts.
Navigate to the Open Alerts tab.¶
- 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 it is not already displayed, click the Open Alerts tab.
On the line item for the alert, click Unacknowledge.¶
Click Confirm.¶
If the alert condition continues to exist, Cloud Manager resends the alerts.
Disable Alerts for a Specific Process¶
You can turn off alerts for a given process. This might be useful, for example, if you want to temporarily disable the process but do not want it hidden from monitoring. Use the following procedure both to turn alerts off or on.
On the line listing the process, click the ellipsis icon and select Monitoring Settings.¶
Select Alert Status and then modify the alert settings.¶
Suspend Alerts by Adding a Maintenance Window¶
Specify maintenance windows to temporarily turn off alert notifications for a given resource while you perform maintenance.
To view maintenance windows:
Click the Maintenance Windows filter.¶
Add or Edit a Maintenance Window¶
Navigate to the Alert Settings tab.¶
- 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.
- Click the Alert Settings tab.
Add or edit a maintenance window.¶
- To add a maintenance window: Click the Add button and select New Maintenance Window.
- To edit a maintenance window: Click the Maintenance Windows filter, then click the ellipsis icon for a mainenance window and select Edit.
Select the target components for which to suspend alerts.¶
Note that selecting the Host target selects both HOST
and HOST_METRIC
alert configurations returned through the
alertConfigs endpoint.
Select the time period for which to suspend alerts.¶
Enter an optional description for the maintenance window.¶
Click Save.¶
Delete a Maintenance Window¶
Navigate to the Alert Settings tab.¶
- 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.
- Click the Alert Settings tab.