Couchbase Cluster Member Status Test

In a Couchbase cluster, each node (member) has a status: healthy (fully functional), inactiveFailed (node failed or unreachable), or inactiveAdded (recently added, not yet active). Status reflects node availability and participation in data and service distribution, helping maintain performance, redundancy, and consistency in the distributed database system.

This test monitors the status of each node in the target Couchbase cluster and also reports whether/not the node is available and node member interconnects details in Couchbase Cluster. Using this test, administrators can proactively figure out error-prone nodes, nodes that are unreachable and nodes that are removed/missing and take corrective actions for those nodes to be available.

Target of the test : Couchbase Cluster

Agent deploying the test : An external agent

Outputs of the test : One set of results for each node in the target Couchbase Cluster

Configurable parameters for the test
Parameter	Description
Test Period	How often should the test be executed.
Host	The IP address of the Couchbase database server.
Port	The port on which the server is listening.
Username,	To monitor a Couchbase server, a special database user account with Admin privilege must be created in every Couchbase server instance that requires monitoring. In the Username text box, specify the Username for monitoring the target Couchbase server instance.
Password	Specify the password for the username in Password textbox.
Confirm Password	Confirm the password by typing it in Confirm Password textbox.
Available nodes	In the Available Nodes text box, provide a comma-separated list of all the available nodes to be included for monitoring. This way, the test monitor and collect metrics from all the available nodes in the cluster. By default, this parameter is set to none. The format of this configuration is: HOSTNAME:PORT, for example, 172.16.14.147:8091,172.16.15.67:8091

Measurements made by the test

Measurement

Description

Measurement Unit

Interpretation

Member availability status

Indicates the availability of the current node in the cluster.

The values reported by this measure and its numeric equivalents are mentioned in the table below:

Measure Value	Numeric Value
Healthy	4
Warmup	3
Active Failed	2
Inactive Failed	1
Unhealthy	0

Note:

By default, this measure reports the Measure Values listed in the table above to indicate the current status of the node. The graph of this measure however, represents the status of the switch using the numeric equivalents only 0 to 4.

Below is the interpretation of the measure values:

Healthy: It indicates the node is healthy and operational.

Warmup: The node is currently warming up. The node is starting up or recovering from a previous failure.

Active Failed: The node is still operational but has encountered some issues that need attention.

Inactive Failed: The node has failed and is not currently participating in the Couchbase Cluster.

Unhealthy: Node is unhealthy and is not operational.

Member interconnects status

Indicates the current status of interconnect between current node and other nodes.

The values reported by this measure and its numeric equivalents are mentioned in the table below:

Measure Value	Numeric Value
Active	5
Inactive Added	4
Active Failed	3
Inactive Failed	2
Unknown	1
Missing	0

Note:

Below is the interpretation of the measure values:

Active: The node is an active and healthy member of the cluster.

Inactive Added: The node has been added to the cluster, but it is not fully integrated or participating in cluster operations.

Active Failed: The node is still operational but has some issues.

Inactive Failed: The node has previously part of the cluster but has failed and is currently inactive. It needs attention or recovery.

Unknown: The unknown membership status is due to various reasons, such as communication issues or failures in determining the node's membership status.

Missing: It is missing node, that not a part of the Couchbase Cluster.

Member current connections

Indicates the number of current connections from current node to other nodes.

Number

It represents the current number of active connections to the Couchbase database. How many clients or applications are currently connected to the KV service.

Total number of nodes

Indicates the total number of nodes in the Couchbase cluster.

Number

Available nodes

Indicates the total number of available nodes in the Couchbase Cluster.

Number

It is the count of available nodes. This measure is reported only for the summary descriptor.

Unavailable nodes

Indicates the total number of unavailable nodes in the Couchbase Cluster.

Number

It is the count of unavailable nodes. This measure is reported only for the summary descriptor.

Active nodes

Indicates the total number of active nodes in the Couchbase Cluster.

Number

This measure shows the active state nodes, and it is operational. This measure is reported only for summary descriptor.

Inactive failed nodes

Indicates the total number of inactive failed nodes in the Couchbase Cluster.

Number

This measure shows the inactive failed nodes, and the nodes were previously part of cluster and now it is inactive. It is reported only for summary descriptor.

Inactive added nodes

Indicates the total number of inactive added nodes in the Couchbase Cluster.

Number

The node has been added to the cluster but is not fully integrated or participating in Cluster operation. This measure reported only for summary descriptor.

Active failed nodes

Indicates the total number of active failed nodes in the Couchbase Cluster.

Number

The node is still operational but has some issues. This measure reported only for summary descriptor.

Unknown nodes

Indicates the number of unknown nodes in the Couchbase Cluster.

Number

This measure only reported to summary descriptor.

Missing nodes

Indicates the number of missing nodes in the Couchbase Cluster.

Number

This node is not part of the Couchbase Cluster. This measure only reported to summary descriptor.