Navigation
You were redirected from a different version of the documentation. Click here to go back.

Alert Conditions

For each alert you create, you must set a target and a condition or metric. The target points to what changed: the Cloud Manager component. If your condition becomes true or a metric falls below or rises above your set threshold, Cloud Manager triggers an alert.

To set a condition:

  1. Select a Target from the list.
  2. Select a condition in the condition/metric list.

Cloud Manager triggers an alert when the condition is true on the specified target MongoDB instance.

To set a metric:

  1. Select a Target type from the list.
  2. Filter the Target type or select Any.
  3. Select on a metric in the condition/metric list.
  4. Select if this metric should be Below or Above the threshold.
  5. Type a threshold value. All thresholds are numbers.
  6. Select the unit of measure for the threshold.

Cloud Manager triggers an alert when the metric threshold is met on the specified target MongoDB instance.

Host Alerts

When setting an alert for a host, select the host type that applies to this alert and the condition that triggers this alert.

Host Types

For host type, set an alert for all or one of the following types of MongoDB processes:

Set Host Type to: Alert Includes
Any type All the types described in this table.
Standalone Any mongod instance that is neither part of a replica set or sharded cluster nor used as a config server.
Primary All replica set primaries.
Secondary All replica set secondaries.
Arbiter All replica set arbiters.
Mongos All mongos instances.
Conf All mongod instances used as config servers.

Host Alert Conditions

Change in Host Status

You can set an alert for when MongoDB instance changes. Host status conditions include:

Condition Alert Trigger
Host added Cloud Manager starts monitoring or managing a mongod or mongos process for the first time.
Host removed Cloud Manager stops monitoring or managing a mongod or mongos process for the first time.
Host added to replica set Specified type of mongod process is added to a replica set.
Host removed from replica set Specified type of mongod process is removed from a replica set.
Host has restarted Cloud Manager detects that a host has been restarted.
Restarts in Last Hour is Cloud Manager detects that the number of times a host restarted within the previous hour exceeds the specified threshold.
Host experienced a rollback

Cloud Manager detects that a mongod on a host triggered a rollback.

The following host types can’t experience rollbacks:

Host is recovering A secondary enters the RECOVERING state. To learn more about the RECOVERING state, see Replica Set Member States.
Host does not have the latest version

Revision of MongoDB running on a host is two or more revisions behind the current stable release of MongoDB.

Example

If the current stable release is MongoDB 4.0.9, a host running MongoDB 4.0.8 would not trigger an alert but a host running MongoDB version 4.0.7 would trigger an alert.

To learn more about MongoDB version numbering, see MongoDB Version Numbers in the MongoDB manual.

Host’s SSL certificate will expire within 30 days SSL certificate for a MongoDB instance is 30 days from expiration. Cloud Manager resends the alert every 24 hours until resolved or acknowledged. If you do not resolve or acknowledge the alert and the certificate expires, Cloud Manager continues to send the alert. If the certificate expires, the Monitoring can no longer connect to the MongoDB instance.
Host is exposed to the public Internet

The host is exposed to the public Internet. When configured, Cloud Manager tries to make a socket connection to your hosts. If Cloud Manager is able to connect, Cloud Manager triggers the alert because the host is not behind a firewall and does not have authentication enabled.

Cloud Manager runs this check once each day.

This is a weak security validation and should not replace other auditing or intrusion detection system procedures.

Host is down

Cloud Manager does not receive a ping from a host for more than 9 minutes. Under normal operation, the Monitoring connects to each monitored host about once per minute. Cloud Manager waits 9 minutes before triggering the alert to minimize false positives, as would occur during a host restart.

If the host continues to be unreachable, the Monitoring eventually reduces ping frequency to every 5 minutes for a mongod and every 20 minutes for a mongos. If a mongod or mongos again becomes reachable, Cloud Manager recognizes the process within 5 minutes.

Note

If you need to trigger the Monitoring to check immediately, you can restart the agent.

If Cloud Manager Automation does not manage a mongos process and that process remains unreachable for 30 days, Cloud Manager removes the process from the Deployment tab. However, if you restart the mongos process, Cloud Manager detects it within 2 minutes.

To resolve this alert, see Host Down.

Advisor

You may set the Host Has Index Suggestions alert to receive an alert if Performance Advisor has index suggestions for the host.

