GeekIt

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]) endinit 每线程调用一次,可用于读取文件与环境变量
function setup(thread) thread:set("shard", tid) endsetup 用于给不同线程分发不同参数
function done(summary, latency, requests) print("p999:", latency:percentile(99.9)) enddone 在主线程收尾,可自定义报告输出
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.jsk6 用 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/2gRPC 与 HTTP/2 场景换工具
闭环工具报的延迟偏低不等于错它反映的是"在满负荷下"的样本,缺少超时请求的时间补偿
命令 / 片段说明复制
wrk2 -t4 -c100 -d30s -R2000 --latency url > r2000.log单轮归档,文件名带速率值
wrk2 ... 2>&1 | tee -a bench.logLua 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 valuewrk.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.9
容量阶梯for 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 接口压测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
SLA 验证确定目标 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 的价值就是高精度尾部,平均值会掩盖真实故障

共 126 条 wrk2 命令 · 示例中的域名、速率与脚本路径请替换为实际环境

关于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 验证、协调遗漏导致的乐观延迟问题诊断、网关与后端服务性能对比、压测报告与回归基线采集,以及运维、测试与后端工程师面试复习。