- Monitoring and Alerts >
- Monitor a Cluster
Monitor a Cluster¶
On this page
Atlas collects and displays metrics for your servers, databases, and MongoDB processes.
Note
The number of servers displayed on the Metrics page at any given time
depends on the browser screen size. You can utilize the Toggle Members
section to control which servers get displayed. Hover over the S and P icons to
find out which servers they represent.
- All Cluster Metrics
- Replica Set Metrics
- Sharded Cluster Metrics
- MongoDB Process Metrics
- Real Time Metrics
- Other
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
|
Displays the sum of total bytes of the documents and index data across all databases in the cluster. |
Disk Usage
|
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
|
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. |
Full Text Search Operations Clusters with Active FTS Indexes Only |
Charts which show several metrics associated with Full Text Search operations, including disk space used by Full Text Search indexes, Full Text Search process CPU usage, and Full Text Search memory usage. |
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
Sharded Cluster Metric Rendering Limits In the Sharded Cluster metrics view, Atlas renders a maximum of:
As a result, when rendering metrics for large deployments over a long period of time, Atlas may display metrics at a lower granularity than expected. To learn more about the granularity at which Atlas stores metric data, see Monitoring Data Storage Granularity. |
| 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 option
|
| 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
|
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 When View is set to 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 Indicates the logical size of all documents and indexes on the shard. |
| Show | Only visible if View is set to Indicates which replica set members to show on the selected
chart. Select |
| 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
mongodormongosprocess.The Hardware tab displays hardware metrics for the host machine supporting the selected
mongodormongosprocess.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
View Full Text Search Metrics
Availability
Full Text Search metrics are available for Atlas clusters with at least one active Full Text Search index. To set up an Full Text Search index, see Full Text Search.
The following Full Text Search metrics are available:
- FTS Process Memory
- FTS Process CPU
- FTS Normalized Process CPU
- FTS Disk Space Used
Chart Controls
Atlas provides the following controls for the metrics charts. 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.
Monitoring Data Storage Granularity¶
Atlas stores metrics data at increasing granularity levels. For each increasing granularity level, Atlas computes the metrics data based on the averages from the previous granularity level. The length of retention depends on the granularity. Atlas computes the metrics data based on the averages from the previous granularity level.
Example
After 48 hours’ worth of data is collected, each group of 60 minutes is compacted into a single unit of an hour. After 63 days, each group of 24 hours is compacted into a single unit of a day.
Metrics data is gathered at a 1-minute granularity. Atlas retains different granularities of metric data for different periods of time:
| Data Period | Duration of Retention |
|---|---|
| 1 minute | 48 hours |
| 5 minutes | 48 hours |
| 1 hour | 63 days |
| 1 day | Forever |
Atlas retains all database-specific statistics. MongoDB log data is retained at a maximum rate of 2000 lines per 2 minutes.