Navigation

View Metrics

On this page

Overview

Cloud Manager provides charts for analyzing the statistics collected by the Monitoring Agent for your deployment’s mongod and mongos processes. The agent collects metrics using several MongoDB diagnostic commands, including serverStatus and dbStats.

Cloud Manager also provides charts for analyzing hardware statistics collected by the Automation Agents. Hardware metrics are available only for automated deployments. The Automation Agents collect the metrics for the servers that run the managed MongoDB processes.

Data Granularity

You can view data at different granularities and time periods. Charts default to the last granularity used. Cloud Manager gathers metric data at the granularity specified by your Cloud Manager plan. See Monitoring Metrics Per Cloud Manager Plan.

Data Retention

Cloud Manager preserves metric data at the granularities specified for your Cloud Manager plan See Monitoring Metrics Per Cloud Manager Plan. Data-retention policies, as defined in the Terms of Service, are always subject to change.

View Metrics

To view metrics, click Deployment and then click the Metrics button for the sharded cluster, replica set, or individual MongoDB process.

To add or remove charts, click either the Display or Add Chart drop-down list, depending on which is available. To display a chart’s controls, hover the mouse pointer over the chart. To view metrics for a different level in the topology of a sharded cluster or replica set, use the breadcrumb.

For additional information on displayed metrics, see the following on this page:

Sharded Cluster Metrics

When you view metrics for a sharded cluster, you can choose to display either the shards, mongos instances, or config servers. For a shard you can use the buttons below the chart to select primaries, secondaries, or both. Cloud Manager displays different processes as different lines.

To sum or average the data, click the Display Data drop-down list and select the desired option. To change charts, click the Display drop-down list.

Replica Set Metrics

When you view metrics for a replica set, you can limit the display to particular types of members using the P, S, and A options.

To add or remove charts, click the Add Chart drop-down list or click the buttons at the bottom of the page. To remove a chart, deselect it.

Real-Time Tab

Availability

Real-time metrics is available for MongoDB deployments managed by Automation, using Automation Agent version 3.3.1 or greater.

Real-time metrics is also available for MongoDB Atlas.

Click the Real-Time tab to display various real-time metrics.

You can view the stats in either Table view or the Graph view.

Table View

Fields Description
Resident
Virtual
Mapped
Displays the resident/virtual/mapped memory stats as reported by mongostat. For a description of the fields, see mongostat.
Bytes In
Bytes Out
Connections
Displays the connection stats (number of bytes in, number of bytes out, number of connections) as reported by mongostat. For a description of the fields, see mongostat.
Commands
Queries
Updates
Deletes
Inserts
GetMores
Displays the number of the specified operations (commands, queries, etc.) as reported by mongostat. For a description of the fields, see mongostat.
Active Readers
Active Writers
Queued Readers
Queued Writers
Displays the number of active reads, queued reads, active writes, queued writes as reported by mongostat. For a description of the fields, see mongostat.

Click on the elipsis button (...) to hide or display fields from the table.

Graph View

Chart/Table Description
Memory Displays the memory stats as reported by mongostat. For a description of the fields, see mongostat.
Network Displays the connection stats as reported by mongostat. For a description of the fields, see mongostat.
Operations Displays the number of operations as reported by mongostat. For a description of the fields, see mongostat.
Reads & Writes Displays the number of active reads, queued reads, active writes, queued writes as reported by mongostat. For a description of the fields, see mongostat.
Hottest Collections

Displays the collections with the most operations as reported by mongotop. For each hot collection, the table also displays the Utilization Percent for the collection.

Utilization Percent is calculated from the read and write times as reported by mongotop during a sample period. Specifically, the Utilization Percent is the percentage (rounded to the nearest 0.1%) of the read and write times for a collection relative to the read and write times for all collections in the deployment during the sample period. If no read and write operation occur during this period, the Utilization Percent may be 0%.

The hottest collections correspond to the most current time displayed in the charts. That is, if the display is running (i.e. not paused), the collections correspond to the hottest collections at the current timestamp. If the display is paused, the collections correspond to the hottest collections at the paused time.

Slowest Operations

Displays the slowest operations as reported by db.currentOp().

The operations correspond to the most current time displayed in the charts. That is, if the display is running (i.e. not paused), the operations correspond to the slowest operations at the current timestamp. If the display is paused, the operations correspond to the slowest operations at the paused time.

Click on the operation to view the detailed JSON document as reported by db.currentOp() for the operation. If you are a user with Data Access Admin role, the Kill Op button will display in the operation details panel. You can click the button to kill the slow operation.

To hide/show a metric in the graph, click on the color box for the metric.

Stop and Restart Display

To stop the update of the stats displayed, click the Pause button. The Pause button only stops the update of the displays and does not pause the collection of the underlying data.

To restart the display updates, click Play.

Status Tab

This tab displays process metrics the Monitoring Agent collects from the selected mongod or mongos process. The agent collects a subset of the output of the MongoDB serverStatus and explain commands.

Hardware Tab

Important

As of Automation Agent 2.7.0, hardware monitoring using munin-node is deprecated.

If you run munin-node on your MongoDB servers then install or upgrade to Automation Agent version 2.7.0 or later, Cloud Manager displays the hardware data that the Automation Agent collected, not what Munin had collected. The historical hardware data Munin collected is neither displayed nor saved.

If you run Munin but not the Automation Agent, Cloud Manager displays the Munin charts.

The Automation Agent collects the following hardware metrics for your mongod and mongos processes:

Chart Data
System CPU The CPU usage of all processes (not just MongoDB processes) on the host server. For servers with more than 1 CPU core, this value can exceed 100%.
Normalized System CPU The CPU usage of all processes (not just MongoDB processes) on the host server, scaled to a range of 0-100% by dividing by the number of CPU cores.
Process CPU The CPU usage of the MongoDB process. For servers with more than 1 CPU core, this value can exceed 100%.
Normalized Process CPU The CPU usage of the MongoDB process, scaled to a range of 0-100% by dividing by the number of CPU cores.
Disk Space Free - <partition> The total bytes of free disk space on the disk partition used by MongoDB.
Util % - <partition> The percentage of time during which requests are being issued to and serviced by the partition. This includes requests from any process, not just MongoDB processes.
Disk IOPS - <partition> The throughput of I/O operations per second for the disk partition used for MongoDB.
Disk Space Percent Free - <partition> The percent of free disk space on the partition used by MongoDB.
Disk Latency - <partition> The latency in milliseconds of the disk partition used by MongoDB.
Disk Space Used - <partition> The total bytes of used disk space on the partition that runs MongoDB.

DB Stats Tab

This tab displays database metrics the Monitoring Agent collects through the MongoDB dbStats command. The agent collects a subset of dbStats output. See dbStats in the MongoDB manual.

The agent retrieves database metrics every 20 minutes by default but adjusts frequency when necessary to reduce the impact on database performance. You can disable the collection of database statistics by clicking Settings, then Project Settings, and then setting Collect Database Specific Statistics to No.

To select which database to display, click the Select Database drop-down list.

Chart Controls

When viewing charts, you can do the following:

Task Action
View a chart’s description. Click the i icon next to the chart name. (Not available for cluster-level chart)
Expand a chart. 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, double-click the chart.

Note

When you zoom, the time selections above the charts automatically update to reflect the new period displayed.

View point-in-time statistics. 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.
Export the charts. Click the Export drop-down list and select the format.
Link to a chart. Click the curved arrow on the chart and select Chart Permalink.
Email the chart. Click the curved arrow on the chart and select Email Chart.