CLUSTER INFO

用法
CLUSTER INFO
复杂度
O(1)
起始版本
3.0.0
ACL 类别
@slow

CLUSTER INFO 提供关于 Valkey 集群重要参数的 INFO 风格信息。回复中始终包含以下字段

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
  • cluster_state:如果节点能够接收查询,状态为 ok。如果至少有一个哈希槽未绑定(未关联节点),处于错误状态(服务该哈希槽的节点被标记为 FAIL 标志),或者该节点无法联系到大多数主节点,则状态为 fail
  • cluster_slots_assigned:已关联到某个节点(未绑定)的槽数量。为了节点正常工作,此数量应为 16384,这意味着每个哈希槽都应映射到一个节点。
  • cluster_slots_ok:映射到未处于 FAILPFAIL 状态的节点的哈希槽数量。
  • cluster_slots_pfail:映射到处于 PFAIL 状态的节点的哈希槽数量。请注意,只要 PFAIL 状态未被故障检测算法升级为 FAIL,这些哈希槽仍然可以正常工作。PFAIL 仅表示我们目前无法与节点通信,但这可能只是一个瞬时错误。
  • cluster_slots_fail:映射到处于 FAIL 状态的节点的哈希槽数量。如果此数字不为零,则节点无法提供查询服务,除非配置文件中 cluster-require-full-coverage 设置为 no
  • cluster_nodes_pfail:处于 PFAIL 状态的节点数量。非零值表示一个或多个节点已被检测为不可达,但尚未被投票节点仲裁确认失败。
  • cluster_nodes_fail:处于 FAIL 状态的节点数量。非零值表示一个或多个节点不可达,并已被投票节点仲裁标记为失败。
  • cluster_voting_nodes_pfail:处于 PFAIL 状态的投票节点数量。非零值表示一个或多个服务至少一个槽的主节点不可达,但尚未被投票节点仲裁确认失败。
  • cluster_voting_nodes_fail:处于 FAIL 状态的投票节点数量。非零值表示一个或多个服务至少一个槽的主节点已被投票节点仲裁标记为失败。
  • cluster_known_nodes:集群中已知节点的总数,包括处于 HANDSHAKE 状态的节点,这些节点可能当前不是集群的正式成员。
  • cluster_size:集群中服务至少一个哈希槽的主节点数量。
  • cluster_current_epoch:本地 Current Epoch 变量。这用于在故障转移期间创建唯一的递增版本号。
  • cluster_my_epoch:我们正在通信的节点的 Config Epoch。这是分配给此节点的当前配置版本。
  • cluster_stats_messages_sent:通过集群节点到节点二进制总线发送的消息数量。
  • cluster_stats_messages_received:通过集群节点到节点二进制总线接收的消息数量。
  • total_cluster_links_buffer_limit_exceeded:因超出 cluster-link-sendbuf-limit 配置而释放的集群链接的累计计数。

如果值不为 0,回复中可能包含以下消息相关字段:每种消息类型都包含发送和接收消息数量的统计信息。以下是这些字段的解释

  • cluster_stats_messages_ping_sentcluster_stats_messages_ping_received:集群总线 PING(不要与客户端命令 PING 混淆)。
  • cluster_stats_messages_pong_sentcluster_stats_messages_pong_received:PONG(对 PING 的回复)。
  • cluster_stats_messages_meet_sentcluster_stats_messages_meet_received:发送给新节点的握手消息,通过流言协议或 CLUSTER MEET 发送。
  • cluster_stats_messages_fail_sentcluster_stats_messages_fail_received:将节点 xxx 标记为失败。
  • cluster_stats_messages_publish_sentcluster_stats_messages_publish_received:发布/订阅传播,参见 Pubsub
  • cluster_stats_messages_auth-req_sentcluster_stats_messages_auth-req_received:副本发起的领导者选举,以替换其主节点。
  • cluster_stats_messages_auth-ack_sentcluster_stats_messages_auth-ack_received:表示领导者选举期间投票的消息。
  • cluster_stats_messages_update_sentcluster_stats_messages_update_received:另一个节点的槽配置。
  • cluster_stats_messages_mfstart_sentcluster_stats_messages_mfstart_received:为手动故障转移暂停客户端。
  • cluster_stats_messages_module_sentcluster_stats_messages_module_received:模块集群 API 消息。
  • cluster_stats_messages_publishshard_sentcluster_stats_messages_publishshard_received:发布/订阅分片传播,参见 分片发布/订阅

有关 Current Epoch 和 Config Epoch 变量的更多信息,请参阅 Valkey 集群规范文档

RESP2/RESP3 回复

批量字符串回复:一个命名字段和值之间的映射,形式为 <field>:<value>,各行由两个字节 CRLF 组成的新行分隔。