If the query targeting ratio for a host consistently exceeds 10,000 for a period of 10 minutes, Performance Advisor checks the host for inefficient queries and possible indexes to improve performance. If Performance Advisor determines that the host would benefit from one or more indexes, this alert triggers and directs you to create the suggested indexes.

This alert does not trigger for projects where Performance Advisor is disabled.

Asserts

You may set alerts for how many assertion errors per second the instance has created.

How It Is Measured

MongoDB reports on opscounters using the asserts document that the serverStatus command returns.

Assert metrics include:

Metric Alert Trigger
Asserts: Regular is Rate of regular asserts meets your specified threshold.
Asserts: Warning is Rate of warnings meets your specified threshold.
Asserts: Msg is Rate of message asserts meets your specified threshold. Message asserts are internal server errors. Stack traces are logged for these.
Asserts: User is Rate of asserts users create meets your specified threshold.

Note

You can create charts for a selection of these metrics in Cloud Manager.

  1. From the Cloud Manager project’s Deployment view, click the List tab.
  2. Click the process for which you want to monitor.
  3. Click the Status tab.
  4. Scroll down to the list of available metrics and select the desired metric(s) to chart.

To learn more about creating charts for host metrics in Cloud Manager, see Monitor a Deployment and click the MongoDB Process Metrics tab.

Average Execution Time

Applies to MongoDB 3.4 or later only

The following metrics apply only to deployments running MongoDB version 3.4 or later.

You may set alerts for how long operations take to complete. Execution time metrics include:

Metric Alert Trigger
Average Execution Time: Commands is Average execution time for command operations meets your specified threshold.
Average Execution Time: Reads is Average execution time for read operations meets your specified threshold.
Average Execution Time: Writes is Average execution time for write operations meets your specified threshold.

Document Metrics

You may set alerts for how many MongoDB documents are processed per second. Document processing metrics include:

Metric Alert Trigger
Document Metrics: Deleted is Average rate per second of documents deleted meets your specified threshold.
Document Metrics: Inserted is Average rate per second of documents inserted meets your specified threshold.
Document Metrics: Returned is Average rate per second of documents returned meets your specified threshold.
Document Metrics: Update is Average rate per second of documents updated meets your specified threshold.

Note

You can create charts for a selection of these metrics in Cloud Manager.

  1. From the Cloud Manager project’s Deployment view, click the List tab.
  2. Click the process for which you want to monitor.
  3. Click the Status tab.
  4. Scroll down to the list of available metrics and select the desired metric(s) to chart.

To learn more about creating charts for host metrics in Cloud Manager, see Monitor a Deployment and click the MongoDB Process Metrics tab.

Query Executor

You may set alerts for how fast MongoDB scans items during queries and how many items are scanned compared to documents returned. Query execution time metrics include:

How It Is Measured

MongoDB measures query performance based on the explain command.

Condition Alert Trigger
Query Executor: Scanned is Average rate per second to scan index items during queries and query-plan evaluations meets your specified threshold.
Query Executor: Scanned Objects is Average rate per second to scan documents meets your specified threshold.
Query Executor: Scanned / Returned is Ratio of index items scanned to documents returned meets the specified threshold.
Query Executor: Scanned Objects / Returned is Ratio of documents scanned to documents returned meets the specified threshold.

Note

You can create charts for a selection of these metrics in Cloud Manager.

  1. From the Cloud Manager project’s Deployment view, click the List tab.
  2. Click the process for which you want to monitor.
  3. Click the Status tab.
  4. Scroll down to the list of available metrics and select the desired metric(s) to chart.

To learn more about creating charts for host metrics in Cloud Manager, see Monitor a Deployment and click the MongoDB Process Metrics tab.

Opcounter

You may set alerts for how many database operations are completed per second.

How It Is Measured

MongoDB reports on opscounters using the opscounters document that the serverStatus command returns.

Operation metrics include:

Condition Alert Trigger
Opcounter: Cmd is Average rate of commands performed per second meets your specified threshold.
Opcounter: Delete is Average rate of deletes performed per second meets your specified threshold.
Opcounter: Getmores is Average rate of getMores performed per second meets your specified threshold. On a primary, this number can be high even if the query count is low. The secondaries “getMore” from the primary as part of replication.
Opcounter: Insert is Average rate of inserts performed per second meets your specified threshold.
Opcounter: Query is Average rate of queries performed per second meets your specified threshold.
Opcounter: Update is Average rate of updates performed per second meets your specified threshold.

