CouchDB Replications Test

To provide high availability, you can install one or more additional CouchDB servers that replicate an existing CouchDB server instance. After a replica installation, the existing and newly installed instances of the target server are identical. When a change is made on one instance, the updated information is copied to the replicated instances simultaneously. If any of the replicated instances fails, the other instances in the group continue to operate such that operations of the target server would be uninterrupted. If the replications fail due to authentication or configuration problems, then, high availability of the target server will be uncertain. To avoid such eventualities, you should continuously monitor the replication processes within the target environment and take necessary actions swiftly if the replication process fails. The CouchDB Replications test helps you in this regard!

This test tracks the replication processes and reports the number of currently running replications and the number of document writes that failed in the target environment as part of replication process.

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.

Detailed Diagnosis

To make diagnosis more efficient and accurate, the eG Enterprise embeds an optional detailed diagnostic capability. With this capability, the eG agents can be configured to run detailed, more elaborate tests as and when specific problems are detected. To enable the detailed diagnosis capability of this test for a particular server, choose the On option. To disable the capability, click on the Off option.

The option to selectively enable/disable the detailed diagnosis capability will be available only if the following conditions are fulfilled:

  • The eG manager license should allow the detailed diagnosis capability
  • Both the normal and abnormal frequencies configured for the detailed diagnosis measures should not be 0.
Measurements made by the test
Measurement Description Measurement Unit Interpretation

Number of replications

Indicates the number of replications currently running on the server.



Document write failures

Indicates the number of document write failures.


A low value is desired for this measure.

Detailed diagnosis of the measure shows the process Id, started time and duration of the replication process.