2016-04-15 15:10:30 +00:00
|
|
|
# Telegraf plugin: MongoDB
|
|
|
|
|
|
|
|
|
|
#### Configuration
|
|
|
|
|
|
|
|
|
|
```toml
|
|
|
|
|
[[inputs.mongodb]]
|
2017-06-08 23:52:01 +00:00
|
|
|
## An array of URLs of the form:
|
|
|
|
|
## "mongodb://" [user ":" pass "@"] host [ ":" port]
|
|
|
|
|
## For example:
|
2016-04-15 15:10:30 +00:00
|
|
|
## mongodb://user:auth_key@10.10.3.30:27017,
|
|
|
|
|
## mongodb://10.10.3.33:18832,
|
2017-06-08 23:52:01 +00:00
|
|
|
servers = ["mongodb://127.0.0.1:27017"]
|
2016-07-19 11:47:12 +00:00
|
|
|
gather_perdb_stats = false
|
2017-03-10 19:27:55 +00:00
|
|
|
|
|
|
|
|
## Optional SSL Config
|
|
|
|
|
# ssl_ca = "/etc/telegraf/ca.pem"
|
|
|
|
|
# ssl_cert = "/etc/telegraf/cert.pem"
|
|
|
|
|
# ssl_key = "/etc/telegraf/key.pem"
|
|
|
|
|
## Use SSL but skip chain & host verification
|
|
|
|
|
# insecure_skip_verify = false
|
2016-04-15 15:10:30 +00:00
|
|
|
```
|
2017-06-08 23:52:01 +00:00
|
|
|
This connection uri may be different based on your environment and mongodb
|
|
|
|
|
setup. If the user doesn't have the required privilege to execute serverStatus
|
2016-04-15 15:10:30 +00:00
|
|
|
command the you will get this error on telegraf
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
Error in input [mongodb]: not authorized on admin to execute command { serverStatus: 1, recordStats: 0 }
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
#### Description
|
|
|
|
|
|
|
|
|
|
The telegraf plugin collects mongodb stats exposed by serverStatus and few more
|
|
|
|
|
and create a single measurement containing values e.g.
|
|
|
|
|
* active_reads
|
|
|
|
|
* active_writes
|
|
|
|
|
* commands_per_sec
|
|
|
|
|
* deletes_per_sec
|
|
|
|
|
* flushes_per_sec
|
|
|
|
|
* getmores_per_sec
|
|
|
|
|
* inserts_per_sec
|
|
|
|
|
* net_in_bytes
|
|
|
|
|
* net_out_bytes
|
|
|
|
|
* open_connections
|
|
|
|
|
* percent_cache_dirty
|
|
|
|
|
* percent_cache_used
|
|
|
|
|
* queries_per_sec
|
|
|
|
|
* queued_reads
|
|
|
|
|
* queued_writes
|
|
|
|
|
* resident_megabytes
|
|
|
|
|
* updates_per_sec
|
|
|
|
|
* vsize_megabytes
|
2018-02-20 21:55:56 +00:00
|
|
|
* total_in_use
|
|
|
|
|
* total_available
|
|
|
|
|
* total_created
|
|
|
|
|
* total_refreshing
|
2016-04-19 18:55:03 +00:00
|
|
|
* ttl_deletes_per_sec
|
|
|
|
|
* ttl_passes_per_sec
|
2016-04-19 23:16:22 +00:00
|
|
|
* repl_lag
|
2016-04-29 16:40:26 +00:00
|
|
|
* jumbo_chunks (only if mongos or mongo config)
|
2016-07-19 11:47:12 +00:00
|
|
|
|
|
|
|
|
If gather_db_stats is set to true, it will also collect per database stats exposed by db.stats()
|
|
|
|
|
creating another measurement called mongodb_db_stats and containing values:
|
|
|
|
|
* collections
|
|
|
|
|
* objects
|
|
|
|
|
* avg_obj_size
|
|
|
|
|
* data_size
|
|
|
|
|
* storage_size
|
|
|
|
|
* num_extents
|
|
|
|
|
* indexes
|
|
|
|
|
* index_size
|
|
|
|
|
* ok
|