Note

You can create charts for a selection of these metrics in Cloud Manager.

  1. From the Cloud Manager project’s Deployment view, click the List tab.
  2. Click the process for which you want to monitor.
  3. Click the Status tab.
  4. Scroll down to the list of available metrics and select the desired metric(s) to chart.

To learn more about creating charts for host metrics in Cloud Manager, see Monitor a Deployment and click the MongoDB Process Metrics tab.

Opcounter - Repl

You may set alerts for how many database operations per second are replicated to a MongoDB secondaries.

How It Is Measured

MongoDB reports on opscounters using the opscountersRepl document of that the serverStatus command returns.

Replication operation metrics include:

Metric Alert Trigger
Opcounter: Repl Cmd is Average rate of replicated commands applied per second meets your threshold.
Opcounter: Repl Delete is Average rate of replicated deletes applied per second meets your threshold.
Opcounter: Repl Insert is Average rate of replicated inserts applied per second meets your threshold.
Opcounter: Repl Update is Average rate of replicated updates applied per second meets your threshold.

Note

You can create charts for a selection of these metrics in Cloud Manager.

  1. From the Cloud Manager project’s Deployment view, click the List tab.
  2. Click the process for which you want to monitor.
  3. Click the Status tab.
  4. Scroll down to the list of available metrics and select the desired metric(s) to chart.

To learn more about creating charts for host metrics in Cloud Manager, see Monitor a Deployment and click the MongoDB Process Metrics tab.

Memory

You may set alerts for how much memory a MongoDB instance uses. Set this threshold in bits, kilobits, megabits, gigabits, bytes, kilobytes, megabytes, gigabytes, terabytes or petabytes.

How It Is Measured

MongoDB reports on memory using the mem document that the serverStatus command returns.

Memory metrics include:

Metric Alert Trigger
Memory: Resident is Resident memory size for the mongod process meets your specified threshold. Over time on a dedicated database host, the resident memory may approach the amount of RAM on the host.
Memory: Virtual is Virtual memory size for the mongod process meets your specified threshold. You can use this alert to flag excessive memory outside of memory mapping.
Memory: Mapped is Mapped memory size for the mongod process meets your specified threshold. As MongoDB memory-maps all the data files, the size of mapped memory should approach total database size.
Memory: Computed is Virtual memory size for the mongod process that is not accounted for by memory-mapping meets your specified threshold. If this number is very high (multiple gigabytes), it indicates that excessive memory is being used outside of memory mapping.

Note

You can create charts for a selection of these metrics in Cloud Manager.

  1. From the Cloud Manager project’s Deployment view, click the List tab.
  2. Click the process for which you want to monitor.
  3. Click the Status tab.
  4. Scroll down to the list of available metrics and select the desired metric(s) to chart.

To learn more about creating charts for host metrics in Cloud Manager, see Monitor a Deployment and click the MongoDB Process Metrics tab.

Swap

Swap metrics include:

Metric Alert Trigger
Swap Usage: Used is The total amount swap space in use has reached the specified threshold.
Swap Usage: Max Used is Maximum total amount of swap space in use reaches the specified threshold.
Swap Usage: Free is The amount of available swap space has dropped below the specified threshold.
Swap Usage: Max Free is Maximum amount of available swap space drops below the specified threshold.

WiredTiger Cache

You may set alerts for how much WiredTiger cache a MongoDB instance uses. Set this threshold in bits, kilobits, megabits, gigabits, bytes, kilobytes, megabytes, gigabytes, terabytes or petabytes.

How It Is Measured

MongoDB reports on memory using the cache document that the serverStatus command returns.

WiredTiger cache metrics include:

Metric Alert Trigger
Cache: Bytes Read Into Cache is Average rate of bytes per second read into WiredTiger’s cache meets your specified threshold.
Cache: Bytes Written From Cache is Average rate of bytes per second written from WiredTiger’s cache meets your specified threshold.
Cache: Dirty Bytes is Number of tracked dirty bytes currently in the WiredTiger cache.
Cache: Used Bytes is Number of bytes currently in the WiredTiger cache.

