rpk-debug

Gather local and remote Redpanda diagnostics bundles via rpk debug commands.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Gathers local and remote Redpanda diagnostics bundles to streamline troubleshooting and support.

Core Features & Use Cases

  • Local bundle collection via rpk debug bundle to capture broker logs, metrics, and Admin API snapshots.
  • Remote bundle collection via rpk debug remote-bundle to gather cluster-wide diagnostics through the Admin API.
  • Works in Linux and Kubernetes environments, producing ZIP bundles ready for analysis.

Quick Start

Run the rpk debug bundle to generate a local diagnostics bundle for troubleshooting.

Frequently Asked Questions about rpk-debug

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

FAQPage Schema
How do I collect Redpanda diagnostics for cluster troubleshooting?

You can gather Redpanda diagnostics by running rpk debug bundle to capture local broker logs, metrics, and Admin API snapshots, or use rpk debug remote-bundle for cluster-wide data collection through the Admin API.

What is the difference between local and remote Redpanda debug bundle collection?

Local Redpanda debug bundle collection directly captures broker logs and metrics from the host, while remote collection gathers cluster-wide diagnostics through the Admin API to streamline remote troubleshooting and support.

Can I run rpk debug commands to gather diagnostics in a Kubernetes environment?

Yes, rpk debug commands work in both Linux and Kubernetes environments. They can generate diagnostics bundles containing Admin API snapshots and Kafka metadata across your deployed Redpanda cluster.

What data is included in an rpk debug bundle for Redpanda support?

An rpk debug bundle includes local broker logs, performance metrics, Admin API snapshots, and Kafka metadata. This comprehensive diagnostics data accelerates triaging cluster issues and generating support bundles.

When should I use remote bundle collection for Redpanda cluster issues?

Use remote bundle collection via rpk debug remote-bundle when you need to gather cluster-wide diagnostics through the Admin API. This is ideal for triaging cluster issues and generating support bundles across Linux and Kubernetes environments.