Navigation
This version of the documentation is archived and no longer supported. To learn how to upgrade your version of MongoDB Ops Manager, refer to the upgrade documentation.
You were redirected from a different version of the documentation. Click here to go back.

Measurement Types

The measurements endpoint returns the available measurement types for use with the Ops Manager Measurements API resource.

Host Measurements

  • ASSERT_REGULAR
  • ASSERT_WARNING
  • ASSERT_MSG
  • ASSERT_USER
Rate of asserts for a MongoDB process found in the asserts document that the serverStatus command generates.
  • BACKGROUND_FLUSH_AVG
Amount of data flushed in the background.
  • CACHE_BYTES_READ_INTO
  • CACHE_BYTES_WRITTEN_FROM
  • CACHE_DIRTY_BYTES
  • CACHE_USED_BYTES
  • TICKETS_AVAILABLE_READS
  • TICKETS_AVAILABLE_WRITE
Amount of bytes in the WiredTiger storage engine cache and tickets found in the wiredTiger.cache and wiredTiger.concurrentTransactions documents that the serverStatus command generates.
  • CONNECTIONS
Number of connections to a MongoDB process found in the connections document that the serverStatus command generates.
  • CURSORS_TOTAL_OPEN
  • CURSORS_TOTAL_TIMED_OUT
Number of cursors for a MongoDB process found in the metrics.cursor document that the serverStatus command generates.
  • EXTRA_INFO_PAGE_FAULTS
  • GLOBAL_ACCESSES_NOT_IN_MEMORY
  • GLOBAL_PAGE_FAULT_EXCEPTIONS_THROWN
Numbers of Memory Issues and Page Faults for a MongoDB process.
  • GLOBAL_LOCK_CURRENT_QUEUE_TOTAL
  • GLOBAL_LOCK_CURRENT_QUEUE_READERS
  • GLOBAL_LOCK_CURRENT_QUEUE_WRITERS
Number of operations waiting on locks for the MongoDB process that the serverStatus command generates. Ops Manager computes these values based on the type of storage engine.
  • INDEX_COUNTERS_BTREE_ACCESSES
  • INDEX_COUNTERS_BTREE_HITS
  • INDEX_COUNTERS_BTREE_MISSES
  • INDEX_COUNTERS_BTREE_MISS_RATIO
Number of index btree operations.
  • JOURNALING_COMMITS_IN_WRITE_LOCK
  • JOURNALING_MB
  • JOURNALING_WRITE_DATA_FILES_MB
Number of journaling operations.
  • MEMORY_RESIDENT
  • MEMORY_VIRTUAL
  • MEMORY_MAPPED
  • COMPUTED_MEMORY
Amount of memory for a MongoDB process found in the mem document that the serverStatus command collects.
  • NETWORK_BYTES_IN
  • NETWORK_BYTES_OUT
  • NETWORK_NUM_REQUESTS
Amount of throughput for MongoDB process found in the network document that the serverStatus command collects.
  • OPLOG_REPLICATION_LAG_TIME
  • OPLOG_RATE_GB_PER_HOUR
  • OPLOG_MASTER_TIME
  • OPLOG_MASTER_LAG_TIME_DIFF
Durations and throughput of the MongoDB process’ oplog. The OPLOG_SLAVE_LAG_MASTER_TIME metric is deprecated in the measurement API. Use the OPLOG_REPLICATION_LAG_TIME metric instead. It returns decimal values (seconds and milliseconds). For example, the value 2.75 means 2 seconds and 750 milliseconds.
  • DB_STORAGE_TOTAL
  • DB_DATA_SIZE_TOTAL
On-disk storage space as collected from the MongoDB dbStats command.
  • OPCOUNTER_CMD
  • OPCOUNTER_QUERY
  • OPCOUNTER_UPDATE
  • OPCOUNTER_DELETE
  • OPCOUNTER_GETMORE
  • OPCOUNTER_INSERT
Rate of database operations on a MongoDB process since the process last started found in the opcounters document that the serverStatus command collects.
  • OPCOUNTER_REPL_CMD
  • OPCOUNTER_REPL_UPDATE
  • OPCOUNTER_REPL_DELETE
  • OPCOUNTER_REPL_INSERT
Rate of database operations on MongoDB secondaries found in the opcountersRepl document that the serverStatus command collects.
  • DOCUMENT_METRICS_RETURNED
  • DOCUMENT_METRICS_INSERTED
  • DOCUMENT_METRICS_UPDATED
  • DOCUMENT_METRICS_DELETED
Average rate of documents returned, inserted, updated, or deleted per second during a selected time period.
  • OPERATIONS_SCAN_AND_ORDER
Average rate for operations per second during a selected time period that perform a sort but cannot perform the sort using an index.
  • OP_EXECUTION_TIME_READS
  • OP_EXECUTION_TIME_WRITES
  • OP_EXECUTION_TIME_COMMANDS

Average execution time in milliseconds per read, write, or command operation during a selected time period.

Available to hosts running MongoDB 3.4 or later.

  • RESTARTS_IN_LAST_HOUR
Number of times the host restarted within the previous hour.
  • SYSTEM_MEMORY_USED
  • SYSTEM_MEMORY_FREE
  • SYSTEM_MEMORY_AVAILABLE