Note

You can create charts for a selection of these metrics in Cloud Manager.

  1. From the Cloud Manager project’s Deployment view, click the List tab.
  2. Click the process for which you want to monitor.
  3. Click the Status tab.
  4. Scroll down to the list of available metrics and select the desired metric(s) to chart.

To learn more about creating charts for host metrics in Cloud Manager, see Monitor a Deployment and click the MongoDB Process Metrics tab.

B-tree

Applies to MongoDB 2.2 to 2.6 only

These metrics only triggers alerts on deployments running MongoDB versions 2.2 through 2.6.

You may set alerts for how many btree operations on the MongoDB instance are completed per second. B-Tree metrics include:

Metric Alert Trigger
B-tree: accesses is Number of accesses to B-tree indexes meets your specified threshold.
B-tree: hits is Number of times a B-tree page was in memory meets your specified threshold.
B-tree: misses is Number of times a B-tree page was not in memory meets your specified threshold.
B-tree: miss ratio is Ratio of misses to hits meets your specified threshold.

Effective Lock %

Applies to MongoDB 2.2 to 2.6 only

This metric only triggers alerts on deployments running MongoDB versions 2.2 through 2.6.

You may set alerts for what percentage of time the MongoDB instance is write locked. Effective Lock percentage metrics include:

Metric Alert Trigger
Effective Lock % is If the percent of total time the instance is write locked meets your specified threshold.

Background Flush Average

Applies to databases running MMAPv1 only

This metric only triggers alerts on deployments running MMAPv1 storage engines for their MongoDB databases.

You may set an alert for how long in milliseconds the average flush on the MongoDB instance take to complete. A flush is the writing of data to disk from memory.

How It Is Measured

MongoDB reports on average background flush time using the backgroundFlushing.average_ms value that the serverStatus command returns.

Background flush average metrics include:

Metric Alert Trigger
Background Flush Average is Average time for background flushes meets your specified threshold.

Connections

You may set alerts for the active connections to the MongoDB instance.

How It Is Measured

MongoDB reports on memory using the connections document that the serverStatus command returns.

Connection metrics include:

Metric Alert Trigger
Connections is Number of active host connections meets your specified threshold.
Connections % of configured limit is Percentage of active host connections to the total number of possible connections meets your specified threshold.

Note

You can create charts for a selection of these metrics in Cloud Manager.

  1. From the Cloud Manager project’s Deployment view, click the List tab.
  2. Click the process for which you want to monitor.
  3. Click the Status tab.
  4. Scroll down to the list of available metrics and select the desired metric(s) to chart.

To learn more about creating charts for host metrics in Cloud Manager, see Monitor a Deployment and click the MongoDB Process Metrics tab.

Queues

You may set alerts for the operations waiting on locks.

How It Is Measured

MongoDB reports on memory using the globalLock.currentQueue document that the serverStatus command returns.

Queue metrics include:

Metric Alert Trigger
Queues: Total is Number of operations waiting on a lock of any type meets your specified threshold.
Queues: Readers is Number of reader operations waiting on a lock of any type meets your specified threshold.
Queues: Writers is Number of writer operations waiting on a lock of any type meets your specified threshold.

Note

You can create charts for a selection of these metrics in Cloud Manager.

  1. From the Cloud Manager project’s Deployment view, click the List tab.
  2. Click the process for which you want to monitor.
  3. Click the Status tab.
  4. Scroll down to the list of available metrics and select the desired metric(s) to chart.

To learn more about creating charts for host metrics in Cloud Manager, see Monitor a Deployment and click the MongoDB Process Metrics tab.

Page Faults

Applies to MongoDB 2.2 to 2.6 only

The Accesses Not In Memory: Total is and Page Fault Exceptions Thrown: Total is metrics only trigger alerts on deployments running MongoDB versions 2.2 through 2.6.

You may set alerts for page faults.

How It Is Measured

MongoDB reports on memory using the extra_info.page_faults document that the serverStatus command returns.

MongoDB 2.2 through 2.6 reported on the Accesses Not In Memory: Total is and Page Fault Exceptions Thrown: Total is metrics using the recordStats document that the serverStatus command returned.

Page Fault metrics include:

