skills.rest
redpanda-data
redpanda-dataOFFICIAL
Explore all skills by this author →
Website𝕏@redpandadataGitHub

rpk-cluster

Diagnose and manage Redpanda clusters via the rpk cluster command.

6|3|Updated May 31, 2026
Search Tags:#maintenance#health#cluster#admin-api#balancer#redpanda#rpk
One-click install
npx skills add https://github.com/redpanda-data/skills --skill rpk-cluster
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: rpk-cluster
Source: https://github.com/redpanda-data/skills/tree/main/skills/rpk-cluster
Command: npx skills add https://github.com/redpanda-data/skills --skill rpk-cluster

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Operates a Redpanda cluster from the command line using the rpk cluster command group — the CLI front-end to the Admin API. Covers health checks, cluster metadata, broker management, cluster configuration, partition balancing and movement, maintenance mode, client quotas, log directories, transactions, self-test benchmarks, and license management. Use when: checking cluster health or metadata, listing or decommissioning brokers, getting or setting cluster configuration properties, balancing or moving partitions, enabling or disabling maintenance mode on a node, managing client quotas, viewing log dirs, running cluster self-tests, or managing the Redpanda license from the CLI. Also use when asked about rpk cluster health, rpk cluster info, rpk cluster brokers, rpk cluster config get/set/edit/import/export/lint/status, rpk cluster partitions list/balance/move/move-cancel/move-status, rpk cluster maintenance enable/disable/status, rpk cluster quotas alter/describe/import, rpk cluster logdirs describe, rpk cluster quotas, and rpk cluster self-test — all things.

Core Features & Use Cases

  • Health checks for cluster status and per-node readiness.
  • Broker management tasks including info, decommission, and recommission workflows.
  • Cluster configuration exploration and modification (get/set/edit/list/export/import/lint/status).
  • Partitions balancing, movement, and balancer status for load distribution.
  • Maintenance mode orchestration and rolling upgrade planning.
  • Quotas, logdirs, and self-test workflows for operational health and governance.
  • Enterprise licensing checks and feature gating via the Admin API.

Quick Start

Install the skill and run a quick health check of your Redpanda cluster using rpk cluster health.

Frequently Asked Questions about rpk-cluster

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

FAQPage Schema
How do I check the health of a Redpanda cluster from the command line?▼

Check Redpanda cluster health from the command line using rpk cluster health to validate cluster status and expose per-node readiness across all nodes. This provides immediate visibility into whether your brokers are ready and operating normally.

How do I decommission a broker in a Redpanda cluster?▼

Decommission a Redpanda broker using rpk cluster brokers decommission to safely remove it from the cluster. You can also recommission brokers if needed, coordinating node management tasks directly through the Admin API.

What is the best way to balance partitions across Redpanda cluster nodes?▼

Balance partitions across Redpanda cluster nodes using rpk cluster partitions balance to distribute load evenly. You can also trigger individual partition moves, check move status, or cancel ongoing moves to manage load distribution.

How do I enable maintenance mode on a Redpanda node for rolling upgrades?▼

Enable maintenance mode on a Redpanda node using rpk cluster maintenance enable to orchestrate rolling upgrades safely. Check the status with rpk cluster maintenance status and disable it once maintenance is complete.

Can I manage cluster configuration properties in Redpanda without editing files manually?▼

Manage Redpanda cluster configuration properties directly using rpk cluster config commands to get, set, edit, import, export, lint, and check the status of your cluster settings. This validates and applies configuration changes across all nodes.

How do I view and manage client quotas in a Redpanda cluster?▼

View and manage client quotas in a Redpanda cluster using rpk cluster quotas describe and alter commands. You can import quota configurations to enforce operational governance and resource limits across your cluster clients.

Related Skills

Explore More Software Engineering Skills→
redpanda-dataredpanda-data
6

rpk

Install and configure the rpk CLI for Redpanda cluster and profile management.

Official
Advanced
dapperdiversdapperdivers
1

daily-ops-report

Generate daily infrastructure health reports from Kubernetes cluster and GitOps data.

Community
Advanced
redpanda-dataredpanda-data
6

rpk-debug

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

Official
Intermediate
redpanda-dataredpanda-data
6

streaming-admin-api

Manage Redpanda clusters programmatically via HTTP REST endpoints on port 9644.

Official
Advanced