wrk2命令速查
编译与安装、恒定速率压测、结果与达成率解读、速率阶梯容量评估、Lua 脚本、工具对比与报错排查等 126 条命令
共 126 条命令 · 10 类场景 · 点击右侧图标可复制
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
wrk2 -v | 查看版本,确认装的是 wrk2 而不是原版 wrk | |
wrk2 | 不带参数输出 usage,可见 -R 与 --u_latency 选项 | |
git clone https://github.com/giltene/wrk2 && cd wrk2 && make | 官方仓库只有源码,需要自行编译 | |
apt install build-essential libssl-dev zlib1g-dev | 编译依赖,缺 OpenSSL 头文件会链接失败 | |
make -j$(nproc) | 多核并行编译,加快构建 | |
sudo cp wrk /usr/local/bin/wrk2 | 源码编译产物名为 wrk,改名避免与原版冲突 | |
which -a wrk wrk2 | 确认两个工具路径,防止误调用 | |
docker run --rm skandyla/wrk2 -t4 -c100 -d30s -R2000 url | 社区镜像方式运行,注意容器 CPU 限额 | |
nproc | 查看核数,决定 -t 上限 | |
wrk2 依赖 LuaJIT | 新系统 gcc 较新时编译可能报错,换合适 tag 或旧编译器 |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
wrk2 -t4 -c100 -d30s -R2000 http://example.com/ | 标准用法:每秒恒定发 2000 个请求 | |
wrk2 -t4 -c100 -d30s -R2000 --latency http://example.com/ | 输出校正后的延迟分布,wrk2 的核心价值 | |
wrk2 -t4 -c100 -d30s -R2000 --u_latency http://example.com/ | 输出未校正延迟,用于对照观察协调遗漏的影响 | |
wrk2 -t2 -c50 -d10s -R500 http://example.com/api/health | 低速率冒烟,先确认链路与鉴权通 | |
wrk2 -t4 -c200 -d60s -R5000 --latency http://example.com/ | 较高目标速率的长时压测,-c 要同步放大 | |
wrk2 -t4 -c100 -d30s -R2000 --timeout 5s http://example.com/ | 调大请求超时,避免慢请求提前失败 | |
wrk2 -t4 -c100 -d1m -R3000 http://example.com/ | 时间支持 s/m/h 单位 | |
wrk2 -t4 -c2k -d30s -R5000 http://example.com/ | 数值支持 SI 单位,2k 即 2000 | |
wrk2 -t4 -c100 -d30s -R2000 -H "Host: example.com" http://10.0.0.5/ | 直连后端并带真实 Host,绕过 DNS 与负载均衡 | |
wrk2 -t4 -c100 -d30s -R2000 -H "Authorization: Bearer x" http://example.com/api | 带鉴权头压测受保护接口 | |
wrk2 -t4 -c100 -d30s -R2000 -H "Accept-Encoding: gzip" http://example.com/ | 验证压缩链路的速率与带宽表现 | |
wrk2 不指定 -R 会直接退出 | 与原版 wrk 最大的差异:没有目标速率就无法测校正延迟 | |
-R 通常按整体目标速率理解 | 多线程时工具内部按线程分摊,最终以输出的 Requests/sec 对照目标值 | |
wrk2 -t1 -c50 -d30s -R800 url | 单线程低速率验证客户端能否跟上节奏 |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
Running 30s test @ http://example.com/ | 确认目标 URL 与时长符合预期 | |
4 threads and 100 connections | 确认线程与连接数生效,连接不足会导致速率达不成 | |
Requests/sec: 1998.24 | 实际 QPS,与 -R 对比即达成率 | |
达成率 = Requests/sec ÷ 目标 R | 低于 95% 说明系统或压测机撑不到目标速率 | |
Latency Avg / Stdev / Max / +/- Stdev | 校正后的单请求延迟统计 | |
Latency Distribution 50% / 75% / 90% | 常规分位,看整体水平 | |
Latency Distribution 99% / 99.9% / 99.99% / 99.999% | wrk2 支持的高精度尾部,长尾问题主要看这里 | |
Socket errors: connect 0, read 0, write 0, timeout 0 | 任何非 0 都先排查,结果不可直接采信 | |
Non-2xx or 3xx responses: 0 | 业务层失败不计入 Socket errors,必须单独看 | |
Transfer/sec: 8.42MB | 实际吞吐带宽,判断是否撞到网卡上限 | |
--u_latency 的值通常明显更低 | 差值越大说明协调遗漏越严重,原版 wrk 的延迟越乐观 | |
校正延迟比未校正高 3 倍以上 | 说明压测期间存在明显排队,闭环工具在这会严重失真 | |
Max 出现异常高值 | 常见于首次连接、TLS 握手、DNS 解析或 GC 停顿 | |
Req/Sec 抖动明显 | 客户端调度或系统中断不均,检查核数与绑核 | |
+/- Stdev 很大 | 延迟分布离散,多为队列堆积或资源争抢 |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
for r in 500 1000 2000 4000 8000; do wrk2 -t4 -c200 -d30s -R$r --latency url | grep -E "Requests/sec|99%"; done | 速率阶梯,一轮拿到达成率与 P99 曲线 | |
从 500 RPS 起步逐级加 | 直接上高 R 会瞬间打满,拿不到中间拐点 | |
每级至少跑 30 秒 | 太短会被冷启动与 GC 周期干扰 | |
找达成率 ≥ 99% 且 P99 平稳的最大 R | 这个点就是当前配置的可持续容量 | |
Little 定律:-c ≈ R × 目标延迟(秒) | R=2000、目标 100ms 时至少要 200 个连接 | |
连接数不足的典型表现 | Requests/sec 上不去,客户端无明显瓶颈,Latency 却很高 | |
队列长度 ≈ R × (实测延迟 − 服务时间) | 用于估算积压请求数,判断是否已过载 | |
服务时间下限 ≈ 1 ÷ 单请求处理能力 | 结合 CPU 使用率判断是计算瓶颈还是 IO 瓶颈 | |
错误率随 R 上升的拐点 | 通常就是真实容量上限,比延迟拐点更早出现 | |
按 SLA 反推可承受 R | 例如 P99 ≤ 200ms 下最多能跑多少 RPS,才是业务要的结论 | |
单点结论不可信 | 阶梯至少 5 个点,并重复一轮确认可复现 |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
wrk2 -t4 -c100 -d30s -R2000 -s script.lua http://example.com/ | 加载 Lua 脚本,实现参数化与自定义统计 | |
wrk.method = "POST" | 脚本内设置请求方法 | |
wrk.body = '{"k":"v"}' | 设置请求体,JSON 场景记得配 Content-Type | |
wrk.headers["Content-Type"] = "application/json" | 脚本内设置请求头 | |
wrk.path = "/api/item/" .. math.random(1, 10000) | 动态路径,避免命中同一份缓存 | |
function request()
return wrk.format(nil, wrk.path)
end | 每次请求重新构造,注意拼接开销会影响速率达成 | |
function init(args)
print("extra arg:", args[1])
end | init 每线程调用一次,可用于读取文件与环境变量 | |
function setup(thread)
thread:set("shard", tid)
end | setup 用于给不同线程分发不同参数 | |
function done(summary, latency, requests)
print("p999:", latency:percentile(99.9))
end | done 在主线程收尾,可自定义报告输出 | |
local f = io.open("result.txt", "a")
f:write(latency:percentile(99.9), "\n")
f:close() | 把关键指标写入文件,便于 CI 采集 | |
summary.errors.connect / read / write / timeout / status | 分类错误计数,区分网络与业务失败 | |
local token = os.getenv("TOKEN") | 读取环境变量,避免 token 硬编码进脚本 | |
math.randomseed(os.time() + tid) | 按线程播种,保证随机结果可复现 | |
脚本里 print 走 stderr | 重定向输出时用 2>&1 一并捕获 | |
request() 里不要做耗时计算 | 客户端生成请求过慢会直接拉低达成率 |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
wrk 是闭环压测 | 固定连接数,能压多快压多快,延迟统计存在协调遗漏 | |
wrk2 是开环恒定速率 | 按 -R 匀速发压,更能暴露排队与长尾 | |
wrk2 默认校正延迟 | 基于 HdrHistogram 把被"压不出来"的排队时间补回统计 | |
k6 run --vus 100 --duration 30s script.js | k6 用 constant-arrival-rate 执行器也能做恒定速率 | |
k6 配置 constant-arrival-rate: rate=2000, timeUnit=1s | 现代替代方案,维护活跃、可编排场景 | |
vegeta attack -rate=2000 -duration=30s -targets=t.txt | 恒定速率压测,输出可直接生成图表 | |
h2load -n 10000 -c 100 -m 10 https://example.com/ | 需要 HTTP/2 时用 h2load | |
ab 单线程闭环 | 只适合快速冒烟,不适合容量结论 | |
wrk2 维护不活跃 | 新项目建议 k6,既有脚本可继续用 wrk2 | |
wrk2 不支持 HTTP/2 | gRPC 与 HTTP/2 场景换工具 | |
闭环工具报的延迟偏低不等于错 | 它反映的是"在满负荷下"的样本,缺少超时请求的时间补偿 |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
wrk2 -t4 -c100 -d30s -R2000 --latency url > r2000.log | 单轮归档,文件名带速率值 | |
wrk2 ... 2>&1 | tee -a bench.log | Lua print 走 stderr,需合并捕获 | |
grep -E "Requests/sec|99.9%" bench.log | 提取达成率与尾部延迟 | |
diff <(grep "Requests/sec" before.log) <(grep "Requests/sec" after.log) | 调优前后只比对关键指标 | |
for r in 1000 2000 4000; do wrk2 -t4 -c200 -d30s -R$r --latency url > r$r.log; done | 批量生成阶梯结果文件 | |
awk '/Requests\/sec/ {print $2}' r2000.log | 取数值做汇总表 | |
报告至少包含 R、达成率、P50/P99/P99.9、错误数 | 只写一个 QPS 无法说明系统健康度 | |
记录实例规格与版本 | 压测结论必须能复现,否则无法作为容量依据 | |
保存 --u_latency 与 --latency 两份结果 | 便于说明校正前后的差异幅度 |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
ulimit -n 65535 | 高并发与高速率下先提高句柄上限 | |
sysctl -w net.ipv4.ip_local_port_range="1024 65535" | 扩大本地端口范围,减少 connect 失败 | |
sysctl -w net.core.somaxconn=4096 | 配合服务端 backlog 调整 | |
ss -s | 观察连接总数与 TIME_WAIT 堆积 | |
ss -tn state established | wc -l | 确认实际连接数是否达到 -c | |
sar -n DEV 1 | 观察压测机与目标机网卡是否打满 | |
top -H -p $(pgrep -f nginx) | 服务端线程级 CPU,识别单核跑满 | |
mpstat -P ALL 1 | 观察各核负载是否均衡,避免单核成为瓶颈 | |
taskset -c 0-3 wrk2 -t4 ... | 绑定 CPU 核,减少调度抖动带来的速率偏差 | |
压测机与服务端分开部署 | 同机会互相抢 CPU 与带宽,结论不可信 | |
高速率下单机可能不够 | R 达到数万时改用多台压测机并聚合结果 | |
确保 NTP 时间同步 | 跨机对照日志与指标时,时间偏差会误导排查 |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
先低 R 预热 30 秒 | 避开 JIT、连接池、缓存冷启动对结果的干扰 | |
速率阶梯升压,不跳级 | 每次提升不超过 2 倍,才能观察到拐点 | |
同时观察服务端指标 | 只看压测输出容易把客户端瓶颈误判成服务端问题 | |
缓存场景加随机参数 | 固定 URL 会命中 CDN 或本地缓存,结果虚高 | |
生产环境默认不压测 | 必须压测时走审批、限流与可回滚方案 | |
单次压测时长 ≥ 30 秒 | 太短会被 GC 周期与连接建立阶段主导 | |
关注 P99.9 而不是平均值 | wrk2 的价值就在于把长尾测准 | |
达成率优先于延迟数字 | 没跑到目标速率时,延迟分布本身没有参考意义 | |
固定变量再优化 | 版本、规格、网络、缓存状态都要记录并保持不变 | |
长尾排查看 GC、锁与连接池 | 多数 P99 恶化来自资源争抢或后端串行化 | |
压测后回归同参数复测 | 确认优化真实有效,而不是噪声波动 |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
wrk2 必须指定 -R | 漏掉目标速率会直接退出,只打印 usage | |
unable to connect to example.com: Connection refused | 端口未监听或被防火墙拦截 | |
Socket errors: connect N | 本地端口耗尽或服务端 backlog 满,扩端口并加 somaxconn | |
Socket errors: read / write 非 0 | 连接被重置,多为限流、连接池耗尽或主动断连 | |
Socket errors: timeout 非 0 | 请求超时,用 --timeout 调大并排查慢接口 | |
Non-2xx or 3xx responses 大量 | 业务失败,检查鉴权、限流与上游依赖 | |
Requests/sec 远低于 -R 且无错误 | 先看客户端 CPU 与连接数是否足够,再看服务端 | |
Requests/sec 远低于 -R 且有大量错误 | 系统已过载,降低 R 重新找拐点 | |
error loading script: script.lua: ... | Lua 语法错误,按行号修正 | |
attempt to index a nil value | wrk.headers 未初始化或访问了不存在的字段 | |
undefined symbol: SSL_new | 编译缺 OpenSSL,装 libssl-dev 后 make clean 重编 | |
LuaJIT 在新版 gcc 下编译失败 | 换仓库 tag、降 gcc 或改用预编译二进制 | |
wrk2: command not found | 未改名或不在 PATH,确认 /usr/local/bin 中的文件名 | |
误把 wrk 当 wrk2 使用 | 原版 wrk 没有 -R,会直接报未知参数 | |
Latency 出现秒级异常值 | 首次 TLS 握手或 DNS 解析,先预热再统计 | |
高 R 下速率抖动明显 | 客户端调度精度不足,减少线程或绑核重试 | |
不同机器结果差异大 | 压测机规格、内核参数与网络路径不同,需统一环境 | |
结果与网关侧统计不一致 | 中间有 CDN、限流或采样,核对统计口径与时间窗 |
运维常用组合
wrk2 -t4 -c200 -d30s -R1000 --latency url > r1000.log → 确认达成率 → 记录 P50/P99/P99.9for r in 500 1000 2000 4000 8000; do wrk2 -t4 -c400 -d30s -R$r --latency url | grep -E "Requests/sec|99.9%"; done同一速率分别跑 wrk2 --latency 与 --u_latency → 比较 P99 差值 → 差值大说明闭环压测的延迟不可信post.lua 设置 wrk.method/body/headers → wrk2 -t4 -c200 -d30s -R1000 -s post.lua -H "Authorization: Bearer x" url调优前 wrk2 ... -R2000 --latency > before.log → 改配置 → 同参数 > after.log → diff 达成率与 P99.9确定目标 R 与 P99 阈值 → wrk2 长时 60s 压测 → 达成率 ≥99% 且 P99 达标才通过实战要点
1. 必须给 -R
wrk2 是开环恒定速率工具,没有目标速率就失去了校正延迟的意义
2. 先看达成率再谈延迟
实际 QPS 明显低于 -R 时,延迟分布已经失真,应先降 R 重测
3. 连接数按 Little 定律估
-c ≈ R × 目标延迟,连接不足会人为制造排队
4. 校正与未校正都留档
--latency 与 --u_latency 的差值,就是协调遗漏的严重程度
5. 阶梯升压找拐点
容量不是一个点而是曲线,至少 5 个速率点才能说明问题
6. 看 P99.9 而不是平均
wrk2 的价值就是高精度尾部,平均值会掩盖真实故障
相关工具
Linux命令速查
文件、文本、权限、进程、网络、磁盘、systemd与防火墙等 Linux 常用命令速查手册
Docker命令速查
镜像、容器、网络、数据卷、Compose、Swarm、清理与排障等 Docker 常用命令速查手册
Nginx命令速查
服务管理、配置指令、反向代理、HTTPS、限流缓存、日志排查等 Nginx 常用命令速查手册
K8S命令速查
集群上下文、Pod调试、工作负载、Service与Ingress、存储、权限、排障等 kubectl 常用命令速查手册
Windows CMD命令速查
文件目录、网络诊断、进程服务、系统信息、用户权限、注册表、批处理等 Windows CMD 常用命令速查手册
systemctl服务管理速查
服务启停、开机自启、unit文件编写、日志查看、定时器、依赖分析与排障等 systemctl 命令速查手册
关于wrk2命令速查
在线 wrk2 命令速查手册,按安装与编译、基础压测、结果字段解读、速率阶梯与容量评估、Lua 脚本、与 wrk/k6 等工具对比、输出采集与对比、系统调优与观测、压测方法与注意事项、常见报错与排查等 10 类场景整理 120 余条常用命令、脚本片段与参数组合,每条附中文说明与可直接复制的写法,支持关键词搜索、分类折叠和一键复制,打开网页即可查阅。涵盖 git clone https://github.com/giltene/wrk2 与 make 编译与 build-essential/libssl-dev 依赖与二进制改名 wrk2 与 -v 版本、-R 恒定速率(开环)与 -t 线程数 与 -c 连接数 与 -d 持续时间 与 --latency 校正延迟分布 与 --u_latency 未校正延迟 与 --timeout 超时 与 -H 自定义请求头 与 -s Lua 脚本 与 SI 单位 1k/1M,以及协调遗漏(coordinated omission)原理与 HdrHistogram 校正机制、Requests/sec 与目标 -R 的达成率判断、Latency Distribution 的 50%/75%/90%/99%/99.9%/99.99%/99.999% 高精度分位、Socket errors 与 Non-2xx 统计、Little 定律估算 -c = R × 目标延迟、速率阶梯(500 → 1000 → 2000 → 4000 → 8000)寻找最大可持续 QPS 拐点、开环压测与 wrk/ab 闭环压测的本质差异、k6 constant-arrival-rate 与 vegeta/h2load/JMeter 的替代与互补、ulimit -n 与端口范围与 somaxconn 与 ss -s 与 sar -n DEV 与 top -H 的压测机观测,还有必须指定 -R、Connection refused、Socket errors connect(本地端口耗尽)、read/write/timeout 错误、Non-2xx 大量出现、error loading script、attempt to index a nil value、undefined symbol SSL_new、LuaJIT 在新 gcc 下编译失败、命令找不到、达成率远低于目标、延迟异常高值 等报错排查。适用于恒定到达率下的真实延迟测量、容量与 SLA 验证、协调遗漏导致的乐观延迟问题诊断、网关与后端服务性能对比、压测报告与回归基线采集,以及运维、测试与后端工程师面试复习。
核心能力
- 涵盖 git clone https://github.com/giltene/wrk2 与 make 编译与 build-essential/libssl-dev 依赖与二进制改名 wrk2 与 -v 版本、-R 恒定速率(开环)与 -t 线程数 与 -c 连接数 与 -d 持续时间 与 --latency 校正延迟分布 与 --u_latency 未校正延迟 与 --timeout 超时 与 -H 自定义请求头 与 -s Lua 脚本 与 SI 单位 1k/1M,以及协调遗漏(coordinated omission)原理与 HdrHistogram 校正机制、Requests/sec 与目标 -R 的达成率判断、Latency Distribution 的 50%/75%/90%/99%/99.9%/99.99%/99.999% 高精度分位、Socket errors 与 Non-2xx 统计、Little 定律估算 -c = R × 目标延迟、速率阶梯(500 → 1000 → 2000 → 4000 → 8000)寻找最大可持续 QPS 拐点、开环压测与 wrk/ab 闭环压测的本质差异、k6 constant-arrival-rate 与 vegeta/h2load/JMeter 的替代与互补、ulimit -n 与端口范围与 somaxconn 与 ss -s 与 sar -n DEV 与 top -H 的压测机观测,还有必须指定 -R、Connection refused、Socket errors connect(本地端口耗尽)、read/write/timeout 错误、Non-2xx 大量出现、error loading script、attempt to index a nil value、undefined symbol SSL_new、LuaJIT 在新 gcc 下编译失败、命令找不到、达成率远低于目标、延迟异常高值 等报错排查
适用场景
适用于恒定到达率下的真实延迟测量、容量与 SLA 验证、协调遗漏导致的乐观延迟问题诊断、网关与后端服务性能对比、压测报告与回归基线采集,以及运维、测试与后端工程师面试复习。wrk2命令速查全程在浏览器中完成,无需安装插件,可放心用于日常办公与排障。
常见问题
- wrk2命令速查是免费的吗?需要注册或安装吗?
- wrk2命令速查完全免费,无需注册、无需下载安装任何软件,用浏览器打开网页即可直接使用,也不限制使用次数。
- wrk2命令速查支持哪些功能?
- 涵盖 git clone https://github.com/giltene/wrk2 与 make 编译与 build-essential/libssl-dev 依赖与二进制改名 wrk2 与 -v 版本、-R 恒定速率(开环)与 -t 线程数 与 -c 连接数 与 -d 持续时间 与 --latency 校正延迟分布 与 --u_latency 未校正延迟 与 --timeout 超时 与 -H 自定义请求头 与 -s Lua 脚本 与 SI 单位 1k/1M,以及协调遗漏(coordinated omission)原理与 HdrHistogram 校正机制、Requests/sec 与目标 -R 的达成率判断、Latency Distribution 的 50%/75%/90%/99%/99.9%/99.99%/99.999% 高精度分位、Socket errors 与 Non-2xx 统计、Little 定律估算 -c = R × 目标延迟、速率阶梯(500 → 1000 → 2000 → 4000 → 8000)寻找最大可持续 QPS 拐点、开环压测与 wrk/ab 闭环压测的本质差异、k6 constant-arrival-rate 与 vegeta/h2load/JMeter 的替代与互补、ulimit -n 与端口范围与 somaxconn 与 ss -s 与 sar -n DEV 与 top -H 的压测机观测,还有必须指定 -R、Connection refused、Socket errors connect(本地端口耗尽)、read/write/timeout 错误、Non-2xx 大量出现、error loading script、attempt to index a nil value、undefined symbol SSL_new、LuaJIT 在新 gcc 下编译失败、命令找不到、达成率远低于目标、延迟异常高值 等报错排查。
- wrk2命令速查适合哪些场景使用?
- 适用于恒定到达率下的真实延迟测量、容量与 SLA 验证、协调遗漏导致的乐观延迟问题诊断、网关与后端服务性能对比、压测报告与回归基线采集,以及运维、测试与后端工程师面试复习。