Metric Alert Trigger
Accesses Not In Memory: Total is Rate of disk accesses meets your specified threshold. MongoDB must access data on disk if your working set does not fit in memory. This metric is found on the host’s Record Stats chart.
Page Fault Exceptions Thrown: Total is Rate of page fault exceptions thrown meets your specified threshold. This metric is found on the host’s Record Stats chart.
Page Faults is Rate of page faults (whether or not an exception is thrown) meets your specified threshold. This metric is found on the host’s Page Faults chart.

Note

You can create charts for a selection of these metrics in Cloud Manager.

  1. From the Cloud Manager project’s Deployment view, click the List tab.
  2. Click the process for which you want to monitor.
  3. Click the Status tab.
  4. Scroll down to the list of available metrics and select the desired metric(s) to chart.

To learn more about creating charts for host metrics in Cloud Manager, see Monitor a Deployment and click the MongoDB Process Metrics tab.

Cursors

You may set alerts for the number of open and timed-out cursors for a MongoDB process.

How It Is Measured

MongoDB reports on memory using the metrics.cursor document that the serverStatus command returns.

Cursor metrics include:

Metric Alert Trigger
Cursors: Client Cursors Size is Amount of memory the host uses to maintain cursors meets your specified threshold.
Cursors: Open is Number of cursors the host is maintaining for clients meets the specified threshold.
Cursors: Timed Out is Number of timed-out cursors the host is maintaining for clients meets your specified threshold.

Note

You can create charts for a selection of these metrics in Cloud Manager.

  1. From the Cloud Manager project’s Deployment view, click the List tab.
  2. Click the process for which you want to monitor.
  3. Click the Status tab.
  4. Scroll down to the list of available metrics and select the desired metric(s) to chart.

To learn more about creating charts for host metrics in Cloud Manager, see Monitor a Deployment and click the MongoDB Process Metrics tab.

Network

You may set alerts for the network throughput for a MongoDB process.

How It Is Measured

MongoDB reports on memory using the network document that the serverStatus command returns.

Network metrics include:

Metric Alert Trigger
Network: Bytes In is Number of bytes sent to the database host meets your specified threshold.
Network: Bytes Out is Number of bytes sent from the database host meets your specified threshold.
Network: Num Requests is Number of requests sent to the database host meets your specified threshold.

Note

You can create charts for a selection of these metrics in Cloud Manager.

  1. From the Cloud Manager project’s Deployment view, click the List tab.
  2. Click the process for which you want to monitor.
  3. Click the Status tab.
  4. Scroll down to the list of available metrics and select the desired metric(s) to chart.

To learn more about creating charts for host metrics in Cloud Manager, see Monitor a Deployment and click the MongoDB Process Metrics tab.

Replication Oplog

You may set alerts for the replication oplogs for a MongoDB process.

How It Is Measured

MongoDB reports on the Replication Oplog using the oplog document that the serverStatus command returns combined with results from rs.status() and rs.conf().

Replication oplog metrics include:

Metric Alert Trigger
Replication Headroom is Difference between the primary’s replication oplog window and the secondary’s replication lag meets your specified threshold. A secondary can go into RECOVERING if this value goes to 0.
Replica Time is Approximate amount of time in milliseconds available in the primary’s replication oplog meets your specified threshold.
Oplog Data Per Hour is Average rate of gigabytes of oplog the primary generates per hour meets your specified threshold.
Replication Lag is Approximate number of seconds the secondary is behind the primary in write application. Only accurate if the lag is larger than 1-2 seconds, as the precision of this statistic is limited.

Note

You can create charts for a selection of these metrics in Cloud Manager.

  1. From the Cloud Manager project’s Deployment view, click the List tab.
  2. Click the process for which you want to monitor.
  3. Click the Status tab.
  4. Scroll down to the list of available metrics and select the desired metric(s) to chart.

To learn more about creating charts for host metrics in Cloud Manager, see Monitor a Deployment and click the MongoDB Process Metrics tab.

Operations Scan and Order

You may set alerts for the scan and order operations for a MongoDB process.

How It Is Measured

MongoDB reports on the Replication Oplog using the metrics.operation.scanAndOrder document that the serverStatus command returns.

Operations metrics include:

Metric Alert Trigger
Operations: Scan and Order is Average rate per second over your specified threshold of queries that return sorted results that cannot perform the sort operation using an index.

