Tier 管理面(healthz/readyz/状态导出/admin 协议)——二期-D1
探针语义
| 探针 | API | 语义 |
|---|---|---|
| healthz | node.GetStateSnapshot().Healthy |
循环存活(无 LoopException)且已启动——停摆/故障 = false |
| readyz | node.GetStateSnapshot().Ready |
已知 leader(含自身在位)——分区/选举中 = false(不返回过期承诺) |
状态导出
node.GetStateSnapshot() 返回 RaftStateSnapshot:
Role / Term / LeaderId / CommitIndex / AppliedIndex / LastLogIndex / SnapshotIndex /
IsVoter / Healthy / Ready / Members(leader 视角复制进度:各成员 matchIndex + lag)。
远程查询(admin 协议·0x70 产品面)
// 服务端挂载(每节点一次——0x70 注册区产品自管号)
var admin = new TierRaftAdmin(transport, () => node.GetStateSnapshot());
// 远程查询(任意节点/客户端——经传输请求回调)
var state = await TierRaftAdmin.QueryStateAsync(transport, targetId, ct); // 全量状态 + 成员复制进度
var health = await TierRaftAdmin.QueryHealthAsync(transport, targetId, ct); // 轻量 healthz/readyz
状态供给回调返回 null = 节点未就绪——探针应答 Healthy=false(fail-closed)。
领导权转让与事务逃生门(0x70 产品面)
var admin = new TierRaftAdmin(transport, () => node.GetStateSnapshot());
// 领导权定向转让(0x05/0x06——优雅运维/换届,不走选举超时)
await TierRaftAdmin.TransferLeaderAsync(transport, targetId, newLeaderId, ct);
// 跨组事务逃生门(0x07-0x0A——X7 悬干裁决)
var inDoubt = await TierRaftAdmin.QueryTxnInDoubtAsync(transport, targetId, txnId, groupId, ct); // 悬干查询
await TierRaftAdmin.ForceAbortAsync(transport, targetId, txnId, groupId, ct); // 强制中止
多组场景经 groupId 区分参与组(0x62 事务参与组域);逃生门 = 确定性裁决入口,
日常事务路径不经过。
组装总概
九产品直连 raft 装配(ReplicaBuilder 九件对等 + TierReplicaSet 装载器)与 hub raft 成员
装配(AddRaft*Async 族)的完整形态见直连 raft 挂载;
节点底座见 TierRaftNode;权限面见 hub 数据权限。