| .. Licensed to the Apache Software Foundation (ASF) under one |
| .. or more contributor license agreements. See the NOTICE file |
| .. distributed with this work for additional information |
| .. regarding copyright ownership. The ASF licenses this file |
| .. to you under the Apache License, Version 2.0 (the |
| .. "License"); you may not use this file except in compliance |
| .. with the License. You may obtain a copy of the License at |
| .. |
| .. http://www.apache.org/licenses/LICENSE-2.0 |
| .. |
| .. Unless required by applicable law or agreed to in writing, software |
| .. distributed under the License is distributed on an "AS IS" BASIS, |
| .. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| .. See the License for the specific language governing permissions and |
| .. limitations under the License. |
| |
| Troubleshooting |
| =============== |
| |
| 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. |
| |
| 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. |
| |
| .. toctree:: |
| :maxdepth: 2 |
| |
| finding_nodes |
| reading_logs |
| use_nodetool |
| use_tools |