Monitor a Cluster¶

Atlas collects and displays metrics for your servers, databases, and MongoDB processes.

Free Tier and Shared Cluster Monitoring Considerations

M0 Free Tier and M2/M5 Shared clusters support a subset of the metrics and charts available. For complete documentation on the limitations of M0/M2/M5 clusters, see Atlas M0 (Free Tier), M2, and M5 Limitations.
Atlas pauses monitoring for M0 Free Tier clusters which have had no connection activity for 14 days. Monitoring resumes once a successful connection occurs through the Atlas API, Driver, Mongo Shell, or Data Explorer.

All Cluster Metrics
Replica Set Metrics
Sharded Cluster Metrics
MongoDB Process Metrics
Real Time Metrics

View Metrics for All Atlas Clusters in a Project

The Clusters view displays all clusters in a Atlas project. Atlas displays up to four of the following charts for each cluster in the project:

Chart Data

Operations

Displays the aggregated read (R) and write (W) operations on the cluster.

For a replica set, the chart shows operations for the primary.

For a sharded cluster, the chart shows the sum of the operations on each primary in the cluster.

Logical Size

M0/M2/M5 Clusters Only

Displays the sum of total bytes of the documents and index data across all databases in the cluster.

Disk Usage

M10+ Clusters Only

The total bytes of used disk space for the cluster.

For a replica set, the chart shows the disk usage of the primary host machine.

For a sharded cluster, the chart shows the sum of disk usage on each primary host in the cluster.

Connections

The total number of active connections to the cluster.

For a replica set, the chart shows the number of active connections to the primary.

For a sharded cluster, the chart shows the sum of all active connections to each primary in the cluster.

Disk IOPS

M10+ Clusters Only

The sum of read and write input/output operations per second (IOPS) for the cluster.

For a replica set, the chart shows the total IOPS for the primary.

For a sharded cluster, the chart shows the sum of IOPS on each primary in the cluster.

View Metrics for an Atlas Replica Set

To view the metrics for a specific Atlas cluster in a project, click the Metrics button for that cluster. Alternatively, click on the name of the cluster to open the cluster overview, then click the Metrics tab.

The Metrics view has three distinct sections:

Chart Controls

Atlas provides the following controls for the Metric view. Adjusting any of these options affects all charts displayed under the Metrics view:

Control	Function
Granularity	Modifies the granularity of metrics displayed for each chart. Select a granularity between 1 minute and 1 day (24 hours). Select `Auto` to automatically adjust the granularity based on the selected Zoom or Current Display date controls. `Auto` granularity selects the highest fidelity granularity available for the time range.
Zoom	Modifies the date range of metrics displayed for each chart. Select a zoom range between 1 hour and 5 years. Adjusting the Zoom automatically adjusts the Current Display date range.
Current Display	Modifies the start and end date-time range of metrics displayed for each chart. Modifying the start and end date sets the value of Zoom to `custom` and overrides the previously selected zoom level.
Toggle Members	Limit charts to the selected replica set members. The `P` icon represents the Primary replica set member, while the `S` icon represents a Secondary member.
Add Chart	Select one or more charts to display or hide. Adding charts using this dropdown is identical to adding charts from the Toggle Charts section of the Metrics view.
Display Opcounters on Separate Charts	Directs Atlas to split the Opcounters chart into its individual components. You can then choose to chart one or more of those components.
Display Timeline Annotations	Directs Atlas to display or hide chart annotations. Chart annotations consist of colored vertical lines that indicate server events, such as a server restart or a transition in member state.

Chart Display

When viewing charts, you can do the following:

