troubleshoot-kafka

Diagnose Kafka failures by mapping symptoms to Netdata operator playbook archetypes.

1|Updated Apr 17, 2026
One-click install
npx skills add https://github.com/netdata/skills --skill troubleshoot-kafka
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: troubleshoot-kafka
Source: https://github.com/netdata/skills/tree/main/skills/troubleshoot-kafka
Command: npx skills add https://github.com/netdata/skills --skill troubleshoot-kafka

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Diagnose Kafka incidents like ISR shrinkage, leaderless partitions, consumer lag, controller overload, and broker disk exhaustion with a structured, signal-driven approach instead of guessing from generic health checks.

Core Features & Use Cases

  • Netdata MCP signal triage: Queries Netdata via MCP to confirm which Kafka failure archetype is actually occurring.
  • Operator playbook diagnostic tree: Applies the Netdata operator playbook’s failure-pattern logic to guide step-by-step investigation and narrowing.
  • Remediation verification loop: Re-queries the same MCP signals after remediation to ensure the anomalous signals return to expected ranges.

Quick Start

Ask the AI: "Investigate my Kafka cluster and tell me whether the incident is caused by ISR shrinkage, leaderless partitions, consumer lag, controller overload, or broker disk exhaustion, then recommend the most likely remediation using Netdata MCP signals."

Frequently Asked Questions about troubleshoot-kafka

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I troubleshoot Kafka ISR shrinkage and consumer lag using observability signals?

Troubleshoot Kafka ISR shrinkage and consumer lag by mapping reported symptoms to Netdata operator playbook failure archetypes. This approach uses MCP-based anomaly ranking and signal discovery over defined windows to guide step-by-step incident triage instead of generic health checks.

What is the best way to diagnose leaderless partitions and controller overload during a Kafka incident?

Diagnosing leaderless partitions and controller overload requires mapping the symptoms to known failure archetypes via a structured diagnostic tree. The Skill queries Netdata MCP signals to confirm the specific degradation occurring, narrowing down the root cause for on-call triage.

How do I verify Kafka remediation after fixing broker disk exhaustion?

Verify Kafka remediation by re-querying the same Netdata MCP signals used during diagnosis. This post-remediation verification loop checks whether the anomalous telemetry signals for issues like broker disk exhaustion have returned to their expected ranges.

Can I use this Kafka triage approach for on-call incident response without manual metric analysis?

Yes, you can use this for on-call incident response without manual metric analysis. It applies rule-file guided diagnostics to automatically rank anomalies and map them to specific Kafka failure patterns like ISR shrinkage or leader election failures using Netdata telemetry.

Does this Kafka troubleshooting method work for broker disk exhaustion and performance degradations?

Yes, this troubleshooting method works for broker disk exhaustion and related performance degradations. It queries Netdata via MCP to discover health signals and applies operator playbook logic to triage availability and performance issues across the Kafka cluster.

Why are my Kafka health checks not showing the root cause of leader election failures?

Generic Kafka health checks often miss root causes because they lack signal-driven triage. By applying an operator playbook diagnostic tree to MCP-based anomaly ranking over defined windows, you can pinpoint specific failure archetypes like leader election failures instead of guessing.