服务注册与分布式协调 / 系统课时
节点状态信息
节点状态信息
ZooKeeper 不只保存 znode 的数据,还为每个节点维护一组 Stat 元数据。读懂这些字段后,你可以判断节点何时创建、最近发生了哪类变化、是否为临时节点,以及数据和子节点是否发生过更新。
学习目标
- 读懂
cZxid、mZxid、pZxid与时间字段的含义 - 区分数据、子节点和 ACL 对应的版本计数
- 根据
ephemeralOwner、dataLength、numChildren判断节点当前状态
读取节点的 Stat
在 zkCli.sh 中,stat 只读取元数据;get -s 会同时返回节点数据和 Stat。下面创建一个持久节点并查看状态。若路径已经存在,请换一个新的测试路径。
create /anystack-stat-demo abc
stat /anystack-stat-demo预期输出
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 修改和会话归属拆成可独立判断的证据。