monitor-agent

monitor 的 Linux agent。采集本机指标，经 WebSocket 上报 hub。

静态链接单文件，无运行时依赖，常驻内存数 MB。

特性

• 直接读 /proc 与 statvfs，不依赖 sysinfo
• 内存对齐 free(1) 的 used 列，磁盘对齐 df(1) 的 Used 列，见 docs/data-accuracy.md
• 无状态：不写文件，不保存跨重启的数据，流量累加由 hub 负责
• token 走 Authorization 头，不进反向代理的 access log
• 非回环地址拒绝明文 ws://

安装

在 hub 的面板添加节点，复制生成的命令在目标主机执行：

curl -fsSL https://your-hub/install.sh | sh -s -- --server https://your-hub --token <token>

安装脚本识别 systemd 与 OpenRC，二进制装到 /opt/monitor/monitor-agent，token 写入 /opt/monitor/agent.env（0600）——和 hub 同一个目录，那台机器上只有这一处要看。

运行

monitor-agent --server https://your-hub --token <token>

参数	默认	说明
--server	必填	hub 地址，也可用 MONITOR_SERVER
--token	必填	节点 token，也可用 MONITOR_TOKEN
--interval	1	上报间隔（秒），1–3600

上报字段

src/collect.rs 中的 Facts 与 Metrics 两个 struct 直接序列化为线上 JSON，是字段的权威定义。

• Facts 连接时上报一次：主机名、系统、内核、架构、虚拟化类型、CPU 型号与核数、内存与磁盘总量、本机 IPv4 / IPv6
• Metrics 每 --interval 秒上报：CPU、负载、内存、swap、磁盘、网卡收发速率与内核累计计数器、TCP / UDP 连接数、进程数、运行时间

net_rx_total / net_tx_total 为内核 lifetime 计数器，原样上报；boot_id 取自 /proc/sys/kernel/random/boot_id，是 hub 判定主机重启的唯一依据，不要删。

协议说明见 hub 的 docs/architecture.md。

构建

需要 Rust stable。

cargo build --release
cargo test
cargo clippy --all-targets

发布产物为 musl 静态链接二进制，推送 v* tag 由 .github/workflows/release.yml 构建。

许可

MIT