Skip to main content
If you experience an issue when using CockroachDB, try these steps to resolve the problem:
  • Check your for errors. Logs are generated on a per-node basis, so you must either identify the node where the issue occurred or .
    • Consult the list of .
    • If you are getting transaction retry errors, see and the .
  • If the problem doesn’t match a common error, try the following pages:
    • helps you start and scale your cluster.
    • helps you handle errors and troubleshooting problems that may arise during application development.
    • helps you with unexpected query results.
  • If you are using Cockroach Cloud, see the errors and solutions in .
  • If you see discrepancies in metrics, refer to .
  • The lets you query the status of your cluster’s data replication, data placement, and zone constraint conformance.
  • If you believe are not behaving as specified by your zone configurations, whether in terms of data placement or zone constraint conformance, see Troubleshoot Replication Zones.
  • If you cannot resolve the issue yourself, the following tools can help you move forward:
    • identify ways you can get help with troubleshooting.
  • In a support escalation, you may be directed to use the following features by the :