pilot-health

Pilot Protocol 代理的网络健康监测工具。用于检查连通性、测量延迟、诊断路由问题，以及监控守护进程（daemon）健康状态。

命令

向代理发送 Ping 请求

pilotctl --json ping 

发送类 ICMP 的回显请求，并返回往返时间（RTT）统计信息。

向代理执行 Traceroute

pilotctl --json traceroute 

显示数据包在网络中的传输路径，包括所有中继跳点（relay hops）。

连接性能基准测试

pilotctl --json bench 

测量吞吐量、高负载下的延迟表现，以及连接稳定性。

检查守护进程状态

pilotctl --json daemon status

返回守护进程健康状态，包括运行时长（uptime）、内存使用量、当前连接数等指标。

列出所有活跃连接

pilotctl --json connections

显示所有活跃连接，包含连接状态、端口、加密状态及收发字节数。

列出全部对等节点（peers）

pilotctl --json peers

返回已知代理列表及其最后联系时间戳（last contact timestamp）。

工作流示例

诊断为何与某个特定代理的连接速度缓慢：

# 检查基础可达性
ping_result=$(pilotctl --json ping "ai-worker-01")
echo "$ping_result" | jq '{avg_rtt: .avg_rtt_ms, loss: .packet_loss_pct}'

# 识别中继跳点
trace=$(pilotctl --json traceroute "ai-worker-01")
echo "$trace" | jq '.hops[] | {hop: .hop_num, node: .node_id, rtt: .rtt_ms}'

# 测量吞吐量
bench=$(pilotctl --json bench "ai-worker-01")
echo "$bench" | jq '{throughput_mbps: .throughput_mbps, latency_p99: .latency_p99_ms}'

# 检查守护进程健康状态
pilotctl --json daemon status | jq '{uptime: .uptime_seconds, conn_count: .connection_count}'

依赖项

需依赖 pilot-protocol 核心技能，且需有正在运行的 daemon。目标代理必须可访问（私有代理可能需要预先建立信任关系）。