Table of Contents

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 数据权限。