# Kafka Troubleshooting Guide ## Pre-reads \ ### Pre-requisites * [kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl-linux/) is a CLI to connect to the kubernetes cluster from your machine * [Install Visualstudio](https://code.visualstudio.com/download) IDE Code for better code/configuration editing capabilities * Git ### Status check of Kafka Broker's Using the below command you can able list down the Kafka brokers and their status `kubectl get pods -n kafka-cluster` * If Kafka brokers are in crashloopbackoff or Error status * Describe the brokers and look for error `kubectl describe kafka-v2-0 -n kafka-cluster` `kubectl describe kafka-v2-1 -n kafka-cluster` `kubectl describe kafka-v2-2 -n kafka-cluster` * Check Kafka broker's logs for error `kubectl logs -f kafka-v2-0 -n kafka-cluster` `kubectl logs -f kafka-v2-1 -n kafka-cluster` `kubectl logs -f kafka-v2-2 -n kafka-cluster` * If brokers are in crashloopbackoff due to disk space issues, follow the below document for the cleanup of the logs * [Cleanup of Kafka logs](https://core.digit.org/guides/operations-guide/cleanup-kafka-logs) ### Status check of Zookeeper Ensure Zookeeper pods are running without any errors in order to run Kafka brokers without a hitch * If Zookeeper pods are in crashloopbackoff or Error status, Use the below commands to check the error * Describe the Zookeeper and look for error `kubectl describe zookeeper-v2-0 -n zookeeper-cluster` `kubectl describe zookeeper-v2-1 -n zookeeper-cluster` `kubectl describe zookeeper-v2-2 -n zookeeper-cluster` * Check Kafka broker's logs for error `kubectl logs -f zookeeper-v2-0 -n zookeeper-cluster` `kubectl logs -f zookeeper-v2-1 -n zookeeper-cluster` `kubectl logs -f zookeeper-v2-2 -n zookeeper-cluster` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.digit.org/platform/guides/operations-guide/kafka-troubleshooting-guide.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.