---
layout: docpage

title: "Documentation"

is_homepage: false
is_sphinx_doc: true

doc-title: "Troubleshooting"
doc-header-links: '
  <link rel="top" title="Apache Cassandra Documentation v4.0-beta4" href="../index.html"/>
      <link rel="next" title="Find The Misbehaving Nodes" href="finding_nodes.html"/>
      <link rel="prev" title="Cassandra Stress" href="../tools/cassandra_stress.html"/>
'
doc-search-path: "../search.html"

extra-footer: '
<script type="text/javascript">
    var DOCUMENTATION_OPTIONS = {
      URL_ROOT:    "",
      VERSION:     "",
      COLLAPSE_INDEX: false,
      FILE_SUFFIX: ".html",
      HAS_SOURCE:  false,
      SOURCELINK_SUFFIX: ".txt"
    };
</script>
'

---
<div class="container-fluid">
  <div class="row">
    <div class="col-md-3">
      <div class="doc-navigation">
        <div class="doc-menu" role="navigation">
          <div class="navbar-header">
            <button type="button" class="pull-left navbar-toggle" data-toggle="collapse" data-target=".sidebar-navbar-collapse">
              <span class="sr-only">Toggle navigation</span>
              <span class="icon-bar"></span>
              <span class="icon-bar"></span>
              <span class="icon-bar"></span>
            </button>
          </div>
          <div class="navbar-collapse collapse sidebar-navbar-collapse">
            <form id="doc-search-form" class="navbar-form" action="../search.html" method="get" role="search">
              <div class="form-group">
                <input type="text" size="30" class="form-control input-sm" name="q" placeholder="Search docs">
                <input type="hidden" name="check_keywords" value="yes" />
                <input type="hidden" name="area" value="default" />
              </div>
            </form>
            
            
            <ul class="current">
<li class="toctree-l1"><a class="reference internal" href="../getting_started/index.html">Getting Started</a></li>
<li class="toctree-l1"><a class="reference internal" href="../new/index.html">New Features in Apache Cassandra 4.0</a></li>
<li class="toctree-l1"><a class="reference internal" href="../architecture/index.html">Architecture</a></li>
<li class="toctree-l1"><a class="reference internal" href="../cql/index.html">The Cassandra Query Language (CQL)</a></li>
<li class="toctree-l1"><a class="reference internal" href="../data_modeling/index.html">Data Modeling</a></li>
<li class="toctree-l1"><a class="reference internal" href="../configuration/index.html">Configuring Cassandra</a></li>
<li class="toctree-l1"><a class="reference internal" href="../operating/index.html">Operating Cassandra</a></li>
<li class="toctree-l1"><a class="reference internal" href="../tools/index.html">Cassandra Tools</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">Troubleshooting</a><ul>
<li class="toctree-l2"><a class="reference internal" href="finding_nodes.html">Find The Misbehaving Nodes</a></li>
<li class="toctree-l2"><a class="reference internal" href="reading_logs.html">Cassandra Logs</a></li>
<li class="toctree-l2"><a class="reference internal" href="use_nodetool.html">Use Nodetool</a></li>
<li class="toctree-l2"><a class="reference internal" href="use_tools.html">Diving Deep, Use External Tools</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../development/index.html">Contributing to Cassandra</a></li>
<li class="toctree-l1"><a class="reference internal" href="../faq/index.html">Frequently Asked Questions</a></li>
<li class="toctree-l1"><a class="reference internal" href="../plugins/index.html">Third-Party Plugins</a></li>
<li class="toctree-l1"><a class="reference internal" href="../bugs.html">Reporting Bugs</a></li>
<li class="toctree-l1"><a class="reference internal" href="../contactus.html">Contact us</a></li>
</ul>

            
          </div><!--/.nav-collapse -->
        </div>
      </div>
    </div>
    <div class="col-md-8">
      <div class="content doc-content">
        <div class="content-container">
          
  <div class="section" id="troubleshooting">
<h1>Troubleshooting<a class="headerlink" href="#troubleshooting" title="Permalink to this headline">¶</a></h1>
<p>As any distributed database does, sometimes Cassandra breaks and you will have
to troubleshoot what is going on. Generally speaking you can debug Cassandra
like any other distributed Java program, meaning that you have to find which
machines in your cluster are misbehaving and then isolate the problem using
logs and tools. Luckily Cassandra had a great set of instrospection tools to
help you.</p>
<p>These pages include a number of command examples demonstrating various
debugging and analysis techniques, mostly for Linux/Unix systems. If you don’t
have access to the machines running Cassandra, or are running on Windows or
another operating system you may not be able to use the exact commands but
there are likely equivalent tools you can use.</p>
<div class="toctree-wrapper compound">
<ul>
<li class="toctree-l1"><a class="reference internal" href="finding_nodes.html">Find The Misbehaving Nodes</a><ul>
<li class="toctree-l2"><a class="reference internal" href="finding_nodes.html#client-logs-and-errors">Client Logs and Errors</a></li>
<li class="toctree-l2"><a class="reference internal" href="finding_nodes.html#metrics">Metrics</a></li>
<li class="toctree-l2"><a class="reference internal" href="finding_nodes.html#next-step-investigate-the-node-s">Next Step: Investigate the Node(s)</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="reading_logs.html">Cassandra Logs</a><ul>
<li class="toctree-l2"><a class="reference internal" href="reading_logs.html#common-log-files">Common Log Files</a></li>
<li class="toctree-l2"><a class="reference internal" href="reading_logs.html#getting-more-information">Getting More Information</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="use_nodetool.html">Use Nodetool</a><ul>
<li class="toctree-l2"><a class="reference internal" href="use_nodetool.html#cluster-status">Cluster Status</a></li>
<li class="toctree-l2"><a class="reference internal" href="use_nodetool.html#coordinator-query-latency">Coordinator Query Latency</a></li>
<li class="toctree-l2"><a class="reference internal" href="use_nodetool.html#local-query-latency">Local Query Latency</a></li>
<li class="toctree-l2"><a class="reference internal" href="use_nodetool.html#threadpool-state">Threadpool State</a></li>
<li class="toctree-l2"><a class="reference internal" href="use_nodetool.html#compaction-state">Compaction State</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="use_tools.html">Diving Deep, Use External Tools</a><ul>
<li class="toctree-l2"><a class="reference internal" href="use_tools.html#jvm-tooling">JVM Tooling</a></li>
<li class="toctree-l2"><a class="reference internal" href="use_tools.html#basic-os-tooling">Basic OS Tooling</a></li>
<li class="toctree-l2"><a class="reference internal" href="use_tools.html#advanced-tools">Advanced tools</a></li>
</ul>
</li>
</ul>
</div>
</div>


          <div class="doc-prev-next-links" role="navigation" aria-label="footer navigation">
            
            <a href="finding_nodes.html" class="btn btn-default pull-right " role="button" title="Find The Misbehaving Nodes" accesskey="n">Next <span class="glyphicon glyphicon-circle-arrow-right" aria-hidden="true"></span></a>
            
            
            <a href="../tools/cassandra_stress.html" class="btn btn-default" role="button" title="Cassandra Stress" accesskey="p"><span class="glyphicon glyphicon-circle-arrow-left" aria-hidden="true"></span> Previous</a>
            
          </div>
          
        </div>
      </div>
    </div>
  </div>
</div>