DB Storage

You may set alerts for the amount of data storage used. Database storage metrics include:

Metric Alert Trigger
DB Storage is Amount of on-disk storage space used by extents meets your specified threshold.
DB Data Size is Actual data size in the database meets your specified threshold.

Note

You can create charts for a selection of these metrics in Cloud Manager.

  1. From the Cloud Manager project’s Deployment view, click the List tab.
  2. Click the process for which you want to monitor.
  3. Click the Status tab.
  4. Scroll down to the list of available metrics and select the desired metric(s) to chart.

To learn more about creating charts for host metrics in Cloud Manager, see Monitor a Deployment and click the MongoDB Process Metrics tab.

Journaling

You may set alerts for the amount of journaling storage used. Journaling metrics include:

Metric Alert Trigger
Journaling Commits in Write Lock is Rate of commits that occurred while the database was in write lock meets your specified threshold.
Journaling MB is Average amount of data in megabytes Cloud Manager writes to the recovery log per second meets your specified threshold.
Journaling Write Data Files MB is Average rate of data in megabytes Cloud Manager writes to the databases datafiles per second meets your specified threshold. As these writes are already journaled, they can occur lazily, and thus the number indicated here may be lower than the amount physically written to disk.

Note

You can create charts for a selection of these metrics in Cloud Manager.

  1. From the Cloud Manager project’s Deployment view, click the List tab.
  2. Click the process for which you want to monitor.
  3. Click the Status tab.
  4. Scroll down to the list of available metrics and select the desired metric(s) to chart.

To learn more about creating charts for host metrics in Cloud Manager, see Monitor a Deployment and click the MongoDB Process Metrics tab.

WiredTiger Storage Engine

You may set alerts for WiredTiger tickets.

How It Is Measured

MongoDB reports on WiredTiger using the wiredTiger.cache and wiredTiger.concurrentTransactions documents that the serverStatus command returns.

WiredTiger storage engine conditions include:

Metric Alert Trigger
Tickets Available: Reads is Number of read tickets available to the WiredTiger storage engine meet your specified threshold.
Tickets Available: Writes is Number of write tickets available to the WiredTiger storage engine meet your specified threshold.

Note

You can create charts for a selection of these metrics in Cloud Manager.

  1. From the Cloud Manager project’s Deployment view, click the List tab.
  2. Click the process for which you want to monitor.
  3. Click the Status tab.
  4. Scroll down to the list of available metrics and select the desired metric(s) to chart.

To learn more about creating charts for host metrics in Cloud Manager, see Monitor a Deployment and click the MongoDB Process Metrics tab.

System and Disk Alerts

You may set alerts for compute and disk utilization. System resource conditions include:

Metric Alert Trigger
System: CPU (Steal) % is

Applicable when the EC2 instance credit balance is exhausted.

The percentage of time the CPU is in a state of “involuntary wait”. CPU steal percentage is the percentage by which the CPU usage exceeds the guaranteed baseline CPU credit accumulation rate.

Note

This alert typically triggers when all credits have been consumed on an AWS burstable performance instance.

