Cluster-level issues

Diagnostics and solutions for typical YugabyteDB cluster issues.

This page documents the preview (v2.21) version. Preview includes features under active development and is for development and testing only. For production, use the stable (v2024.1) version.

YCQL API connection problems

Troubleshoot issues related to connecting to the Cassandra-compatible YCQL API service.

Recover YB-TServer, YB-Master, and node

Recover failed nodes to get the cluster back on optimal settings.

Replace a failed YB-TServer

Replace a failed YB-TServer in a YugabyteDB cluster.

Replace a failed YB-Master

Replace a failed YB-Master in a YugabyteDB cluster.

Replace failed peers

Perform manual remote bootstrap of failed peers.

Recover YB-TServer from crash loop

Find faulty tablets and their data on disk, and then remove it.

Troubleshoot performance issues

Investigate and troubleshoot performance of your YugabyteDB clusters.