Physical memory usage, in bytes.
  • SYSTEM_NETWORK_BYTES_IN
  • SYSTEM_NETWORK_BYTES_OUT
Network throughput in bytes per second.
  • SWAP_USAGE_USED
  • SWAP_USAGE_FREE
Total amount swap space in use.
  • QUERY_EXECUTOR_SCANNED
Average rate per second to scan index items during queries and query-plan evaluations found in the value of totalKeysExamined from the explain command.
  • QUERY_EXECUTOR_SCANNED_OBJECTS
Average rate of documents scanned per second during queries and query-plan evaluations found in the value of totalDocsExamined from the explain command.
  • QUERY_TARGETING_SCANNED_PER_RETURNED
Ratio of the number of index items scanned to the number of documents returned.
  • QUERY_TARGETING_SCANNED_OBJECTS_PER_RETURNED
Ratio of the number of documents scanned to the number of documents returned.

Process Measurements

  • PROCESS_CPU_USER
  • PROCESS_CPU_KERNEL
  • PROCESS_CPU_CHILDREN_USER
  • PROCESS_CPU_CHILDREN_KERNEL

MongoDB CPU usage. For hosts with more than one CPU core, these values can exceed 100%.

Requires Ops Manager Automation.

  • PROCESS_NORMALIZED_CPU_USER
  • PROCESS_NORMALIZED_CPU_KERNEL
  • PROCESS_NORMALIZED_CPU_CHILDREN_USER
  • PROCESS_NORMALIZED_CPU_CHILDREN_KERNEL

MongoDB CPU usage scaled to a range of 0% to 100% by dividing by the number of CPU cores.

Requires Ops Manager Automation.

System Measurements

  • SYSTEM_CPU_USER
  • SYSTEM_CPU_KERNEL
  • SYSTEM_CPU_NICE
  • SYSTEM_CPU_IOWAIT
  • SYSTEM_CPU_IRQ
  • SYSTEM_CPU_SOFTIRQ
  • SYSTEM_CPU_GUEST
  • SYSTEM_CPU_STEAL

CPU usage of processes on the host. For hosts with more than one CPU core, this value can exceed 100%.

Requires Ops Manager Automation.

  • SYSTEM_NORMALIZED_CPU_USER
  • SYSTEM_NORMALIZED_CPU_KERNEL
  • SYSTEM_NORMALIZED_CPU_NICE
  • SYSTEM_NORMALIZED_CPU_IOWAIT
  • SYSTEM_NORMALIZED_CPU_IRQ
  • SYSTEM_NORMALIZED_CPU_SOFTIRQ
  • SYSTEM_NORMALIZED_CPU_GUEST
  • SYSTEM_NORMALIZED_CPU_STEAL

CPU usage of processes on the host scaled to a range of 0 to 100% by dividing by the number of CPU cores.

Requires Ops Manager Automation.

  • SYSTEM_MEMORY_USED
  • SYSTEM_MEMORY_FREE
  • SYSTEM_MEMORY_AVAILABLE
Physical memory usage, in bytes.
  • SYSTEM_NETWORK_BYTES_IN
  • SYSTEM_NETWORK_BYTES_OUT
Network throughput in bytes per second.
  • SWAP_USAGE_USED
  • SWAP_USAGE_FREE
Total amount swap space in use.

Disk Measurements

  • DISK_PARTITION_IOPS_READ
  • DISK_PARTITION_IOPS_WRITE
  • DISK_PARTITION_IOPS_TOTAL

Number of Input/Output operations for the disk partition that hosts MongoDB.

Requires Ops Manager Automation.

  • DISK_PARTITION_UTILIZATION

Percentage of time when the partition issues and services requests. This includes requests from any process, not just MongoDB processes.

Requires Ops Manager Automation.

  • DISK_PARTITION_LATENCY_READ
  • DISK_PARTITION_LATENCY_WRITE

Latency per operation type of the disk partition that hosts MongoDB.

Requires Ops Manager Automation.

  • DISK_PARTITION_SPACE_FREE
  • DISK_PARTITION_SPACE_USED
  • DISK_PARTITION_SPACE_PERCENT_FREE
  • DISK_PARTITION_SPACE_PERCENT_USED
Measures the free disk space and used disk space on the disk partition used by MongoDB. Only available if you use Ops Manager Automation.

Database Measurements

  • DATABASE_WRITE_LOCK_PERCENTAGE
Duration that the host is write locked.
  • DATABASE_AVERAGE_OBJECT_SIZE
  • DATABASE_COLLECTION_COUNT
  • DATABASE_DATA_SIZE
  • DATABASE_FILE_SIZE
  • DATABASE_STORAGE_SIZE
  • DATABASE_INDEX_SIZE
  • DATABASE_INDEX_COUNT
  • DATABASE_EXTENT_COUNT
  • DATABASE_OBJECT_COUNT

Amount of disk storage that database uses on-disk storage space found from the MongoDB dbStats command.

By default, the Monitoring retrieves database measurements every 20 minutes but adjusts frequency when necessary to reduce the impact on database performance. To disable collecting database statistics in the Ops Manager, click Settings, then click Group Settings, and then set Collect Database Specific Statistics to No.