2016-04-14 02:09:08 +00:00
# Telegraf plugin: MongoDB
2016-04-14 02:02:10 +00:00
#### Configuration
```toml
2016-04-14 02:09:08 +00:00
[[inputs.mongodb]]
servers = ["127.0.0.1:27017"]
```
For authenticated mongodb istances use connection mongdb connection URI
```toml
[[inputs.mongodb]]
servers = ["mongodb://myuser:mypassword@myinstance.telegraf.com:27601/mydatabasename?authMechanism=PLAIN& authSource=$external"]
```
This connection uri may be different based on your environement and mongodb setup. If the user doesn't have the required priviliges to execute serverStatus command the you will get this error on telegraf
```toml
Error in input [mongodb]: not authorized on admin to execute command { serverStatus: 1, recordStats: 0 }
2016-04-14 02:02:10 +00:00
```
#### Description
2016-04-14 02:13:56 +00:00
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
