Troubleshoot YugabyteDB

Typically, troubleshooting involves a number of steps that are rather consistent regardless of the particular situation. These steps include the following:

  1. Verify that YugabyteDB is running: you need to ensure that the expected YugabyteDB processes are running on the current node. At a minimum, the YB-TServer process must be running to be able to connect to the node with a client or application.

    Additionally, depending on the setup, you might expect a YB-Master process to run on this node.

    For more information, see Check servers.

  2. Check cluster-level issues and their solutions.

  3. Check logs: you should inspect the YugabyteDB logs for additional details on your issue. For more information, see Inspect logs.

  4. Explore knowledge base articles: you can find additional troubleshooting resources and information on Yugabyte Support page.

  5. File an issue: if you can't find a solution to your problem, file a GitHub issue describing your specific problem.

Cluster-level issues and performance
Troubleshoot common YugabyteDB cluster issues and improve cluster performance.
Node-level issues
Diagnose and solve issues on an individual YugabyteDB node.
YSQL issues
Solve issues related to YSQL.
Other issues
Understand how to address other issues related to YugabyteDB.