streaming-debugging

Identifies Redpanda streaming deployment root causes via debug bundles, metrics, and logs.

6|3|Updated May 31, 2026
One-click install
npx skills add https://github.com/redpanda-data/skills --skill streaming-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: streaming-debugging
Source: https://github.com/redpanda-data/skills/tree/main/skills/streaming-debugging
Command: npx skills add https://github.com/redpanda-data/skills --skill streaming-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Diagnoses and triages issues in Redpanda streaming clusters by collecting and analyzing debug bundles, metrics endpoints, logs, and triage playbooks.

Core Features & Use Cases

  • Diagnose broker health, partition status, and Raft recovery across local and remote clusters.
  • Leverage debug bundles and Admin API data to identify root causes and guide remediation.
  • Reference detailed triage playbooks and reference materials to accelerate resolution.

Quick Start

Run a local or remote debug bundle and follow the triage playbooks to resolve issues.

Frequently Asked Questions about streaming-debugging

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

FAQPage Schema
How do I diagnose Redpanda broker health and partition status issues?

To diagnose Redpanda broker health and partition status, collect debug bundles and analyze Admin API metrics to identify root causes. This approach applies triage playbooks across local and remote clusters to guide remediation for Raft recovery and partition failures.

What is a Redpanda debug bundle and when do I need it for cluster triage?

A Redpanda debug bundle is a diagnostic package collected via rpk commands and the Admin API. You need it when triaging streaming deployments to capture logs and metrics, producing reproducible data to identify root causes for broker or Raft recovery issues.

Can I analyze Raft recovery across remote Redpanda clusters using the Admin API?

Yes, you can analyze Raft recovery across remote Redpanda clusters using the Admin API. By generating diagnostic bundles remotely and applying triage playbooks, you can evaluate partition status and broker health without requiring direct local cluster access.

Do I need rpk and Admin API access to troubleshoot Redpanda streaming deployments?

Yes, you need rpk commands and Admin API access to troubleshoot Redpanda streaming deployments. These tools generate diagnostic bundles and retrieve metrics required to identify root causes and produce reproducible triage data for enterprise features.

Why does my Redpanda partition show unhealthy status after a Raft leader election?

Unhealthy partition status after a Raft leader election often stems from recovery lag or configuration mismatches. Analyze the debug bundle logs and Admin API metrics to pinpoint the root cause, then follow triage playbooks to restore partition health.

What's the best way to triage Redpanda enterprise features in a remote deployment?

The best way to triage Redpanda enterprise features remotely is to generate a debug bundle via rpk, query the Admin API for metrics, and apply reference triage playbooks. This identifies root causes across broker health and partition status efficiently.