rpk cluster health

Queries health overview.

Health overview is created based on the health reports collected periodically from all nodes in the cluster. A cluster is considered healthy when the following conditions are met:

  • all cluster nodes are responding

  • all partitions have leaders

  • the cluster controller is present


rpk cluster health [flags]


Value Type Description

-e, --exit-when-healthy


When used with watch, exits after cluster is back in healthy state.

-h, --help


Help for health.

-w, --watch


Blocks and writes out all cluster health changes.



Redpanda or rpk config file; default search paths are ~/.config/rpk/rpk.yaml, $PWD, and /etc/redpanda/redpanda.yaml.

-X, --config-opt


Override rpk configuration settings; '-X help' for detail or '-X list' for terser detail.



rpk profile to use.

-v, --verbose


Enable verbose logging.