- Available since:
- Time complexity:
- ACL categories:
CLUSTER INFO provides
INFO style information about Redis Cluster vital parameters.
The following fields are always present in the reply:
cluster_state:ok cluster_slots_assigned:16384 cluster_slots_ok:16384 cluster_slots_pfail:0 cluster_slots_fail:0 cluster_known_nodes:6 cluster_size:3 cluster_current_epoch:6 cluster_my_epoch:2 cluster_stats_messages_sent:1483972 cluster_stats_messages_received:1483968 total_cluster_links_buffer_limit_exceeded:0
cluster_state: State is
okif the node is able to receive queries.
failif there is at least one hash slot which is unbound (no node associated), in error state (node serving it is flagged with FAIL flag), or if the majority of masters can't be reached by this node.
cluster_slots_assigned: Number of slots which are associated to some node (not unbound). This number should be 16384 for the node to work properly, which means that each hash slot should be mapped to a node.
cluster_slots_ok: Number of hash slots mapping to a node not in
cluster_slots_pfail: Number of hash slots mapping to a node in
PFAILstate. Note that those hash slots still work correctly, as long as the
PFAILstate is not promoted to
FAILby the failure detection algorithm.
PFAILonly means that we are currently not able to talk with the node, but may be just a transient error.
cluster_slots_fail: Number of hash slots mapping to a node in
FAILstate. If this number is not zero the node is not able to serve queries unless
cluster-require-full-coverageis set to
noin the configuration.
cluster_known_nodes: The total number of known nodes in the cluster, including nodes in
HANDSHAKEstate that may not currently be proper members of the cluster.
cluster_size: The number of master nodes serving at least one hash slot in the cluster.
cluster_current_epoch: The local
Current Epochvariable. This is used in order to create unique increasing version numbers during fail overs.
Config Epochof the node we are talking with. This is the current configuration version assigned to this node.
cluster_stats_messages_sent: Number of messages sent via the cluster node-to-node binary bus.
cluster_stats_messages_received: Number of messages received via the cluster node-to-node binary bus.
total_cluster_links_buffer_limit_exceeded: Accumulated count of cluster links freed due to exceeding the
The following message-related fields may be included in the reply if the value is not 0: Each message type includes statistics on the number of messages sent and received. Here are the explanation of these fields:
cluster_stats_messages_ping_received: Cluster bus PING (not to be confused with the client command
cluster_stats_messages_pong_received: PONG (reply to PING).
cluster_stats_messages_meet_received: Handshake message sent to a new node, either through gossip or
cluster_stats_messages_fail_received: Mark node xxx as failing.
cluster_stats_messages_publish_received: Pub/Sub Publish propagation, see Pubsub.
cluster_stats_messages_auth-req_received: Replica initiated leader election to replace its master.
cluster_stats_messages_auth-ack_received: Message indicating a vote during leader election.
cluster_stats_messages_update_received: Another node slots configuration.
cluster_stats_messages_mfstart_received: Pause clients for manual failover.
cluster_stats_messages_module_received: Module cluster API message.
cluster_stats_messages_publishshard_received: Pub/Sub Publish shard propagation, see Sharded Pubsub.
More information about the Current Epoch and Config Epoch variables are available in the Redis Cluster specification document.
RESP2 ReplyBulk string reply: A map between named fields and values in the form of
<field>:<value>lines separated by newlines composed by the two bytes