服务注册与分布式协调 / 系统课时

节点状态信息

节点状态信息

ZooKeeper 不只保存 znode 的数据,还为每个节点维护一组 Stat 元数据。读懂这些字段后,你可以判断节点何时创建、最近发生了哪类变化、是否为临时节点,以及数据和子节点是否发生过更新。

学习目标

  • 读懂 cZxid、mZxid、pZxid 与时间字段的含义
  • 区分数据、子节点和 ACL 对应的版本计数
  • 根据 ephemeralOwner、dataLength、numChildren 判断节点当前状态

读取节点的 Stat

在 zkCli.sh 中,stat 只读取元数据;get -s 会同时返回节点数据和 Stat。下面创建一个持久节点并查看状态。若路径已经存在,请换一个新的测试路径。

text
create /anystack-stat-demo abc
stat /anystack-stat-demo

预期输出

text
Created /anystack-stat-demo
cZxid = <CZXID>
ctime = <TIME>
mZxid = <MZXID>
mtime = <TIME>
pZxid = <PZXID>
cversion = 0
dataVersion = 0
aclVersion = 0
ephemeralOwner = 0x0
dataLength = 3
numChildren = 0

<CZXID>、<MZXID>、<PZXID> 和 <TIME> 由当前集群事务历史决定,实际值会不同。刚创建且尚未修改的节点通常具有 dataVersion = 0、cversion = 0 和 aclVersion = 0。

用 zxid 判断发生过什么

zxid 是 ZooKeeper 为事务分配的全局递增标识。一个节点会记录三个与事务相关的 zxid,它们回答的是不同问题。

字段 含义 典型用途
cZxid 创建该 znode 的事务 zxid 判断节点创建对应的事务位置
mZxid 最近一次修改该 znode 数据的事务 zxid 判断数据是否在创建后又被修改
pZxid 最近一次修改该 znode 子节点列表的事务 zxid 判断其直接子节点集合最近是否变化

不要把 pZxid 理解成“父节点的 zxid”。其中的 p 表示与子节点列表变化相关;当当前节点下面创建或删除直接子节点时,它才会反映新的结构事务。

时间与版本字段各管一类变化

ctime 是节点创建时间,mtime 是节点数据最近修改时间。ZooKeeper 的 Stat 结构保存的是毫秒级时间值,而 CLI 通常把它格式化成人类可读时间。子节点增删不会因为“结构变化”而自动改写当前节点的数据,因此不能仅靠 mtime 判断整个节点树是否变化。

版本字段则是局部计数器。CLI 中常显示 dataVersion、cversion、aclVersion;在 Stat API 或文档中,前后两者也常写作 version 和 aversion。

CLI 字段 对应变化 初始值
dataVersion 当前节点数据被成功修改的次数 0
cversion 当前节点直接子节点列表被修改的次数 0
aclVersion 当前节点 ACL 被成功修改的次数 0

这些版本号只描述当前 znode 的局部历史,不是全局事务编号。需要跨节点判断先后关系时看 zxid;需要对单个节点做条件更新时看对应版本号。

所有者、长度与子节点数量

ephemeralOwner 用来判断临时节点归属。持久节点为 0x0;临时节点会记录创建它的会话 ID。会话失效后,该临时节点会由 ZooKeeper 删除,因此排查“节点为什么突然消失”时,这个字段很关键。

dataLength 是当前节点数据的字节长度,不是字符数;使用 UTF-8 中文或二进制内容时,字节数可能大于肉眼看到的字符数。numChildren 只统计当前节点的直接子节点,不递归统计后代。

从字段组合判断变化来源

单看一个字段容易误判,实际排查应组合观察。如果 mZxid 和 dataVersion 增加而 cversion 不变,说明主要是节点数据被更新;如果 pZxid 和 cversion 增加而 dataVersion 不变,说明直接子节点集合发生了变化;如果只有 aclVersion 增加,则变化来自 ACL。

Stat 的价值不是“多看几个数字”,而是把创建、数据修改、子节点变化、ACL 修改和会话归属拆成可独立判断的证据。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

节点状态信息

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通