Task	Action
View a detailed description of a chart.	Hover your mouse over the chart to display the context menu. Click the i icon next to the chart name to open the Chart Info modal. This modal includes a breakdown of the chart’s data series, the annotations available for that chart, and the operations the chart supports.
Expand a chart.	Hover your mouse over the chart to display the context menu. Click the two-way arrow at the top right of the chart.
Zoom in on a period of time.	Click and drag the mouse pointer over a portion of the chart. To reset to the originally selected range (zoom out), double-click the chart. Note When you zoom in on a period of time, the Current Display date range in the chart control section automatically updates to reflect the selected period.
View statistics at a particular time.	Hover the mouse pointer over a point on the chart.
Move a chart.	Click and hold the grabber in the upper left corner of the chart, and drag the chart to the new position.
Share a URL to the chart.	Hover your mouse over the chart to display the context menu. Click the curved arrow on the chart. Select Chart Permalink to retrieve a URL to the chart. Select Email Chart to e-mail the chart. The recipient of the chart URL must have a Atlas user account with access to the project and cluster.

Chart Selection

Atlas displays the available metrics to chart for the selected cluster under the Toggle Charts header. Metrics are grouped into two sections:

MongoDB Metrics

Metrics associated with the MongoDB process. For metrics related to database performance, such as DB Storage, Atlas presents the sum total across all databases in the cluster.

If you enable Display Opcounters on Separate Charts, Atlas replaces the Opcounters option with the individual components of that chart.

Hardware Metrics

Metrics associated with the host machines supporting the cluster.

Charts marked with the + symbol are inactive, while charts marked with the - symbol are active. Click on any chart to toggle the chart state.

View Metrics for an Atlas Sharded Cluster

To view the metrics for a specific Atlas cluster in a project, click the Metrics button for that cluster. Alternatively, click on the name of the cluster to open the cluster overview, then click the Metrics tab.

The Metrics view has three distinct sections:

Chart Controls

Atlas provides the following controls for the Metric view:

Control	Function
Granularity	Modifies the granularity of metrics displayed for each chart. Select a granularity between 1 minute and 1 day (24 hours). Select `Auto` to automatically adjust the granularity based on the selected Zoom or Current Display date controls. `Auto` granularity selects the highest fidelity granularity available for the time range.
Zoom	Modifies the date range of metrics displayed for each chart. Select a zoom range between 1 hour and 5 years. Adjusting the Zoom automatically adjusts the Current Display date range.
Display Data	Directs Atlas to display data based on the selected optio `Individually` - displays the selected metrics for each shard as an individual line. `Sum` - displays the sum of the selected metrics across all shards in the cluster. `Averaged` - displays the average of the selected metrics across all shards in the cluster.
Current Display	Modifies the start and end date-time range of metrics displayed for each chart. Modifying the start and end date sets the value of Zoom to `custom` and overrides the previously selected zoom level.
Display	Selects which metric to chart. You can display no more than one chart at a time.
View	Selects which sharded cluster components to display `SHARDS` - displays metrics for each shard in the sharded cluster. `MONGOS` - displays metrics for each `bin.mongos` in the sharded cluster. `CONFIGS` - displays metrics for the config server in the sharded cluster config server replica set.

Chart Display

When viewing charts, you can do the following:

Task

Action

Zoom in on a period of time.

Click and drag the mouse pointer over a portion of the chart.

To reset to the originally selected range (zoom out), double-click the chart.

Note

When you zoom in on a period of time, the Current Display date range in the chart control section automatically updates to reflect the selected period.

View statistics at a particular time.

Hover the mouse pointer over a point on the chart.

Data Sources

Atlas displays each data source that contributes to the metric chart in a table below the chart. The table consists of the following:

Column	Description
Shard Name	When View is set to `SHARDS`, displays the name of each shard in the sharded cluster. When View is set to `MONGOS` or `CONFIGS`, displays the name of each `mongos` or config server `mongod` process in the cluster. Click on a listed component to open the Metrics view for that component.
Alerts	Indicates if there are any open alerts for the listed shard or process. Click on the alert icon to open the Alerts view for that shard or process. For more information on responding to open alerts, see Respond to Alerts.
Data Size	Only visible if View is set to `SHARDS`. Indicates the logical size of all documents and indexes on the shard.
Show	Only visible if View is set to `SHARDS` Indicates which replica set members to show on the selected chart. Select `Primaries`, `Secondaries` or `All`.
Read, Write, and Queued	Metric data related to the displayed chart. Hover over the corresponding column for a pop up with detailed information on the metrics shown.

