Monitoring Apache CouchDB

Configure the Server Density agent to monitor your CouchDB instance to:

• Collect important metrics, such as utilisation, response time and reads/writes
• Identify overall server slowdowns caused by the instance

Monitored metrics

  • Couch DB
    • Open OS Files
    • Open Databases
    • Request Time
    • Open OS Files
  • HTTPD Request Methods
    • PUT
    • GET
  • HTTPD Status Codes
    • 200
  • HTTPD _users
    • PUT
    • GET

Installing the CouchDB plugin package

Install the CouchDB plugin on Debian/Ubuntu:

sudo apt-get install sd-agent-couchdb

Install the CouchDB plugin on RHEL/CentOS:

sudo yum install sd-agent-couchdb

Read more about agent plugins.

Configuring the agent to monitor Apache CouchDB

1. Configure /etc/sd-agent/conf.d/couch.yaml


- server: http://localhost:5984
  • If your DB requires additional authentication, you wish to specify a timeout or fine tune other details, amend the config file as necessary. 

2. Restart the agent

sudo /etc/init.d/sd-agent restart

Verifying the configuration
Execute info to verify the configuration with the following:

sudo /etc/init.d/sd-agent info 

If the agent has been configured correctly you’ll see an output such as:

  - instance #0 [OK]
  - Collected 0 metrics & 0 events

You can also view the metrics returned with the following command:

sudo -u sd-agent /usr/share/python/sd-agent/ check couch

Configuring graphs

Click the name of your server from the Devices list in your Server Density account then go to the Metrics tab. Click the + Graph button on the right then choose the CouchDB metrics to display the graphs. The metrics will also be available to select when building dashboard graphs.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request


Monday  —  Friday.

10am  —  6pm UK.

Dedicated Support.