Troubleshooting Overview

AttentionThis page documents an earlier version. Go to the latest (v2.1)version.

1. Check that YugabyteDB is running

First, ensure that the expected YugabyteDB processes are running on the current node.At a minimum, the tserver process needs to be running to be able to connect to this node with a CQL client or application.

Additionally, depending on the setup, you might expect a master process to also be running on this node.Follow the instructions on the check processes page.

2. Check cluster level issues

Next, check the list of cluster issues and the respective fixes for each of them.

3. Check logs

Inspect the Yugabyte logs for more details on your issue. See this page for more details on where to find and how to understand the Yugabyte log files.

4. File an issue

If you could not find a solution to your problem in these docs, please reach out to us on our forum or file a GitHub issue describing your specific problem.