View Metrics for a Single MongoDB Process

To view the metrics for a specific MongoDB process in a Atlas cluster, click on that process from the cluster view. The Atlas process view displays three tabs for monitoring metrics for the process:

The Status tab displays the process metrics Atlas collects from the selected mongod or mongos process.
The Hardware tab displays hardware metrics for the host machine supporting the selected mongod or mongos process.
The DB Stats tab displays the database metrics for the selected database.

Atlas retrieves database metrics every 20 minutes by default but adjusts frequency when necessary to reduce the impact on database performance. If the collection of database statistics still affects performance, you can disable collection by clicking Settings from the left-hand navigation, then Project Settings, and then setting Collect Database Specific Statistics to No.

The view for each tab has three distinct sections:

Chart Controls

Atlas provides the following controls for the Status, Hardware, and DB Stats views. Adjusting any of these options affects all charts displayed under the selected view:

Control	Function
Granularity	Modifies the granularity of metrics displayed for each chart. Select a granularity between 1 minute and 1 day (24 hours). Select `Auto` to automatically adjust the granularity based on the selected Zoom or Current Display date controls. `Auto` granularity selects the highest fidelity granularity available for the time range.
Zoom	Modifies the date range of metrics displayed for each chart. Select a zoom range between 1 hour and 5 years. Adjusting the Zoom automatically adjusts the Current Display date range.
Current Display	Modifies the start and end date-time range of metrics displayed for each chart. Modifying the start and end date sets the value of Zoom to `custom` and overrides the previously selected zoom level.
Add Chart	Select one or more charts to display or hide. Adding charts using this dropdown is identical to adding charts from the Toggle Charts section of the Metrics view.
Select Database	Only visible for the DB Stats view. Selects the database for which to display metrics.
Display Opcounters on Separate Charts	Directs Atlas to split the Opcounters chart into its individual components. You can then choose to chart one or more of those components.
Display Timeline Annotations	Directs Atlas to display or hide chart annotations. Chart annotations consist of colored vertical lines that indicate server events, such as a server restart or a transition in member state.

Chart Display

When viewing charts, you can do the following:

Task	Action
View a detailed description of a chart.	Hover your mouse over the chart to display the context menu. Click the i icon next to the chart name to open the Chart Info modal. This modal includes a breakdown of the chart’s data series, the annotations available for that chart, and the operations the chart supports.
Expand a chart.	Hover your mouse over the chart to display the context menu. Click the two-way arrow at the top right of the chart.
Zoom in on a period of time.	Click and drag the mouse pointer over a portion of the chart. To reset to the originally selected range (zoom out), double-click the chart. Note When you zoom in on a period of time, the Current Display date range in the chart control section automatically updates to reflect the selected period.
View statistics at a particular time.	Hover the mouse pointer over a point on the chart.
Move a chart.	Click and hold the grabber in the upper left corner of the chart, and drag the chart to the new position.
Share a URL to the chart.	Hover your mouse over the chart to display the context menu. Click the curved arrow on the chart. Select Chart Permalink to retrieve a URL to the chart. Select Email Chart to e-mail the chart. The recipient of the chart URL must have a Atlas user account with access to the project and cluster.

Chart Selection

Atlas displays the available metrics to chart for the selected cluster under the Toggle Charts header.

Charts marked with the + symbol are inactive, while charts marked with the - symbol are active. Click on any chart to toggle the chart state.

View Real Time Cluster Metrics

Availability

Atlas supports Real Time metrics for mongod or mongos processes and replica set clusters. For sharded clusters, you can view Real Time metrics for each shard replica set.

You must have the Project Owner Atlas user role to access the Real Time tab.

To view Real Time metrics for a specific Atlas cluster in a project, click the Metrics button for that cluster. Alternatively, click on the name of the cluster to open the cluster overview, then click the Metrics tab. From the Metrics tab, click Real Time to open the Real-Time Performance Panel.

For complete documentation on the Atlas real time metrics, see Real-Time Performance Panel

← Monitoring and Alerts Respond to Alerts →