MongoDB

MongoDB logo

MongoDB

Author: Outlyer | Version: 1.0.0 | License: MIT | Categories:

MongoDB is a free and open source cross-platform document-oriented NoSQL database.

This integration will monitor your MongoDB cluster by collecting metrics from MongoDB dbStats and serverStatus commands.

Once enabled you will get a default MongoDB dashboard to help you get started monitoring your key MongoDB metrics.

Metric Name Type Labels Unit Description
mongodb.collections Gauge database   Number of collections in the database.
mongodb.objects Gauge database   number of objects (i.e. documents) in the database across all collections.
mongodb.avg_obj_size Gauge database byte Average size of each document in bytes. This is the dataSize divided by the number of documents.
mongodb.data_size Gauge database byte Total size of the uncompressed data held in this database. The dataSize decreases when you remove documents.
mongodb.storage_size Gauge database byte Total amount of space allocated to collections in this database for document storage.
mongodb.indexes Gauge database   Total number of indexes across all collections in the database.
mongodb.index_size Gauge database byte Total size of all indexes created on this database.
mongodb.fs_used_size Gauge database byte Total size of all disk space in use on the filesystem where MongoDB stores data.
mongodb.fs_total_size Gauge database byte Total size of all disk capacity on the filesystem where MongoDB stores data.
mongodb.network.bytes_in Counter   byte/second Rate of bytes that reflects the amount of network traffic received.
mongodb.network.bytes_out Counter   byte/second Rate of bytes that reflects the amount of network traffic sent.
mongodb.network.num_requests Counter   request/second Rate of of distinct requests that the server has received.
mongodb.opcounters.delete Counter   operation/second Rate of delete operations since the mongod instance last started.
mongodb.opcounters.getmore Counter   operation/second Rate of “getmore” operations since the mongod instance last started.
mongodb.opcounters.insert Counter   operation/second Rate of insert operations received since the mongod instance last started.
mongodb.opcounters.query Counter   operation/second Rate of queries received since the mongod instance last started.
mongodb.opcounters.update Counter   operation/second Rate of update operations received since the mongod instance last started.
mongodb.connections.available Gauge     Number of unused incoming connections available.
mongodb.connections.current Gauge     Number of incoming connections from clients to the database server.
mongodb.uptime Gauge   second Number of seconds that the current MongoDB process has been active.

Just run the MongoDB plugin against your MongoDB instances and it will start collecting metrics.

Plugin Environment Variables

The MongoDB plugin can be customized via environment variables.

Variable Default Description
ip 127.0.0.1 MongoDB host.
port 27017 MongoDB port.
username   MongoDB username when MongoDB Auth is enabled.
password   MongoDB password when MongoDB Auth is enabled.
auth_source   The name of the database that has the collection with the user credentials.
connect_timeout 5000 The number of milliseconds to wait before timing out a connection attempt.
socket_timeout 5000 The maximum number of milliseconds to wait for responses from the server.
Version Release Date Description
1.0 21-Jun-2018 Initial version of our MongoDB monitoring integration.