For SaaS deployments of MongoDB where the Dynatrace OneAgent cannot be installed.
This extension enables insights into the overall health of your Atlas projects, clusters and nodes.
Activate the extension in your environment using the in-product Hub. Provide the required configuration settings, such as the project ID and API access keys. Follow the instructions and prompts within the extension settings.
Details
This extension uses the Atlas Administration API to fetch important metrics and metadata for your projects, clusters, and nodes.
DQL and Logs
You can set the extension to fetch important project events as Dynatrace log events.
If enabled, all Mongo events are ingested into Dynatrace.
Mongo alert-types. Note that not all supported Atlas events might be referenced.
You can specify a comma-separated list of events to collect if you want to ingest only specific event types, for example CREDIT_CARD_ABOUT_TO_EXPIRE, NO_PRIMARY, CPS_SNAPSHOT_FALLBACK_FAILED, NDS_X509_USER_AUTHENTICATION_MANAGED_USER_CERTS_EXPIRATION_CHECK.
All events are ingested as Info severity logs. You can configure log processing rules in Dynatrace to automatically raise this severity for specific event types.
The extension monitors all clusters (deployments) within a Mongo Atlas project.
Each cluster then has a number of nodes (processes) which is where the metrics are collected from.
If you also want to collect disk metrics, then the disk metrics are collected from each node partition.
So, a general formula for the number of metrics would be:
Process Metrics (Total = 108):num_process_metrics = Number of projects * Clusters in project * Nodes per Cluster * 108
Disk Metrics (Total = 18):num_disk_metrics = Number of projects * Clusters in project * Nodes per Cluster * Partitions per Node * 18
Total metrics:Total_metrics = num_process_metrics + num_disk_metrics
You can use the feature sets defined below to enable/disable the collection of specific metric categories.
Feature sets
When activating your extension using monitoring configuration, you can limit monitoring to one of the feature sets. To work properly, the extension has to collect at least one metric after the activation.
In highly segmented networks, feature sets can reflect the segments of your environment. Then, when you create a monitoring configuration, you can select a feature set and a corresponding ActiveGate group that can connect to this particular segment.
All metrics that aren't categorized into any feature set are considered to be the default and are always reported.
A metric inherits the feature set of a subgroup, which in turn inherits the feature set of a group. Also, the feature set defined on the metric level overrides the feature set defined on the subgroup level, which in turn overrides the feature set defined on the group level.
process-ticket
Metric name
Metric key
Description
TICKETS_AVAILABLE_READS
mongo.atlas.TICKETS_AVAILABLE_READS
The number of read tickets available to the WiredTiger storage engine.
TICKETS_AVAILABLE_WRITE
mongo.atlas.TICKETS_AVAILABLE_WRITE
The number of write tickets available to the WiredTiger storage engine.
process-cache
Metric name
Metric key
Description
CACHE_BYTES_READ_INTO
mongo.atlas.CACHE_BYTES_READ_INTO
Read - Amount of bytes in the WiredTiger storage engine cache
CACHE_BYTES_WRITTEN_FROM
mongo.atlas.CACHE_BYTES_WRITTEN_FROM
Write - Amount of bytes in the WiredTiger storage engine cache
CACHE_DIRTY_BYTES
mongo.atlas.CACHE_DIRTY_BYTES
Amount of dirty bytes in the WiredTiger storage engine cache
CACHE_USED_BYTES
mongo.atlas.CACHE_USED_BYTES
Amount of used bytes in the WiredTiger storage engine cache
process-op-execution
Metric name
Metric key
Description
OP_EXECUTION_TIME_COMMANDS
mongo.atlas.OP_EXECUTION_TIME_COMMANDS
The average execution time in milliseconds per command operation over the selected sample period.
OP_EXECUTION_TIME_READS
mongo.atlas.OP_EXECUTION_TIME_READS
The average execution time in milliseconds per read operation over the selected sample period.
OP_EXECUTION_TIME_WRITES
mongo.atlas.OP_EXECUTION_TIME_WRITES
The average execution time in milliseconds per write operation over the selected sample period.
process-document
Metric name
Metric key
Description
DOCUMENT_METRICS_DELETED
mongo.atlas.DOCUMENT_METRICS_DELETED
Average rate of documents DELETED.
DOCUMENT_METRICS_INSERTED
mongo.atlas.DOCUMENT_METRICS_INSERTED
Average rate of documents INSERTED.
DOCUMENT_METRICS_RETURNED
mongo.atlas.DOCUMENT_METRICS_RETURNED
Average rate of documents RETURNED.
DOCUMENT_METRICS_UPDATED
mongo.atlas.DOCUMENT_METRICS_UPDATED
Average rate of documents UPDATED.
process-index
Metric name
Metric key
Description
INDEX_COUNTERS_BTREE_ACCESSES
mongo.atlas.INDEX_COUNTERS_BTREE_ACCESSES
Number of index btree ACCESSES.
INDEX_COUNTERS_BTREE_HITS
mongo.atlas.INDEX_COUNTERS_BTREE_HITS
Number of index btree HITS.
INDEX_COUNTERS_BTREE_MISS_RATIO
mongo.atlas.INDEX_COUNTERS_BTREE_MISS_RATIO
index btree miss ratio
INDEX_COUNTERS_BTREE_MISSES
mongo.atlas.INDEX_COUNTERS_BTREE_MISSES
Number of index btree MISSES.
system-memory
Metric name
Metric key
Description
SYSTEM_MEMORY_USED
mongo.atlas.SYSTEM_MEMORY_USED
Physical memory used, in bytes
SYSTEM_MEMORY_AVAILABLE
mongo.atlas.SYSTEM_MEMORY_AVAILABLE
Physical memory available, in bytes
SYSTEM_MEMORY_FREE
mongo.atlas.SYSTEM_MEMORY_FREE
Physical memory free, in bytes
MAX_SYSTEM_MEMORY_USED
mongo.atlas.MAX_SYSTEM_MEMORY_USED
MAX Physical memory used, in bytes
MAX_SYSTEM_MEMORY_AVAILABLE
mongo.atlas.MAX_SYSTEM_MEMORY_AVAILABLE
MAX Physical memory available, in bytes
MAX_SYSTEM_MEMORY_FREE
mongo.atlas.MAX_SYSTEM_MEMORY_FREE
MAX Physical memory free, in bytes
process-network
Metric name
Metric key
Description
NETWORK_BYTES_IN
mongo.atlas.NETWORK_BYTES_IN
MongoDB process incoming network throughput, in bytes per second.
NETWORK_BYTES_OUT
mongo.atlas.NETWORK_BYTES_OUT
MongoDB process outgoing network throughput, in bytes per second.
NETWORK_NUM_REQUESTS
mongo.atlas.NETWORK_NUM_REQUESTS
The total number of distinct requests that the MongoDB process has received.
database-count
Metric name
Metric key
Description
—
mongo.atlas.DATABASE_COLLECTION_COUNT
—
—
mongo.atlas.DATABASE_INDEX_COUNT
—
—
mongo.atlas.DATABASE_EXTENT_COUNT
—
—
mongo.atlas.DATABASE_OBJECT_COUNT
—
—
mongo.atlas.DATABASE_VIEW_COUNT
—
database-size
Metric name
Metric key
Description
DATABASE_AVERAGE_OBJECT_SIZE
mongo.atlas.DATABASE_AVERAGE_OBJECT_SIZE
Average size of each document in bytes.
DATABASE_DATA_SIZE
mongo.atlas.DATABASE_DATA_SIZE
Total size of the uncompressed data held in the database.
DATABASE_STORAGE_SIZE
mongo.atlas.DATABASE_STORAGE_SIZE
Sum of the disk space allocated to all collections in the database for document storage, including free space.
DATABASE_INDEX_SIZE
mongo.atlas.DATABASE_INDEX_SIZE
Sum of the disk space allocated to all indexes in the database, including free index space.
process-assert
Metric name
Metric key
Description
ASSERT_MSG
mongo.atlas.ASSERT_MSG
Rate of MSG asserts for a MongoDB process
ASSERT_REGULAR
mongo.atlas.ASSERT_REGULAR
Rate of REGULAR asserts for a MongoDB process
ASSERT_USER
mongo.atlas.ASSERT_USER
Rate of USER asserts for a MongoDB process
ASSERT_WARNING
mongo.atlas.ASSERT_WARNING
Rate of WARNING asserts for a MongoDB process
process-oplog
Metric name
Metric key
Description
OPLOG_MASTER_LAG_TIME_DIFF
mongo.atlas.OPLOG_MASTER_LAG_TIME_DIFF
—
OPLOG_MASTER_TIME
mongo.atlas.OPLOG_MASTER_TIME
—
OPLOG_RATE_MB_PER_MIN
mongo.atlas.OPLOG_RATE_MB_PER_MIN
Oplog rate (MB/min) - calculated from Atlas metric OPLOG_RATE_GB_PER_HOUR
OPLOG_SLAVE_LAG_MASTER_TIME
mongo.atlas.OPLOG_SLAVE_LAG_MASTER_TIME
—
—
mongo.atlas.OPLOG_REPLICATION_LAG
—
system-network
Metric name
Metric key
Description
SYSTEM_NETWORK_IN
mongo.atlas.SYSTEM_NETWORK_IN
Incoming network throughput in bytes per second.
SYSTEM_NETWORK_OUT
mongo.atlas.SYSTEM_NETWORK_OUT
Outgoing network throughput in bytes per second.
MAX_SYSTEM_NETWORK_IN
mongo.atlas.MAX_SYSTEM_NETWORK_IN
MAX Incoming network throughput in bytes per second.
MAX_SYSTEM_NETWORK_OUT
mongo.atlas.MAX_SYSTEM_NETWORK_OUT
MAX Outgoing network throughput in bytes per second.
disk-iops
Metric name
Metric key
Description
DISK_PARTITION_IOPS_READ
mongo.atlas.DISK_PARTITION_IOPS_READ
Throughput of I/O read operations for the disk partition used for MongoDB.
DISK_PARTITION_IOPS_WRITE
mongo.atlas.DISK_PARTITION_IOPS_WRITE
Throughput of I/O write operations for the disk partition used for MongoDB.
DISK_PARTITION_IOPS_TOTAL
mongo.atlas.DISK_PARTITION_IOPS_TOTAL
Throughput of total I/O operations for the disk partition used for MongoDB.
MAX_DISK_PARTITION_IOPS_READ
mongo.atlas.MAX_DISK_PARTITION_IOPS_READ
MAX Throughput of I/O read operations for the disk partition used for MongoDB.
MAX_DISK_PARTITION_IOPS_WRITE
mongo.atlas.MAX_DISK_PARTITION_IOPS_WRITE
MAX Throughput of I/O write operations for the disk partition used for MongoDB.
MAX_DISK_PARTITION_IOPS_TOTAL
mongo.atlas.MAX_DISK_PARTITION_IOPS_TOTAL
MAX Throughput of total I/O operations for the disk partition used for MongoDB.
system-cpu
Metric name
Metric key
Description
SYSTEM_NORMALIZED_CPU_GUEST
mongo.atlas.SYSTEM_NORMALIZED_CPU_GUEST
Guest CPU usage of processes on the host scaled to a range of 0 to 100% by dividing by the number of CPU cores.
SYSTEM_NORMALIZED_CPU_KERNEL
mongo.atlas.SYSTEM_NORMALIZED_CPU_KERNEL
Kernel CPU usage of processes on the host scaled to a range of 0 to 100% by dividing by the number of CPU cores.
SYSTEM_NORMALIZED_CPU_NICE
mongo.atlas.SYSTEM_NORMALIZED_CPU_NICE
CPU usage of processes with a positive nice value, scaled to a range of 0 to 100% by dividing by the number of CPU cores.
SYSTEM_NORMALIZED_CPU_IOWAIT
mongo.atlas.SYSTEM_NORMALIZED_CPU_IOWAIT
CPU usage of processes spent waiting for IO operations to complete, scaled to a range of 0 to 100% by dividing by the number of CPU cores.
SYSTEM_NORMALIZED_CPU_IRQ
mongo.atlas.SYSTEM_NORMALIZED_CPU_IRQ
CPU usage of harware interrupts, scaled to a range of 0 to 100% by dividing by the number of CPU cores.
SYSTEM_NORMALIZED_CPU_SOFTIRQ
mongo.atlas.SYSTEM_NORMALIZED_CPU_SOFTIRQ
CPU usage of software interrupts, scaled to a range of 0 to 100% by dividing by the number of CPU cores.
SYSTEM_NORMALIZED_CPU_STEAL
mongo.atlas.SYSTEM_NORMALIZED_CPU_STEAL
The percentage of time the CPU had something runnable, but the hypervisor chose to run something else, scaled to a range of 0 to 100% by dividing by the number of CPU cores.
SYSTEM_NORMALIZED_CPU_USER
mongo.atlas.SYSTEM_NORMALIZED_CPU_USER
User CPU usage of processes on the host scaled to a range of 0 to 100% by dividing by the number of CPU cores
MAX_SYSTEM_NORMALIZED_CPU_GUEST
mongo.atlas.MAX_SYSTEM_NORMALIZED_CPU_GUEST
MAX Guest CPU usage of processes on the host scaled to a range of 0 to 100% by dividing by the number of CPU cores.
MAX_SYSTEM_NORMALIZED_CPU_KERNEL
mongo.atlas.MAX_SYSTEM_NORMALIZED_CPU_KERNEL
MAX Kernel CPU usage of processes on the host scaled to a range of 0 to 100% by dividing by the number of CPU cores.
MAX_SYSTEM_NORMALIZED_CPU_NICE
mongo.atlas.MAX_SYSTEM_NORMALIZED_CPU_NICE
MAX CPU usage of processes with a positive nice value, scaled to a range of 0 to 100% by dividing by the number of CPU cores.
MAX_SYSTEM_NORMALIZED_CPU_IOWAIT
mongo.atlas.MAX_SYSTEM_NORMALIZED_CPU_IOWAIT
MAX CPU usage of processes spent waiting for IO operations to complete, scaled to a range of 0 to 100% by dividing by the number of CPU cores.
MAX_SYSTEM_NORMALIZED_CPU_IRQ
mongo.atlas.MAX_SYSTEM_NORMALIZED_CPU_IRQ
MAX CPU usage of harware interrupts, scaled to a range of 0 to 100% by dividing by the number of CPU cores.
MAX_SYSTEM_NORMALIZED_CPU_SOFTIRQ
mongo.atlas.MAX_SYSTEM_NORMALIZED_CPU_SOFTIRQ
MAX CPU usage of software interrupts, scaled to a range of 0 to 100% by dividing by the number of CPU cores.
MAX_SYSTEM_NORMALIZED_CPU_STEAL
mongo.atlas.MAX_SYSTEM_NORMALIZED_CPU_STEAL
MAX The percentage of time the CPU had something runnable, but the hypervisor chose to run something else, scaled to a range of 0 to 100% by dividing by the number of CPU cores.
MAX_SYSTEM_NORMALIZED_CPU_USER
mongo.atlas.MAX_SYSTEM_NORMALIZED_CPU_USER
MAX User CPU usage of processes on the host scaled to a range of 0 to 100% by dividing by the number of CPU cores
disk-space
Metric name
Metric key
Description
DISK_PARTITION_SPACE_PERCENT_USED
mongo.atlas.DISK_PARTITION_SPACE_PERCENT_USED
The percentage of disk used on the disk partition used by MongoDB.
DISK_PARTITION_SPACE_PERCENT_FREE
mongo.atlas.DISK_PARTITION_SPACE_PERCENT_FREE
The percentage of disk free on the disk partition used by MongoDB.
DISK_PARTITION_SPACE_USED
mongo.atlas.DISK_PARTITION_SPACE_USED
Amount of disk space used in Bytes, on the disk partition used by MongoDB.
DISK_PARTITION_SPACE_FREE
mongo.atlas.DISK_PARTITION_SPACE_FREE
Amount of disk space free in Bytes, on the disk partition used by MongoDB.
MAX_DISK_PARTITION_SPACE_PERCENT_USED
mongo.atlas.MAX_DISK_PARTITION_SPACE_PERCENT_USED
MAX The percentage of disk used on the disk partition used by MongoDB.
MAX_DISK_PARTITION_SPACE_PERCENT_FREE
mongo.atlas.MAX_DISK_PARTITION_SPACE_PERCENT_FREE
MAX The percentage of disk free on the disk partition used by MongoDB.
MAX_DISK_PARTITION_SPACE_USED
mongo.atlas.MAX_DISK_PARTITION_SPACE_USED
MAX Amount of disk space used in Bytes, on the disk partition used by MongoDB.
MAX_DISK_PARTITION_SPACE_FREE
mongo.atlas.MAX_DISK_PARTITION_SPACE_FREE
MAX Amount of disk space free in Bytes, on the disk partition used by MongoDB.
process-memory
Metric name
Metric key
Description
COMPUTED_MEMORY
mongo.atlas.COMPUTED_MEMORY
Amount of COMPUTED process memory, in mebibytes (MiB)
MEMORY_RESIDENT
mongo.atlas.MEMORY_RESIDENT
Amount of RESIDENT process memory, in mebibytes (MiB)
MEMORY_VIRTUAL
mongo.atlas.MEMORY_VIRTUAL
Amount of VIRTUAL process memory, in mebibytes (MiB)
MEMORY_MAPPED
mongo.atlas.MEMORY_MAPPED
Amount of MAPPED process memory, in mebibytes (MiB)
DB_DATA_SIZE_TOTAL
mongo.atlas.DB_DATA_SIZE_TOTAL
Total On-disk data size - dbstats
DB_STORAGE_TOTAL
mongo.atlas.DB_STORAGE_TOTAL
Total On-disk storage size - dbstats
SWAP_USAGE_FREE
mongo.atlas.SWAP_USAGE_FREE
Total amount of swap space free.
SWAP_USAGE_USED
mongo.atlas.SWAP_USAGE_USED
Total amount of swap space in use.
MAX_SWAP_USAGE_FREE
mongo.atlas.MAX_SWAP_USAGE_FREE
MAX amount of swap space free.
MAX_SWAP_USAGE_USED
mongo.atlas.MAX_SWAP_USAGE_USED
MAX amount of swap space in use.
full-text-search
Metric name
Metric key
Description
FTS_DISK_UTILIZATION
mongo.atlas.FTS_DISK_UTILIZATION
Total bytes of disk space that search processes use.
FTS_MEMORY_MAPPED
mongo.atlas.FTS_MEMORY_MAPPED
Total bytes of mapped memory that search processes occupy.
FTS_MEMORY_RESIDENT
mongo.atlas.FTS_MEMORY_RESIDENT
Total bytes of resident memory that search processes occupy.
FTS_MEMORY_VIRTUAL
mongo.atlas.FTS_MEMORY_VIRTUAL
Total bytes of virtual memory that search processes occupy.
FTS_PROCESS_NORMALIZED_CPU_KERNEL
mongo.atlas.FTS_PROCESS_NORMALIZED_CPU_KERNEL
Percentage of time that the CPU spent servicing operating system calls for the search process.
FTS_PROCESS_NORMALIZED_CPU_USER
mongo.atlas.FTS_PROCESS_NORMALIZED_CPU_USER
Percentage of time that the CPU spent servicing user calls for the search process.
process-query
Metric name
Metric key
Description
QUERY_EXECUTOR_SCANNED
mongo.atlas.QUERY_EXECUTOR_SCANNED
Average rate per second to scan index items during queries and query-plan evaluations.
QUERY_EXECUTOR_SCANNED_OBJECTS
mongo.atlas.QUERY_EXECUTOR_SCANNED_OBJECTS
Average rate of documents scanned per second during queries and query-plan evaluations.
