This version of the documentation is archived and no longer supported. To learn how to upgrade your version of MongoDB Ops Manager, refer to the upgrade documentation.
You were redirected from a different version of the documentation. Click here to go back.
This version of the manual is no longer supported.

Manage Alerts


Ops 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 Ops Manager.

When a condition triggers an alert, you receive the alert at regular intervals until the alert resolves or Ops 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.

Ops Manager administrators define alert configurations on a per-project or multi-project basis.

Resolved Alerts

Alerts resolve when the alert condition no longer applies. For example, if a replica set’s primary goes down, Ops 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. Ops Manager sends a notification of the alert’s resolution.

Cancelled Alerts

Ops 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, Ops Manager does not send a notification and does not record an entry on the Ops Manager Alerts lists.

View Alerts

To view alerts, click Alerts, then:

To see… Click…
Open alerts Open Alerts
Closed alerts Closed Alerts
Open and closed alerts All Activity
Alerts of one type

All Activity

  1. Type the alert type in the Types box.
  2. Click Filter.
Alerts in date range

All Activity.

  1. Select dates in the From and To boxes.
  2. Click Filter.

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, Ops 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, Ops 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.


Click Alerts, then the Open Alerts tab.


Acknowledge alerts

  • For a single alert, on the line item for the alert, click Acknowledge.
  • For multiple, but not all, alerts:
    • Check the checkbox to the left of each alert to acknowledge.
    • Click Acknowledge above the table.
  • For all alerts, check the checkbox in the table header to select every alert.
    • It is also then possible to uncheck a few checkboxes to select fewer than all alerts.

Select the time period for which to acknowledge the alert.

Click the time frame for which you no longer wish to receive alerts.

Ops Manager will send no further alert messages for the period of time you select.


If all Alerts were checked, select All Visible or All Open Alerts. (Optional)

If all alerts are checked, then another set of radio buttons appear:

  • Clicking Acknowledge all visible checked alerts will acknowledge all alerts that were loaded onto the page.
  • Clicking Acknowledge all open alerts will acknowledge all alerts: checked, unchecked, visible on the current page and those that have not been loaded on the current page.

Click Acknowledge.

Unacknowledge an Alert

You can undo an acknowledgment and again receive notifications if the alert condition still applies.


Click Alerts, then the Open Alerts tab.


On the line item for the alert, click Unacknowledge.


Click Confirm.

If the alert condition continues to exist, Ops Manager will resend 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.


Click Deployment, then the Processes tab, then the Topology view.


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:

  1. Click Alerts.
  2. Click the Alert Configuration tab.
  3. Click the Maintenance Windows filter.

Add or Edit a Maintenance Window


Click Alerts, then 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


Click Alerts, then the Alert Settings tab.


Click the Maintenance Windows filter.


For the window to delete, click the ellipsis icon and select Delete.


Click Confirm.