> ## 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/stable/logging-overview.md) 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/stable/cockroach-debug-zip.md).
  * Consult the list of [common errors and solutions](https://docs.cockroachlabs.com/docs/stable/common-errors.md).
  * If you are getting transaction retry errors, see [client-side retry handling](https://docs.cockroachlabs.com/docs/stable/transaction-retry-error-reference.md#client-side-retry-handling) and the [Transaction Retry Error Reference](https://docs.cockroachlabs.com/docs/stable/transaction-retry-error-reference.md#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/stable/cluster-setup-troubleshooting.md) helps you start and scale your cluster.
  * [Troubleshoot Common Problems](https://docs.cockroachlabs.com/docs/stable/query-behavior-troubleshooting.md) helps you handle errors and troubleshooting problems that may arise during application development.
  * [Troubleshoot Statement Behavior](https://docs.cockroachlabs.com/docs/stable/query-behavior-troubleshooting.md) 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/stable/differences-in-metrics-between-third-party-monitoring-integrations-and-db-console.md).
* The [critical nodes endpoint](https://docs.cockroachlabs.com/docs/stable/monitoring-and-alerting.md#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/stable/architecture/overview.md#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/stable/troubleshoot-replication-zones.md).
* If you cannot resolve the issue yourself, the following tools can help you move forward:
  * [Support Resources](https://docs.cockroachlabs.com/docs/stable/support-resources.md) 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/stable/support-resources.md):
  * [`cockroach debug zip`](https://docs.cockroachlabs.com/docs/stable/cockroach-debug-zip)
  * [`cockroach debug tsdump`](https://docs.cockroachlabs.com/docs/stable/cockroach-debug-tsdump)
  * [Automatic CPU Profiler](https://docs.cockroachlabs.com/docs/stable/automatic-cpu-profiler.md)
