CouchDB Read Repairs Test

When data object replicas become inconsistent, read repair is a mechanism to make them consistent by overwriting the out-of-date replica with the latest value. This feature is typically found when peer replication is used and is not relevant in master-slave architectures. When data object replicas become inconsistent, read repair is a mechanism to make them consistent by overwriting the out-of-date replica with the latest value. This feature is typically found when peer replication is used.

Using this test, administrators can figure out the count of background read repairs. By analyzing the count of read repairs at regular intervals, administrators can figure out the erratic pattern of read repairs and figure out the exact cause of such erratic behavior.

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.
Host	The IP address of the target server that is being monitored.
Port	The port number through which the Couchdb server communicates. The default port is 5984.
Username	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.
Password	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
Successful read repairs	Indicates the number of successful read repairs.	Number	A very high value is required for this measure.
Failure read repairs	Indicates the number of failure read repairs.	Number	Ideally, the value of this measure should be low.
Total read repairs	Indicates the total number of read repairs.	Number