KR.ADMIN LIST-MEMBERS

Lists all members in the cluster with their metadata.

Syntax

KR.ADMIN LIST-MEMBERS

Parameters

None.

Return Value

RESP3 map where each key is a member ID (string) and each value is a map of member properties:

Field	Type	Description
`status`	string	Member status: `RUNNING`, `UNAVAILABLE`, `STOPPED`, or `UNKNOWN`
`process_id`	string	Base32-hex encoded Versionstamp, unique per process lifetime
`external_advertise`	array of strings	Addresses clients connect to, `host:port`, preferred entry first
`internal_advertise`	array of strings	Addresses other cluster members connect to, `host:port`, preferred entry first
`latest_heartbeat`	integer	Monotonically increasing heartbeat counter, incremented by one on each heartbeat interval. `0` if no heartbeat has been recorded yet

Behavior

Returns all known cluster members regardless of their status. Members are sorted by process_id.

Requires cluster initialization.

Errors

Cluster errors:

Error Code	Error message	Cause
`ERR`	`cluster has not been initialized yet`	-

Examples

Single-member cluster:

127.0.0.1:3320> KR.ADMIN LIST-MEMBERS
1# "006cdc459c59e600c76494e8388857fc3cba2fa8" =>
   1# "status" => "RUNNING"
   2# "process_id" => "A1B2C3D4E5F6G7H8I9J0"
   3# "external_advertise" =>
      1) "127.0.0.1:5484"
   4# "internal_advertise" =>
      1) "127.0.0.1:3320"
   5# "latest_heartbeat" => (integer) 31404

Multi-member cluster:

127.0.0.1:3320> KR.ADMIN LIST-MEMBERS
1# "006cdc459c59e600c76494e8388857fc3cba2fa8" =>
   1# "status" => "RUNNING"
   2# "process_id" => "A1B2C3D4E5F6G7H8I9J0"
   3# "external_advertise" =>
      1) "10.0.0.1:5484"
   4# "internal_advertise" =>
      1) "10.0.0.1:3320"
   5# "latest_heartbeat" => (integer) 31404
2# "a3f18b2e74d9c5601f82e4a7b390d612c8f7e149" =>
   1# "status" => "UNAVAILABLE"
   2# "process_id" => "K1L2M3N4O5P6Q7R8S9T0"
   3# "external_advertise" =>
      1) "10.0.0.2:5484"
   4# "internal_advertise" =>
      1) "10.0.0.2:3320"
   5# "latest_heartbeat" => (integer) 31390