System: Max CPU (Steal) % is Maximum percentage of time that the CPU is in a state of “involuntary wait” exceeds the specified threshold.
System: CPU (User) % is CPU usage of the MongoDB process, scaled to a range of 0-100% by dividing by the number of CPUs.
System: Max CPU (User) % is Maximum CPU usage of the MongoDB process, scaled to a range of 0-100% by dividing by the number of CPUs exceeds the specified threshold.
System Memory: Used is System memory usage for the mongod meets the specified threshold.
System Memory: Max Used is Maximum system memory usage value meets the specified threshold.
System Memory: Free is Free system memory for the mongod has dropped below the specified threshold.
System Memory: Max Free is Maximum amount of free system memory drops below the specified threshold.
System Memory: Available is Available system memory usage for the mongod has dropped below the specified threshold.
System Memory: Max Available is Maximum amount of available system memory drops below the specified threshold.
Disk space % used on Data Partition is Percentage of disk space used on any partition that contains the MongoDB collection’s data.
Max disk space % used on Data Partition is Maximum percentage of disk space used on any partition that contains the MongoDB collection’s data exceeds the specified threshold.
Disk space % used on Index Partition is Percentage of disk space used on any partition that contains the MongoDB index data.
Max disk space % used on Index Partition is Maximum percentage of disk space used on any partition that contains the MongoDB index data exceeds the specified threshold.
Disk space % used on Journal Partition is Percentage of disk space used on the partition that contains the MongoDB journal, if journaling is enabled.
Max disk space % used on Journal Partition is Maximum percentage of disk space used on the partition that contains the MongoDB journal exceeds the specified threshold.
Disk I/O % utilization on Data Partition is Percentage of time during which requests are being issued to any partition that contains the MongoDB collection’s data. This includes requests from any process, not just MongoDB processes.
Max disk I/O % utilization on Data Partition is Maximum percentage of time during which requests are being issued to any partition that contains the MongoDB collection’s data exceeds the specified threshold.
Disk I/O % utilization on Index Partition is Percentage of time during which requests are being issued to any partition that contains the MongoDB index data. This includes requests from any process, not just MongoDB processes.
Max disk I/O % utilization on Index Partition is Maximum percentage of time during which requests are being issued to any partition that contains the MongoDB index data exceeds the specified threshold.
Disk I/O % utilization on Journal Partition is Percentage of time during which requests are being issued to the partition that contains the MongoDB journal, if journaling is enabled. This includes requests from any process, not just MongoDB processes.
Max disk I/O % utilization on Journal Partition is Maximum percentage of time during which requests are being issued to the partition that contains the MongoDB journal exceeds the specified threshold.
System Network In is Number of bytes per second sent to the database host meets the specified threshold.
Max System Network In is Maximum number of bytes sent to MongoDB meets the specified threshold.
System Network Out is Number of bytes per second sent from the database host meets your specified threshold.
Max System Network Out is Maximum number of bytes sent from MongoDB meets the specified threshold.

Note

You can create charts for a selection of these metrics in Cloud Manager.

  1. From the Cloud Manager project’s Deployment view, click the List tab.
  2. Click the process for which you want to monitor.
  3. Click the Status tab.
  4. Scroll down to the list of available metrics and select the desired metric(s) to chart.

To learn more about creating charts for host metrics in Cloud Manager, see Monitor a Deployment and click the MongoDB Process Metrics tab.

Replica Set Alerts

You may set alerts about the status of the primary and the number of healthy members in a replica set. Replica set conditions include:

Condition Alert Trigger
Replica set elected a new primary

A set elects a new primary. Each time Cloud Manager receives a ping, it inspects the output of the replica set’s rs.status() method for the status of each replica set member. From this output, Cloud Manager determines which replica set member is the primary. If the primary found in the ping data is different than the current primary known to Cloud Manager, this alert triggers.

Receiving this alert does not always mean that the set elected a new primary. This alert may also trigger when the same primary is re- elected. This can happen when Cloud Manager processes a ping in the midst of an election.

Replica set has no primary

A replica set does not have a primary. Specifically, when none of the members of a replica set have a status of PRIMARY, the alert triggers. For example, this condition may arise when a set has an even number of voting members resulting in a tie.

If the Monitoring collects data during an election for primary, this alert might send a false positive. To prevent such false positives, set the alert configuration’s after waiting interval (in the configuration’s Send to section).

For resolutions, see No Primary.

Replica set metrics include:

Metric Alert Trigger
Number of healthy members is A replica set has fewer healthy members than your specified threshold.
Number of unhealthy members is A replica set has more unhealthy members than your specified threshold.
Number of elections in last hour is > X Number of elections that have occurred in the last hour exceeded the user-specified value of X. The value of X is set when you create the alert. This alert may indicate that the cluster’s replication is not in a healthy state, as evidenced by constant elections.

Note

A replica set member is healthy if you run rs.status() for that replica set and the result returns PRIMARY or SECONDARY for that member. Hidden secondaries and arbiters are not counted.

Sharded Cluster Alerts

You may set an alert for a mongos missing from a sharded cluster. Sharded cluster conditions include:

Condition Alert Trigger
Cluster is missing an active mongos Cloud Manager cannot reach any mongos for the cluster.

Agent Alerts

You may set alerts for agent status or versioning. Agent conditions include:

Condition Alert Trigger
Automation is down

