Review Alert Conditions
On this page
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 learn more, see Alerts Workflow.
To set a condition:
Select a Target from the list.
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:
Select a Target type from the list.
Filter the Target type or select Any.
Select on a metric in the condition/metric list.
Select if this metric should be Below or Above the threshold.
Type a threshold value. All thresholds are numbers.
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 | |
Host removed | |
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: To learn more, see Rollbacks During Replica Set Failover. |
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. For 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. If you need to trigger the Monitoring to check immediately, you can restart the agent. If Cloud Manager Automation does not manage a To resolve this alert, see Fix Down Host. |
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.
Note
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. |
You can create charts for a selection of these metrics in Cloud Manager.
In MongoDB Cloud Manager, go to the Deployment 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's not already displayed, select your desired project from the Projects menu in the navigation bar.
If the Deployment page is not already displayed, click Deployment in the sidebar.
The Deployment page displays.
Go to the Processes page.
Click the Processes tab for your deployment.
The Processes page displays.
Average Execution Time
Important
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. |
You can create charts for a selection of these metrics in Cloud Manager.
In MongoDB Cloud Manager, go to the Deployment 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's not already displayed, select your desired project from the Projects menu in the navigation bar.
If the Deployment page is not already displayed, click Deployment in the sidebar.
The Deployment page displays.
Go to the Processes page.
Click the Processes tab for your deployment.
The Processes page displays.
Query Targeting
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:
Query Targeting: Scanned is
Average rate per second to scan index items during queries and query-plan evaluations meets your specified threshold.
Query Targeting: Scanned Objects is
Average rate per second to scan documents meets your specified threshold.
Query Targeting: Scanned / Returned is
Ratio of index items scanned to documents returned meets the specified threshold.
Query Targeting: Scanned Objects / Returned is
Ratio of documents scanned to documents returned meets the specified threshold.
You can create charts for a selection of these metrics in Cloud Manager.
In MongoDB Cloud Manager, go to the Deployment 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's not already displayed, select your desired project from the Projects menu in the navigation bar.
If the Deployment page is not already displayed, click Deployment in the sidebar.
The Deployment page displays.
Go to the Processes page.
Click the Processes tab for your deployment.
The Processes page displays.
Opcounter
You may set alerts for how many database operations are completed per second.
Note
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. |
You can create charts for a selection of these metrics in Cloud Manager.
In MongoDB Cloud Manager, go to the Deployment 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's not already displayed, select your desired project from the Projects menu in the navigation bar.
If the Deployment page is not already displayed, click Deployment in the sidebar.
The Deployment page displays.
Go to the Processes page.
Click the Processes tab for your deployment.
The Processes page displays.
Opcounter - Repl
You may set alerts for how many database operations per second are replicated to a MongoDB secondaries.
Note
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. |
You can create charts for a selection of these metrics in Cloud Manager.
In MongoDB Cloud Manager, go to the Deployment 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's not already displayed, select your desired project from the Projects menu in the navigation bar.
If the Deployment page is not already displayed, click Deployment in the sidebar.
The Deployment page displays.
Go to the Processes page.
Click the Processes tab for your deployment.
The Processes page displays.
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.
Note
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. |
You can create charts for a selection of these metrics in Cloud Manager.
In MongoDB Cloud Manager, go to the Deployment 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's not already displayed, select your desired project from the Projects menu in the navigation bar.
If the Deployment page is not already displayed, click Deployment in the sidebar.
The Deployment page displays.
Go to the Processes page.
Click the Processes tab for your deployment.
The Processes page displays.
Security
Security metrics include:
Metric | Alert Trigger |
---|---|
Host has security recommendations | Authentication or TLS is disabled. |
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.
Note
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. |
You can create charts for a selection of these metrics in Cloud Manager.
In MongoDB Cloud Manager, go to the Deployment 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's not already displayed, select your desired project from the Projects menu in the navigation bar.
If the Deployment page is not already displayed, click Deployment in the sidebar.
The Deployment page displays.
Go to the Processes page.
Click the Processes tab for your deployment.
The Processes page displays.
B-tree
Important
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 %
Important
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
Important
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.
Note
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.
Note
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. The
default value for MongoDB versions 2.6.0 and 3.0.0 is
|
You can create charts for a selection of these metrics in Cloud Manager.
In MongoDB Cloud Manager, go to the Deployment 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's not already displayed, select your desired project from the Projects menu in the navigation bar.
If the Deployment page is not already displayed, click Deployment in the sidebar.
The Deployment page displays.
Go to the Processes page.
Click the Processes tab for your deployment.
The Processes page displays.
Queues
You may set alerts for the operations waiting on locks.
Note
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. |
You can create charts for a selection of these metrics in Cloud Manager.
In MongoDB Cloud Manager, go to the Deployment 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's not already displayed, select your desired project from the Projects menu in the navigation bar.
If the Deployment page is not already displayed, click Deployment in the sidebar.
The Deployment page displays.
Go to the Processes page.
Click the Processes tab for your deployment.
The Processes page displays.
Page Faults
Important
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.
Note
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. |
You can create charts for a selection of these metrics in Cloud Manager.
In MongoDB Cloud Manager, go to the Deployment 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's not already displayed, select your desired project from the Projects menu in the navigation bar.
If the Deployment page is not already displayed, click Deployment in the sidebar.
The Deployment page displays.
Go to the Processes page.
Click the Processes tab for your deployment.
The Processes page displays.
Cursors
You may set alerts for the number of open and timed-out cursors for a MongoDB process.
Note
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. |
You can create charts for a selection of these metrics in Cloud Manager.
In MongoDB Cloud Manager, go to the Deployment 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's not already displayed, select your desired project from the Projects menu in the navigation bar.
If the Deployment page is not already displayed, click Deployment in the sidebar.
The Deployment page displays.
Go to the Processes page.
Click the Processes tab for your deployment.
The Processes page displays.
Network
You may set alerts for the network throughput for a MongoDB process.
Note
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. |
You can create charts for a selection of these metrics in Cloud Manager.
In MongoDB Cloud Manager, go to the Deployment 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's not already displayed, select your desired project from the Projects menu in the navigation bar.
If the Deployment page is not already displayed, click Deployment in the sidebar.
The Deployment page displays.
Go to the Processes page.
Click the Processes tab for your deployment.
The Processes page displays.
Replication Oplog
You may set alerts for the replication oplogs for a MongoDB process.
Note
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 sync source'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 |
You can create charts for a selection of these metrics in Cloud Manager.
In MongoDB Cloud Manager, go to the Deployment 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's not already displayed, select your desired project from the Projects menu in the navigation bar.
If the Deployment page is not already displayed, click Deployment in the sidebar.
The Deployment page displays.
Go to the Processes page.
Click the Processes tab for your deployment.
The Processes page displays.
Operations Scan and Order
You may set alerts for the scan and order operations for a MongoDB process.
Note
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. |
You can create charts for a selection of these metrics in Cloud Manager.
In MongoDB Cloud Manager, go to the Deployment 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's not already displayed, select your desired project from the Projects menu in the navigation bar.
If the Deployment page is not already displayed, click Deployment in the sidebar.
The Deployment page displays.
Go to the Processes page.
Click the Processes tab for your deployment.
The Processes page displays.
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. |
You can create charts for a selection of these metrics in Cloud Manager.
In MongoDB Cloud Manager, go to the Deployment 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's not already displayed, select your desired project from the Projects menu in the navigation bar.
If the Deployment page is not already displayed, click Deployment in the sidebar.
The Deployment page displays.
Go to the Processes page.
Click the Processes tab for your deployment.
The Processes page displays.
WiredTiger Storage Engine
You may set alerts for WiredTiger tickets.
Note
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. |
You can create charts for a selection of these metrics in Cloud Manager.
In MongoDB Cloud Manager, go to the Deployment 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's not already displayed, select your desired project from the Projects menu in the navigation bar.
If the Deployment page is not already displayed, click Deployment in the sidebar.
The Deployment page displays.
Go to the Processes page.
Click the Processes tab for your deployment.
The Processes page displays.
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. 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 | Total system memory used for the mongod minus
buffers, cached, and free memory meets the specified threshold. |
System Memory: Max Used is | Maximum system memory usage value meets
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. |
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. The Cloud Manager release on February 14, 2024 fixes an issue where Cloud Manager inaccurately reported this metric. This release resets this metric and the previous values no longer appear. |
Max System Network Out is | Maximum number of bytes sent from
MongoDB meets the specified threshold. |
You can create charts for a selection of these metrics in Cloud Manager.
In MongoDB Cloud Manager, go to the Deployment 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's not already displayed, select your desired project from the Projects menu in the navigation bar.
If the Deployment page is not already displayed, click Deployment in the sidebar.
The Deployment page displays.
Go to the Processes page.
Click the Processes tab for your deployment.
The Processes page displays.
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
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 Fix Lost 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. 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:
|
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 Fix Backup Oplog Issues. |
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.
|
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 Fix Inconsistent Backup. |
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:
|
BI Connector Alerts
These alert conditions apply to use of the BI Connector with Cloud Manager.
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. |
Security checkup alerts updated | The project's security checkup alerts changed. |
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 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. |