ServiceRadar rperf网络性能测试:主动探测提前发现WAN链路劣化
ServiceRadar rperf网络性能测试:主动探测提前发现WAN链路劣化
ServiceRadar 是一款开源的网络管理与监控平台,其内置的 rperf 网络性能测试模块正是用于主动探测 WAN 链路的利器:它按固定间隔生成合成的 TCP/UDP 流量,持续测量两个网络点之间的吞吐、丢包率与抖动,从而在用户还没抱怨"网慢了"之前,就提前发现 WAN 链路劣化。
🎯 为什么需要主动探测:被动监控的盲区
被动监控(SNMP 流量、NetFlow、接口计数器)只能观察"已经存在的流量"。它的盲区在于:
- 链路容量是否真的够用?被动观测看不到上限;
- 运营商链路在高峰期的隐性降速,可能恰好发生在没有业务流量的时段;
- 丢包与抖动这类指标,接口计数器根本给不出来。
rperf 的思路正好相反:主动制造压力,像体检一样定期给网络"做负荷测试"。每组测试都会上报 4 类结果:
| 指标 | 含义 |
|---|---|
| Throughput(吞吐) | TCP/UDP 实际达到的 bps 速率 |
| Jitter(抖动) | UDP 包时延的波动,单位毫秒 |
| Packet loss(丢包) | 发送 vs 接收的包数及丢包百分比(仅 UDP) |
| Bytes / Packets | 测试窗口内的总传输量 |
这套数据落地后即可验证链路容量、捕捉 WAN 劣化,并对用户侧慢连接提前告警。
🧩 ServiceRadar rperf 架构:checker 与 server 如何配合
理解 rperf 只需记住两个组件(完整说明见 docs/docs/rperf.md):
| 组件 | 角色 | 端口 |
|---|---|---|
rperf checker(serviceradar-rperf-checker) |
按调度周期发起测试,并把结果写回 ServiceRadar | TCP 50081(gRPC + mTLS) |
rperf server(serviceradar-rperf) |
部署在被测主机上的靶机 | TCP 5199 + UDP 数据端口池 5200-5210 |
工作流程分三步:
- ServiceRadar agent/gateway 轮询 rperf checker,checker 按自己的调度对每个目标发起测试;
- checker 作为 rperf 客户端连接目标主机的
5199控制端口,随后在数据端口池上跑流量; - 测试结果以时序指标的形式推回 ServiceRadar,进入统一的指标库,可查询、可告警。
checker 的 Rust 实现位于 rust/rperf-client/src/,其中 rust/rperf-client/src/rperf.rs 负责解析 rperf 输出并汇总指标,rust/rperf-client/src/server.rs 负责把 rperf.bits_per_second、rperf.loss_percent、rperf.jitter_ms 等指标上报为时序数据;gRPC 接口定义见 proto/rperf/rperf.proto。
⚙️ 配置 rperf 测试目标:这些参数最关键
checker 读取一个 JSON 配置文件(默认 /etc/serviceradar/checkers/rperf.json),官方模板见 rust/rperf-client/config/default_template.json。最小可用配置如下:
{
"listen_addr": "0.0.0.0:50081",
"default_poll_interval": 300,
"targets": [
{
"name": "WAN TCP Test",
"address": "10.0.0.20",
"port": 5199,
"tcp_port_pool": "5200-5210",
"protocol": "tcp",
"bandwidth": 1000000,
"duration": 10.0,
"parallel": 1,
"omit": 1,
"poll_interval": 300
}
]
}
最关键的几个目标字段:
| 字段 | 作用 |
|---|---|
protocol |
tcp 或 udp。要测抖动和丢包,必须用 UDP |
reverse |
true 时由服务端发送(测的是"下载方向") |
bandwidth |
目标速率,单位字节/秒(1000000 = 1 MB/s) |
duration / omit |
测试时长;omit 是预热秒数,不计入结果,让数据更稳 |
parallel |
并行流数,调高可压测多流并发吞吐 |
poll_interval |
该目标的测试间隔(秒),WAN 链路建议 5 分钟以内 |
💡 小技巧:给同一条 WAN 链路分别配置
tcp和udp两个目标,即可同时拿到吞吐基线与抖动/丢包曲线——Docker 部署的示例配置 docker/compose/rperf-client.docker.json 正是这么写的。
📡 部署 rperf 测试:Docker 与 Helm 两种方式
在目标主机上装 rperf server(被测端):
sudo systemctl enable --now serviceradar-rperf
它默认以 --port 5199 --tcp-port-pool 5200-5210 --udp-port-pool 5200-5210 启动,以非特权用户运行,日志位于 /var/log/rperf/rperf.log。
部署 rperf checker(探测端):
- Docker Compose:启用
rperf-client服务即可,入口脚本 docker/compose/entrypoint-rperf-client.sh 会等待 mTLS 证书就绪后再拉起服务,checker 模板见 docker/compose/checker-templates/rperf.json; - Helm:Chart 自带
serviceradar-rperf-clientDeployment(见 helm/serviceradar/templates/rperf-checker.yaml),以 Service 形式暴露50081端口并挂载运行时证书。
⚠️ 两种方式的默认配置中,目标地址都是占位符 PLACEHOLDER_RPERF_TARGET_ADDRESS,必须替换成真实 rperf server 的地址,否则 checker 只会对着空气打流量。
🔒 安全提醒:rperf server 会接受任何可达客户端的测试流量,生产环境务必用防火墙把 5199 与 5200-5210 限制为只允许 checker 来源 IP 访问(ufw/firewalld/iptables 示例见 docs/docs/rperf.md 和 rust/rperf-client/README.md)。
🔔 用 SRQL 查询结果,并建立劣化告警
rperf 结果以时序指标存储,SRQL 中 rperf 实体是 timeseries_metrics 的别名,查询方式和普通指标一致:
-- 最近 50 条 rperf 测量
in:rperf | sort timestamp desc | limit 50
-- 某目标过去一天的吞吐
in:rperf metric_name:"bits_per_second" target_device_ip:"10.0.0.20" | sort timestamp desc
-- UDP 丢包率趋势
in:rperf metric_name:"loss_percent" | sort timestamp desc
有了时序数据,WAN 链路劣化告警可以按 4 类规则搭建(通过 Rule Builder 转为通知):
- 吞吐下降:
bits_per_second跌破预期基线; - 丢包上升:
loss_percent超过阈值(UDP 目标); - 抖动超标:
jitter_ms超出对时延敏感业务的容忍度; - 结果缺失:某个
poll_interval的数倍时间内没有任何指标到达——通常意味着 checker 已连不上 rperf server,这本身往往就是链路故障的最早信号。
✅ 上手清单:5 步完成 WAN 链路主动探测
- 在目标主机部署 rperf server,放行
5199+5200-5210端口; - 部署 rperf checker,配置改为 mTLS 模式并挂载证书;
- 把
PLACEHOLDER_RPERF_TARGET_ADDRESS替换为目标 server 地址; - 为同一条链路添加
tcp与udp两个目标,poll_interval设为 300 秒; - 在 Rule Builder 中建立吞吐下降 + 丢包上升 + 结果缺失三类告警。
总结
ServiceRadar 的 rperf 模块把"链路体检"变成了自动化例行动作:checker 主动压测、server 被动承测、结果统一入库,再叠加 SRQL 查询与规则告警。相比被动监控,这种主动探测能直接回答两个关键问题——"这条 WAN 链路到底能跑多快""它现在是否正在劣化",让网络团队从"用户投诉后救火"转变为"劣化发生前收到告警"。更多细节可阅读官方文档 docs/docs/rperf.md。

