cockroachdb_unavailable_ranges

cockroachdb_unavailable_ranges

Database | CockroachDB

This alert presents the number of unavailable ranges. If you receive this, it indicates that there are ranges with fewer live replicas than needed for quorum.

This alert is raised in a warning state when unavailable ranges start to exist.

What are unavailable ranges?

Unavailable ranges: If a majority of a range’s replicas are on nodes that are unavailable, then the entire range is unavailable and will be unable to process queries.

CockroachDB uses consensus replication and requires a quorum of the replicas to be available in order to allow both writes and reads to the range.
The number of failures that can be tolerated is equal to (Replication factor - 1)/2.
Thus, CockroachDB requires (n-1)/2 nodes to achieve quorum.
For example, with 3x replication, one failure can be tolerated, with 5x replication, two failures, and so on.1

References and Sources
  1. CockroachDB docs

Troubleshooting Section

Identify unavailable ranges

Check out the CockroachDB documentation for troubleshooting advice.