No Automation is detected for at least 1 minute. Under normal operation, the Automation sends a ping to Cloud Manager roughly once every 10 seconds. If Cloud Manager does not receive a ping for at least 1 minute, this alert triggers.

Note

This alert triggers only if the Automation is managing a MongoDB process or agent module.

Monitoring is down

No Monitoring is detected for at least 7 minutes. Under normal operation, the Monitoring sends a ping to Cloud Manager roughly once per minute. If Cloud Manager does not receive a ping for at least 7 minutes, this alert triggers. However, this alert never triggers for a project that has no hosts configured.

Important

When the Monitoring is down, Cloud Manager triggers no other alerts for any host. For example: if a host is down there is no Monitoring to send data to Cloud Manager that could trigger new alerts.

Monitoring does not have the latest version Monitoring is not running the latest version of the software.
Backup is down

Backup for a project with at least one active replica set or cluster is down for more than 1 hour.

To resolve this alert:

  1. To see which host serves the Backup, click Deployment, then the Servers tab.
  2. Check the Backup log file on that host.
Backup does not have the latest version Backup is not running the latest version of the software.

Backup Alerts

You may set alerts for backup oplog, resync and inconsistencies. Backup conditions include:

Condition Alert Trigger
Backup oplog is behind

Most recent oplog data received by Cloud Manager is more than 75 minutes old.

To resolve this alert, see Backup Oplog is Behind.

Backup requires a resync

Replication process for a backup falls too far behind the oplog to catch up. This occurs when the host overwrites oplog entries that backup has not yet replicated. When this happens, you must resync backup, as described in the procedure Resync a Backup.

Also, check the corresponding Backup log. If you see a “Failed Common Points” test, one of the following may have happened.

  • A significant rollback event occurred on the backed-up replica set.
  • oplog for the backed-up replica set was resized or deleted.
  • High oplog churn caused the agent to lose the tail of the oplog.
Inconsistent backup configuration has been detected

Cloud Manager has detected that the configuration for a backup does not match the configuration of the MongoDB deployment it backs up.

To resolve this alert, see Inconsistent Backup Configuration.

Inconsistent cluster snapshot count is…

Cloud Manager fails a consecutive number of times to successfully take a cluster snapshot. This alert is triggered when the number of attempts meets your specified threshold.

The alert text may contain the reason for the problem. Common problems include:

  • There was no reachable mongos. To resolve this issue, ensure that there is at least one mongos showing on the Cloud Manager Deployment page.
  • balancer could not be stopped. To resolve this issue, check the log files for the first config server to determine why the balancer will not stop.
  • Could not insert a token in one or more shards. To resolve this issue, ensure connectivity between the Backup and all shards.

BI Connector Alerts

These alert conditions apply to use of the BI Connector with Cloud Manager.

Condition Alert Trigger
BI Connector is down

The Automation has not detected the BI Connector process for at least 9 minutes.

Important

When the Automation is down, Cloud Manager cannot trigger alerts for the BI Connector.

User Alerts

You may set alerts for user addition, removal and role changes. User conditions include:

Condition Alert Trigger
User joined the project A new user joins the project.
User left the project A user leaves the project.
User had their role changed A user’s roles have been changed.

Project Alerts

You may set alerts for user approval and authentication configuration. Project conditions include:

Condition Alert Trigger
Users do not have two-factor authentication enabled Project has users who have not set up two-factor authentication.

Billing Alerts

You may set alerts for credit card expiration and billing amounts. Billing conditions include:

Condition Alert Trigger
Credit card is about to expire Credit card on file is about to expire. The alert is triggered at the beginning of the month that the card expires. Cloud Manager enables this alert configuration when a credit card is added for the first time.
Monthly pending invoice ($) total is Invoice for the end of the month meets your specified threshold.
Daily amount billed ($) is Amount for the current day meets your specified threshold.

Federation Alerts

You may set alerts for an organization’s IdP certificate.

Condition Alert Trigger
Organization’s IdP certificate is about to expire

IdP certificate associated with an organization for which you have the Organization Owner role expires within 14 days. MongoDB Cloud Manager sends this alert until you acknowledge it.

Note

MongoDB Cloud Manager creates this alert automatically when you map an organization to an IdP provider. If you remove the mapping, MongoDB Cloud Manager deletes all instances of this alert.