安装
locust 官方介绍https://locust.io/
① 可以直接通过pip安装,安装命令
pip install locustio
可能出现的问题:可能出现gcc编译失败等问题,可以先pip安装zmq
② 通过源码安装
备注:在gcc 4.8+以上版本使用源码安装。下载locust-master代码
安装顺序:
python setup.py build
python setup.py install
如果locust有依赖安装失败,可用pip安装缺失依赖。例:pip安装zmq,pip install zmq
验证是否安装成功:locust --help
③ 安装的Q&A
· 注意locust 的版本和python版本是否匹配,可以查看locust的setup.py 中的说明。目前已知0.11 /0.9支持python2.7
· locust可以启动压测脚本,web页面不能操作、没有趋势图。排查flask是否安装成功:import flask
启动方式
单进程运行
no_web方式
可以使用Locust的单进程no_web运行模式进行本地脚本调试。启动方式:locust -f test.py --no-web -c 1
参数讲解:-f 启动的文件, --no-web 非web方式启动 -c 指定并发数 -n 总执行次数
web方式
如果采用web形式,,则通常情况下无需指定其它额外参数,Locust默认采用8089端口启动web。如果使用其他端口,需要使用如下参数进行指定
-P, --port:指定web端口,默认为8089
locust -f test.py -P 8098 --web-host=127.0.0.1 --only-summary
启动的时候注意指定--web-host,防止出现绑定异常
按照如上方式启动后,case并没有执行,通过暴露的web服务127.0.0.1:8098 访问webUI,配置参数
Number of users to simulate: 设置并发用户数,对应中no_web模式的-c, --clients参数;
Hatch rate (users spawned/second): 启动虚拟用户的速率,对应着no_web模式的-r, --hatch-rate参数。
多进程分布式运行
当并发压力要求较高时,就需要用到Locust的多进程分布式运行模式。从字面意思上看,第一反应就是多台压力机同时运行,每台压力机分担负载一部分的压力生成。的确,Locust支持任意多台压力机(一主多从)的分布式运行模式,但这里说到的多进程分布式运行模式还有另外一种情况,就是在同一台压力机上开启多个slave的情况。这是因为当前阶段大多数计算机的CPU都是多处理器(multiple processor cores),单进程运行模式下只能用到一个处理器的能力,而通过在一台压力机上运行多个slave,就能调用多个处理器的能力了。比较好的做法是,如果一台压力机有N个处理器内核,那么就在这台压力机上启动一个master,N个slave。当然,我们也可以启动N的倍数个slave,但是根据试验数据,效果跟N个差不多,因此只需要启动N个slave即可。
master启动方式
locust -f test.py -P 8098 --web-host=10.10.10.10 --master : 没有特殊指定--master-bind-port默认为5557
slave启动方式
locust -f test.py --slave --master-host=10.10.10.10 :没有特殊指定 --master-port 默认为5557
master和slave都启动完毕后,就可以在浏览器中通过http://locust_machine_ip:8089进入Locust的Web管理页面了。使用方式跟单进程web形式完全相同,只是此时是通过多进程负载来生成并发压力,在web管理界面中也能看到实际的slave数量。
locust相关
Locust
可以理解为用户,用户的行为由taskset指定。大家可以基于locust基类实现继承类的用户,比如:httpLocust就是基于Locust派生而来,并指定了它的client = httpSession
属性介绍:
max_wait= 1000 : 执行task最大等待时间
min_wait= 1000 :执行task最小等待时间
task_set= None : locust执行的task类
weight= 10:locust被挑选的权重
HttpLocust
基于Locust派生的http user,底层的client为httpSession(基于python.requests实现)。HTTP的类压测可直接用HttpLocust
TaskSet
Locust User执行的task列表,属性解释:
max_wait= None :task最大执行间隔,默认不设置,如果设置了将覆盖locust中的max_wait
min_wait= None:task最小执行间隔,默认不设置,如果设置了将覆盖locust中的max_wait
tasks = [] :task列表
on_start:方法,执行tasks之前执行的方法,只执行一次,可以作为初始化使用
如何写TaskSet
① 通过tasks指定执行权重
from locust import HttpLocust, TaskSet
deflogin(l):
l.client.post("/login", {"username":"ellen_key", "password":"education"})
def index(l):
l.client.get("/")
def profile(l):
l.client.get("/profile")
class UserBehavior(TaskSet):
tasks ={index: 2, profile: 1}#注意这一行,后面数字为执行比例
def on_start(self):
login(self)
② 通过装饰器权重、执行顺序
from locust import HttpLocust, TaskSet
def login(l):
l.client.post("/login", {"username":"ellen_key", "password":"education"})
class UserBehavior(TaskSet):
def on_start(self):
login(self)
@task(2)
@seq_task(1)
def index(self):
self.client.get("/")
@task(1)
@seq_task(2)
def profile(l):
l.client.get("/profile")
@task 是权重装饰器,index:profile的执行比例是2:1
@seq_task为顺序装饰器,tasks按照如上先index、后profile的顺序进行
Event hooks
为了进行数据统计,用户可以自己定义成功、失败、异常相关的事件统计。目前支持的可用hooks见https://docs.locust.io/en/stable/api.html#available-hooks
以request_success 为例进行说明如何使用
request_success=
request_success is fired when a request is completed successfully.
Listeners should take the following arguments:
request_type: Request type method used
name: Path to the URL that was called (or override name if it was used in the call to the client)
response_time: Response time in milliseconds
response_length: Content-length of the response
当你认为task中某个请求成功,可以直接通过events.request_success.fire进行记录,参数即为如上描述。
由于Locust类和TaskSet类有多种setup/teardown相互依赖,下面是这些类的执行顺序,方便理解:
Locust setup
TaskSet setup
TaskSet on_start
TaskSet tasks…
TaskSet on_stop
TaskSet teardown
Locust teardown
附录
深入浅出开源性能测试工具 Locust https://debugtalk.com/post/head-first-locust-user-guide/
locust官方文档https://docs.locust.io/en/stable/
gevent 猴子补丁http://www.gevent.org/api/gevent.monkey.html
dumeter locust的帮助文档Locust测试