Learn about the Wavefront MongoDB Integration.

mongoDB Integration

mongoDB is an open source NoSQL, cross-platform document-oriented database. This integration installs and configures Telegraf to send mongoDB metrics into Wavefront. Telegraf is a light-weight server process capable of collecting, processing, aggregating, and sending metrics to a Wavefront proxy.

In addition to setting up the metrics flow, this integration also installs a dashboard. Here’s a screen shot of an example dashboard with statistics collected from mongoDB. images/mongodb-dashboard-1.png

images/mongodb-dashboard-2.png

images/mongodb-dashboard-3.png

images/mongodb-dashboard-4.png

To see a list of the metrics for this integration, select the integration from https://github.com/influxdata/telegraf/tree/master/plugins/inputs.

mongoDB Setup

Note: If you use vRealize Operations, the application proxy agent sets up the integration for you. See the setup instructions. Otherwise, follow the setup steps on this page.

Step 1. Install the Telegraf Agent

This integration uses the monodb input plugin for Telegraf. If you’ve already installed Telegraf on your server(s), you can skip to Step 2.

Log in to your Wavefront instance and follow the instructions in the Setup tab to install Telegraf and a Wavefront proxy in your environment. If a proxy is already running in your environment, you can select that proxy and the Telegraf install command connects with that proxy. Sign up for a free trial to check it out!

Step 2. Configure mongoDB Input Plugin

  1. Create a file called mongodb.conf in /etc/telegraf/telegraf.d and enter the following snippet:

     # Read metrics from one or many mongodb servers
     [[inputs.mongodb]]
       ## An array of URLs of the form:
       ##   "mongodb://" [user ":" pass "@"] host [ ":" port]
       ## For example:
       ##   mongodb://user:auth_key@10.10.3.30:27017,
       ##   mongodb://10.10.3.33:18832,
       servers = ["mongodb://127.0.0.1:27017"]
    
       fielddrop = ["member_status", "state", "type"]
          
       ##Collects metrics exposed by db.stats
       gather_perdb_stats = true 
    
       ## 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
    

Replace the servers value above with the URL of your mongoDB server.

Step 3. Restart Telegraf

Run sudo service telegraf restart to restart your agent.