CLUSTER-INFO(3valkey)

📦

version 9.0.6 · 2 versions

9.0.6 · fedora 44 (latest)
8.1.10 · fedora 43

💖 CLUSTER-INFO 💖

okay bestie, this is a 3valkey manual page, and it's the one about CLUSTER INFO — literally the command that tells you how your whole Valkey Cluster is doing. vibe check for your entire cluster, no cap. 🫶

✨ NAME ✨

cluster-info — returns information about the state of a node. like, the whole tea on what your node is up to. 💅

🌸 SYNOPSIS 🌸

CLUSTER INFO

that's it. that's the whole thing. no args, no flags, just vibes. 🎀

🦋 DESCRIPTION 🦋

CLUSTER INFO gives you valkey-info(7) INFO-style information about the vital parameters of a Valkey Cluster. iconic. it's giving "doctor's chart but for your cluster."

these fields are always present in the reply, no exceptions, periodt:

cluster_state:ok
cluster_slots_assigned:16384
cluster_slots_ok:16384
cluster_slots_pfail:0
cluster_slots_fail:0
cluster_nodes_pfail:0
cluster_nodes_fail:0
cluster_voting_nodes_pfail:0
cluster_voting_nodes_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

now let's break down what each one is actually saying, bestie, because the numbers alone are lowkey cryptic:

cluster_state — State is ok if the node is able to receive queries. It's fail if there is at least one hash slot which is unbound (no node associated), in error state (the node serving it is flagged with the FAIL flag), or if the majority of primaries can't be reached by this node. so if you see fail, something is genuinely not okay.
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 FAIL or PFAIL state. the good ones. the slay ones. ✨
cluster_slots_pfail — Number of hash slots mapping to a node in PFAIL state. Note that those hash slots still work correctly, as long as the PFAIL state is not promoted to FAIL by the failure detection algorithm. PFAIL only means that we are currently not able to talk with the node, but may be just a transient error. so like, don't panic yet? 👀
cluster_slots_fail — Number of hash slots mapping to a node in FAIL state. If this number is not zero the node is not able to serve queries unless cluster-require-full-coverage is set to no in the configuration. 💀
cluster_nodes_pfail — Number of nodes in PFAIL state. A non-zero value indicates one or more nodes have been detected as unreachable but have not yet been confirmed as failed by a quorum of voting nodes.
cluster_nodes_fail — Number of nodes in FAIL state. A non-zero value indicates one or more nodes are unreachable and have been marked as failed by a quorum of voting nodes.
cluster_voting_nodes_pfail — Number of voting nodes in PFAIL state. A non-zero value indicates one or more primary nodes serving at least one slot are unreachable but not yet confirmed as failed by a quorum of voting nodes.
cluster_voting_nodes_fail — Number of voting nodes in FAIL state. A non-zero value indicates one or more primary nodes serving at least one slot have been marked as failed by a quorum of voting nodes.
cluster_known_nodes — The total number of known nodes in the cluster, including nodes in valkey-cluster-spec(7) HANDSHAKE state that may not currently be proper members of the cluster. so like, the "we've met but we're not official yet" crowd. 🙈
cluster_size — The number of primary nodes serving at least one hash slot in the cluster.
cluster_current_epoch — The local valkey-cluster-spec(7) Current Epoch. This is used in order to create unique increasing version numbers during fail overs.
cluster_my_epoch — The valkey-cluster-spec(7) Config Epoch of 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 cluster-link-sendbuf-limit configuration.

🧚 the message stats section (only shows up when it's not zero) 🧚

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_sent and cluster_stats_messages_ping_received — Cluster bus PING (not to be confused with the client command valkey-ping(7) PING). ⭐
cluster_stats_messages_pong_sent and cluster_stats_messages_pong_received — PONG (reply to PING).
cluster_stats_messages_meet_sent and cluster_stats_messages_meet_received — Handshake message sent to a new node, either through gossip or valkey-cluster-meet(7) CLUSTER MEET.
cluster_stats_messages_fail_sent and cluster_stats_messages_fail_received — Mark node xxx as failing.
cluster_stats_messages_publish_sent and cluster_stats_messages_publish_received — Pub/Sub Publish propagation, see valkey-pubsub(7) Pubsub.
cluster_stats_messages_auth-req_sent and cluster_stats_messages_auth-req_received — Replica initiated leader election to replace its primary.
cluster_stats_messages_auth-ack_sent and cluster_stats_messages_auth-ack_received — Message indicating a vote during leader election. 🗳️
cluster_stats_messages_update_sent and cluster_stats_messages_update_received — Another node slots configuration.
cluster_stats_messages_mfstart_sent and cluster_stats_messages_mfstart_received — Pause clients for manual failover.
cluster_stats_messages_module_sent and cluster_stats_messages_module_received — Module cluster API message.
cluster_stats_messages_publishshard_sent and cluster_stats_messages_publishshard_received — Pub/Sub Publish shard propagation, see valkey-pubsub(7) Sharded Pubsub.

More information about the Current Epoch and Config Epoch variables are available in the valkey-cluster-spec(7) Valkey Cluster specification document. 📚

💌 REPLY 💌

valkey-protocol(7) Bulk string reply: a map between named fields and values in the form of <field>:<value> lines separated by newlines composed by the two bytes CRLF. so like, a bunch of little lines, each one name:value, glued together with CRLF. clean. 😌

⚡ COMPLEXITY ⚡

O(1) — constant time, bestie. instant. no waiting around. 🔥

👑 ACL CATEGORIES 👑

@slow

ngl it's tagged @slow, so keep that in mind when you're thinking about permissions. the tag says what it says, I don't make the rules. 💅

🌈 HISTORY 🌈

Available since: 3.0.0

and that's the whole page, bestie. version 9.0.0, dated 2025-10-21 — go forth and read your cluster's aura. 💖✨🦋🌸🫶

📦 where this page comes from

fedora 44: valkey-doc 9.0.3-2.fc44 · CC-BY-SA-4.0
fedora 44: valkey-doc 9.0.6-1.fc44 · CC-BY-SA-4.0
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash on 2026-10-14: a language model's rewrite of the original, under its terms