CouchDB Documentation IO Test

Documents are CouchDB's central data structure. Contents of the database will be stored in the form of Documents instead of tables. You can create these documents using URL utility provided by CouchDB. This test monitors writes and insert operations performed on document. In the process, the test proactively alerts administrators to potential contentions in writes and insert operations.

Target of the test : Apache CouchDB Server

Agent deploying the test : An internal/remote agent

Outputs of the test : One set of results for the target Apache CouchDB Server.

Configurable parameters for the test
Parameter Description

Test period

How often should the test be executed.


The IP address of the target server that is being monitored.


The port number through which the Couchdb server communicates. The default port is 5984.


In order to monitor an Apache CouchDB server, a special database user account with Admin privilege has to be created in every Apache CouchDB server instance that requires monitoring. In the Username text box, specify the Username for monitoring the target Apache CouchDB server instance.To create a new user, refer Pre-requisites for Monitoring Apache CouchDB topic.


Specify the password of the specified Username.

Confirm Password

Confirm the password by retyping it here.

Measurements made by the test
Measurement Description Measurement Unit Interpretation

Document IO write rate

Indicates the rate at which writes operation performed on document.


A high value is desired for this measure. A very low value is a cause for concern, as it indicates that cache usage is very poor.

Document IO insert rate

Indicates that the rate at which insert operation performed on document.