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

# Troubleshooting Overview

export const InternalLink = ({version, path = "", children, ...props}) => {
  let detectedVersion = version || "stable";
  if (typeof window !== 'undefined' && !version) {
    const match = window.location.pathname.match(/\/docs\/([^/]+)/);
    if (match) {
      detectedVersion = match[1];
    }
  }
  const normalizedPath = path.startsWith("/") ? path.slice(1) : path;
  return <a href={`/docs/${detectedVersion}/${normalizedPath}`} {...props}>
      {children}
    </a>;
};

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

* Check your <InternalLink path="logging-overview">logs</InternalLink> for errors. Logs are generated on a per-node basis, so you must either identify the node where the issue occurred or <InternalLink path="cockroach-debug-zip">collect the logs from all active nodes in your cluster</InternalLink>.
  * Consult the list of <InternalLink path="common-errors">common errors and solutions</InternalLink>.
  * If you are getting transaction retry errors, see <InternalLink path="transaction-retry-error-reference#client-side-retry-handling">client-side retry handling</InternalLink> and the <InternalLink path="transaction-retry-error-reference#transaction-retry-error-reference">Transaction Retry Error Reference</InternalLink>.

* If the problem doesn't match a common error, try the following pages:
  * <InternalLink path="cluster-setup-troubleshooting">Troubleshoot Cluster Setup</InternalLink> helps you start and scale your cluster.
  * <InternalLink path="query-behavior-troubleshooting">Troubleshoot Common Problems</InternalLink> helps you handle errors and troubleshooting problems that may arise during application development.
  * <InternalLink path="query-behavior-troubleshooting">Troubleshoot Statement Behavior</InternalLink> helps you with unexpected query results.

* If you are using Cockroach Cloud, see the errors and solutions in <InternalLink version="cockroachcloud" path="troubleshooting-page">Troubleshoot CockroachDB Cloud</InternalLink>.

* If you see discrepancies in metrics, refer to <InternalLink path="differences-in-metrics-between-third-party-monitoring-integrations-and-db-console">Differences in Metrics between Third-Party Monitoring Integrations and DB Console</InternalLink>.

* The <InternalLink path="monitoring-and-alerting#critical-nodes-endpoint">critical nodes endpoint</InternalLink> lets you query the status of your cluster's data replication, data placement, and zone constraint conformance.

* If you believe <InternalLink path="architecture/overview">replicas</InternalLink> are not behaving as specified by your zone configurations, whether in terms of data placement or zone constraint conformance, see [Troubleshoot Replication Zones](/docs/v26.3/troubleshoot-replication-zones).

* If you cannot resolve the issue yourself, the following tools can help you move forward:
  * <InternalLink path="support-resources">Support Resources</InternalLink> identify ways you can get help with troubleshooting.

* In a support escalation, you may be directed to use the following features by the <InternalLink path="support-resources">Cockroach Labs support team</InternalLink>:

  * <InternalLink path="cockroach-debug-zip">`cockroach debug zip`</InternalLink>
  * <InternalLink path="cockroach-debug-tsdump">`cockroach debug tsdump`</InternalLink>
  * <InternalLink path="automatic-cpu-profiler">Automatic CPU Profiler</InternalLink>
  * <InternalLink path="automatic-go-execution-tracer">Automatic Go Execution Tracer</InternalLink>
  * <InternalLink path="transaction-diagnostics">Transaction Diagnostics</InternalLink>