linux下wrk的安装
wrk是linux下开源的性能测试工具,并且只能在linux下运行,下面介绍下安装教程(以ubantu18.04环境为例):
1.预先安装git,如:apt install git
2.从git上拉取wrk:git clone https://github.com/wg/wrk.git wrk
3.cd wrk
4.apt-get install build-essential -y
5.make
6.把生成的 wrk 移到一个 PATH 目录下面, 比如 : sudo cp wrk /usr/local/bin
注意编译的时间可能比较长,耐心等待即可
CentOs/RedHat/Fedora 下的安装:
-
sudo yum groupinstall 'Development Tools'
-
sudo yum install openssl-devel
-
sudo yum install git
-
git clone https://github.com/wg/wrk.git wrk
-
cd wrk
-
make
-
# 把生成的 wrk 移到一个 PATH 目录下面, 比如
-
sudo cp wrk /usr/local/bin
mac 下快捷安装:
brew install wrk
基本使用:
wrk -t12 -c400 -d30s http://127.0.0.1:8080/index.html
使用 12 个线程运行 30 秒, 400 个 http 并发
命令行选项
-
使用方法: wrk <选项> <被测HTTP服务的URL>
-
Options:
-
-c, --connections <N> 跟服务器建立并保持的 TCP 连接数量
-
-d, --duration <T> 压测时间
-
-t, --threads <N> 使用多少个线程进行压测
-
-s, --script <S> 指定 Lua 脚本路径
-
-H, --header <H> 为每一个 HTTP 请求添加 HTTP 头
-
--latency 在压测结束后,打印延迟统计信息
-
--timeout <T> 超时时间
-
-v, --version 打印正在使用的 wrk 的详细版本信息
-
-
<N>代表数字参数,支持国际单位 (1k, 1M, 1G)
-
<T>代表时间参数,支持时间单位 (2s, 2m, 2h)
做一次简单压测,分析下结果:
-
wrk -t8 -c200 -d30s --latency "http://www.bing.com"
-
-
输出:
-
Running 30s test @ http://www.bing.com
-
8 threads and 200 connections
-
Thread Stats Avg Stdev Max +/- Stdev
-
Latency 46.67ms 215.38ms 1.67s 95.59%
-
Req/Sec 7.91k 1.15k 10.26k 70.77%
-
Latency Distribution
-
50% 2.93ms
-
75% 3.78ms
-
90% 4.73ms
-
99% 1.35s
-
1790465 requests in 30.01s, 684.08MB read
-
Requests/sec: 59658.29
-
Transfer/sec: 22.79MB
以上使用 8 个线程 200 个连接,对 bing 首页进行了 30 秒的压测,并要求在压测结果中输出响应延迟信息。以下对压测结果进行简单注释:
-
Running 30s test @ http://www.bing.com (压测时间30s)
-
8 threads and 200 connections (共8个测试线程,200个连接)
-
Thread Stats Avg Stdev Max +/- Stdev
-
(平均值) (标准差)(最大值)(正负一个标准差所占比例)
-
Latency 46.67ms 215.38ms 1.67s 95.59%
-
(延迟)
-
Req/Sec 7.91k 1.15k 10.26k 70.77%
-
(处理中的请求数)
-
Latency Distribution (延迟分布)
-
50% 2.93ms
-
75% 3.78ms
-
90% 4.73ms
-
99% 1.35s (99分位的延迟)
-
1790465 requests in 30.01s, 684.08MB read (30.01秒内共处理完成了1790465个请求,读取了684.08MB数据)
-
Requests/sec: 59658.29 (平均每秒处理完成59658.29个请求)
-
Transfer/sec: 22.79MB (平均每秒读取数据22.79MB)
可以看到,wrk 使用方便,结果清晰。并且因为非阻塞 IO 的使用,可以在普通的测试机上创建出大量的连接,从而达到较好的压测效果。
lua脚本压测
在基本压测中, 每次发送的请求都是一样的,很多时候我们压测的请求体是每个请求都不一样, 这时候就要写lua基本来压测
使用 POST 方法压测
-
wrk.method = "POST"
-
wrk.body = "foo=bar&baz=quux"
-
wrk.headers["Content-Type"] = "application/x-www-form-urlencoded"
wrk -t2 -d30s -c1k -s xxx.lua http://192.168.17.1/
每个 request 的参数都不一样
-
request = function()
-
uid = math.random(1, 10000000)
-
path = "/test?uid=" .. uid
-
return wrk.format(nil, path)
-
end
解释一下 wrk.format 这个函数
-
wrk.format 这个函数的作用,根据参数和全局变量 wrk 生成一个 http 请求
-
函数签名: function wrk.format(method, path, headers, body)
-
method:http方法,比如GET/POST等
-
path: url上的路径(含函数)
-
headers: http header
-
body: http body
每个线程先登录然后压测
-
token = nil
-
path = "/authenticate"
-
-
request = function()
-
return wrk.format("GET", path)
-
end
-
-
response = function(status, headers, body)
-
if not token and status == 200 then
-
token = headers["X-Token"]
-
path = "/resource"
-
wrk.headers["X-Token"] = token
-
end
-
end
发送 json
-
request = function()
-
local headers = { }
-
headers['Content-Type'] = "application/json"
-
body = {
-
mobile={"1533899828"},
-
params={code=math.random(1000,9999)}
-
}
-
-
local cjson = require("cjson")
-
body_str = cjson.encode(body)
-
return wrk.format('POST', nil, headers, body_str)
-
end
若运行的时候报错找不到cjson, 可以安装 luarocks install lua-cjson
wrk lua脚本说明
wrk 压测脚本有3个生命周期, 分别是 启动阶段,运行阶段和结束阶段,每个线程都有自己的lua运行环境
启动阶段
-
function setup(thread)
-
在脚本文件中实现setup方法,wrk就会在测试线程已经初始化但还没有启动的时候调用该方法。wrk会为每一个测试线程调用一次setup方法,并传入代表测试线程的对象thread作为参数。setup方法中可操作该thread对象,获取信息、存储信息、甚至关闭该线程。
-
-- thread提供了1个属性,3个方法
-
-- thread.addr 设置请求需要打到的ip
-
-- thread:get(name) 获取线程全局变量
-
-- thread:set(name, value) 设置线程全局变量
-
-- thread:stop() 终止线程
运行阶段
-
function init(args)
-
-- 每个线程仅调用1次,args 用于获取命令行中传入的参数, 例如 --env=pre
-
-
function delay()
-
-- 每次请求调用1次,发送下一个请求之前的延迟, 单位为ms
-
-
function request()
-
-- 每次请求调用1次,返回http请求
-
-
function response(status, headers, body)
-
-- 每次请求调用1次,返回 http 响应
init由测试线程调用,只会在进入运行阶段时,调用一次。支持从启动wrk的命令中,获取命令行参数;
delay在每次发送request之前调用,如果需要delay,那么delay相应时间; request用来生成请求;
每一次请求都会调用该方法,所以注意不要在该方法中做耗时的操作; reponse在每次收到一个响应时调用;
为提升性能,如果没有定义该方法,那么wrk不会解析headers和body; 结束阶段
结束阶段
-
function done(summary, latency, requests)
-
-
latency.min -- minimum value seen
-
latency.max -- maximum value seen
-
latency.mean -- average value seen
-
latency.stdev -- standard deviation
-
latency:percentile(99.0) -- 99th percentile value
-
latency(i) -- raw value and count
-
-
summary = {
-
duration = N, -- run duration in microseconds
-
requests = N, -- total completed requests
-
bytes = N, -- total bytes received
-
errors = {
-
connect = N, -- total socket connection errors
-
read = N, -- total socket read errors
-
write = N, -- total socket write errors
-
status = N, -- total HTTP status codes > 399
-
timeout = N -- total request timeouts
-
}
-
}
该方法在整个测试过程中只会调用一次,可从参数给定的对象中,获取压测结果,生成定制化的测试报告。
线程变量
-
wrk = {
-
scheme = "http",
-
host = "localhost",
-
port = nil,
-
method = "GET",
-
path = "/",
-
headers = {},
-
body = nil,
-
thread = <userdata>,
-
}
-
-
-- 生成整个request的string,例如:返回
-
-- GET / HTTP/1.1
-
-- Host: tool.lu
-
function wrk.format(method, path, headers, body)
-
-- method: http方法, 如GET/POST/DELETE 等
-
-- path: url的路径, 如 /index, /index?a=b&c=d
-
-- headers: 一个header的table
-
-- body: 一个http body, 字符串类型
-
-
-- 获取域名的IP和端口,返回table,例如:返回 `{127.0.0.1:80}`
-
function wrk.lookup(host, service)
-
-- host:一个主机名或者地址串(IPv4的点分十进制串或者IPv6的16进制串)
-
-- service:服务名可以是十进制的端口号,也可以是已定义的服务名称,如ftp、http等
-
-
-- 判断addr是否能连接,例如:`127.0.0.1:80`,返回 true 或 false
-
function wrk.connect(addr)