> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cockroachlabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting Overview

If you experience an issue when using CockroachDB, try these steps to resolve the problem:

* Check your [logs](https://docs.cockroachlabs.com/docs/v24.2/logging-overview) for errors. Logs are generated on a per-node basis, so you must either identify the node where the issue occurred or [collect the logs from all active nodes in your cluster](https://docs.cockroachlabs.com/docs/v24.2/cockroach-debug-zip).
  * Consult the list of [common errors and solutions](https://docs.cockroachlabs.com/docs/v24.2/common-errors).
  * If you are getting transaction retry errors, see [client-side retry handling](https://docs.cockroachlabs.com/docs/v24.2/transaction-retry-error-reference#client-side-retry-handling) and the [Transaction Retry Error Reference](https://docs.cockroachlabs.com/docs/v24.2/transaction-retry-error-reference#transaction-retry-error-reference).

* If the problem doesn't match a common error, try the following pages:
  * [Troubleshoot Cluster Setup](https://docs.cockroachlabs.com/docs/v24.2/cluster-setup-troubleshooting) helps you start and scale your cluster.
  * [Troubleshoot Common Problems](https://docs.cockroachlabs.com/docs/v24.2/query-behavior-troubleshooting) helps you handle errors and troubleshooting problems that may arise during application development.
  * [Troubleshoot Statement Behavior](https://docs.cockroachlabs.com/docs/v24.2/query-behavior-troubleshooting) helps you with unexpected query results.

* If you are using Cockroach Cloud, see the errors and solutions in [Troubleshoot CockroachDB Cloud](https://docs.cockroachlabs.com/docs/cockroachcloud/troubleshooting-page.md).

* If you see discrepancies in metrics, refer to [Differences in Metrics between Third-Party Monitoring Integrations and DB Console](https://docs.cockroachlabs.com/docs/v24.2/differences-in-metrics-between-third-party-monitoring-integrations-and-db-console).

* The [critical nodes endpoint](https://docs.cockroachlabs.com/docs/v24.2/monitoring-and-alerting#critical-nodes-endpoint) lets you query the status of your cluster's data replication, data placement, and zone constraint conformance.

* If you believe [replicas](https://docs.cockroachlabs.com/docs/v24.2/architecture/overview#architecture-replica) are not behaving as specified by your zone configurations, whether in terms of data placement or zone constraint conformance, see [Troubleshoot Replication Zones](https://docs.cockroachlabs.com/docs/v24.2/troubleshoot-replication-zones).

* If you cannot resolve the issue yourself, the following tools can help you move forward:
  * [Support Resources](https://docs.cockroachlabs.com/docs/v24.2/support-resources) identify ways you can get help with troubleshooting.

* In a support escalation, you may be directed to use the following features by the [Cockroach Labs support team](https://docs.cockroachlabs.com/docs/v24.2/support-resources):

  * [`cockroach debug zip`](https://docs.cockroachlabs.com/docs/v24.2/cockroach-debug-zip)
  * [`cockroach debug tsdump`](https://docs.cockroachlabs.com/docs/v24.2/cockroach-debug-tsdump)
  * [Automatic CPU Profiler](https://docs.cockroachlabs.com/docs/v24.2/automatic-cpu-profiler)