locustio
什么是locustio？
Locust是易于使用、分布式的用户负载测试工具。用于网站(或其他系统)的负载测试，计算出系统可以处理并发用户数。
测试时大量蝗虫会攻击你的网站。每只蝗虫(或叫测试用户)可以自定义、测试过程由web界面实时监控。这能帮助测试并确定瓶颈。
Locust 完全基于的事件，单机可以支持数千用户。它不使用回调，而是基于轻量进程gevent, 能简单地实线各种场景。
特点
- Python书写场景
无需笨重的UI或XML。仅仅是代码，协程而不是回调。
分布式，可扩展和，支持成千上万的用户
基于Web的用户界面
Locust有整洁HTML + JS用户界面，实时展示测试细节，跨平台和易于扩展。
可以测试任何系统
可控制
事件完全由gevent处理。
背景
我们研究了现有的解决方案，都不符合要求。比如Apache JMeter和Tsung。JMeter基于UI操作，容易上手，但基本上不具备编程能力。其次JMeter基于线程，要模拟数千用户几乎不可能。 Tsung基于Erlang，能模拟上千用户并易于扩展，但它它基于XML的DSL，描述场景能力弱，且需要大量的数据处理才知道测试结果。
无论如何，我们试图解决创建Locust，当这些问题。希望以上都不是painpoints应该存在。
我想你可以说我们真的只是想在这里从头开始自己的痒。我们希望其他人会发现，因为我们做的是有益的。
作者
Jonatan Heyman (@jonatanheyman on Twitter)
Carl Byström (@cgbystrom on Twitter)
Joakim Hamrén (@Jahaaja on Twitter)
Hugo Heyman (@hugoheyman on Twitter)
License: MIT
安装
安装：”pip install locustio”或者”easy_install locustio”
检验：
执行”locust –help”能看到如下信息表示安装成功：
# locust --helpUsage: locust [options] [LocustClass [LocustClass2 ... ]]Options: -h, --help show this help message and exit -H HOST, --host=HOST Host to load test in the following format: http://10.21.32.33 --web-host=WEB_HOST Host to bind the web interface to. Defaults to '' (all interfaces) -P PORT, --port=PORT, --web-port=PORT Port on which to run web host -f LOCUSTFILE, --locustfile=LOCUSTFILE Python module file to import, e.g. '../other.py'....分布式测试需要安装pyzmq。尽管locustio可以在Windows运行，但是考虑效率不推荐
快速入门
编写脚本
from locust import HttpLocust, TaskSet, taskclass UserBehavior(TaskSet): def on_start(self): """ on_start is called when a Locust start before any task is scheduled """ self.login() def login(self): pass @task(2) def index(self): self.client.get("/") @task(1) def profile(self): self.client.get("/address.html")class WebsiteUser(HttpLocust): task_set = UserBehavior min_wait = 5000 max_wait = 9000HttpLocust继承自Locust，添加了client属性。client属性是HttpSession实例，可以用于生成HTTP请求。
on_start为client初始化时执行的步骤。
task表示下面方法是测试内容，里面的数字执行比例，这里about页面占三分之一，主页占三分之二。
task_set指定client执行的类。min_wait和max_wait为两次执行之间的最小和最长等待时间。
启动
- 启动locust后台
$ locust --host=https://china-testing.github.io/- 在浏览器启动locust
打开http://127.0.0.1:8089/，配置模拟的用户数”Number of users to simulate”和每秒发起的用户数”Hatch rate”，提交执行测试。
这时在浏览器就可以看到实时的测试结果。点击浏览器上方的”stop”即可停止测试。
- 查看报告：
命令行按Ctrl + c , 可以显示一些摘要
$ locust --host=https://china-testing.github.io/[2018-07-23 10:37:39,801] andrew-PowerEdge-T630/INFO/locust.main: Starting web monitor at *:8089[2018-07-23 10:37:39,801] andrew-PowerEdge-T630/INFO/locust.main: Starting Locust 0.8.1[2018-07-23 10:37:49,083] andrew-PowerEdge-T630/INFO/locust.runners: Hatching and swarming 10 clients at the rate 20 clients/s...[2018-07-23 10:37:49,587] andrew-PowerEdge-T630/INFO/locust.runners: All locusts hatched: WebsiteUser: 10[2018-07-23 10:37:49,587] andrew-PowerEdge-T630/INFO/locust.runners: Resetting stats^C[2018-07-23 10:38:32,875] andrew-PowerEdge-T630/ERROR/stderr: KeyboardInterrupt[2018-07-23 10:38:32,876] andrew-PowerEdge-T630/ERROR/stderr: 2018-07-23T02:38:32Z[2018-07-23 10:38:32,876] andrew-PowerEdge-T630/ERROR/stderr: [2018-07-23 10:38:32,876] andrew-PowerEdge-T630/INFO/locust.main: Shutting down (exit code 0), bye. Name # reqs # fails Avg Min Max | Median req/s-------------------------------------------------------------------------------------------------------------------------------------------- GET // 42 0(0.00%) 460 279 1978 | 320 1.00 GET //address.html 20 0(0.00%) 475 268 1116 | 280 0.30-------------------------------------------------------------------------------------------------------------------------------------------- Total 62 0(0.00%) 1.30Percentage of the requests completed within given times Name # reqs 50% 66% 75% 80% 90% 95% 98% 99% 100%-------------------------------------------------------------------------------------------------------------------------------------------- GET // 42 320 330 340 410 1100 1200 2000 2000 1978 GET //address.html 20 280 300 870 1100 1100 1100 1100 1100 1116--------------------------------------------------------------------------------------------------------------------------------------------网页上可以下载csv文件，一个是调配记录，一个是请求记录。
# cat distribution_1431074713.45.csv "Name","# requests","50%","66%","75%","80%","90%","95%","98%","99%","100%""GET /",36,250,260,260,270,370,400,410,410,411"GET /about",17,170,180,180,200,290,520,520,520,519"None Total",53,250,250,260,260,310,400,410,520,519# cat requests_1431074710.05.csv "Method","Name","# requests","# failures","Median response time","Average response time","Min response time","Max response time","Average Content Size","Requests/s""GET","/",36,0,250,260,206,411,9055,0.76"GET","/about",17,0,170,199,146,519,4456,0.36"None","Total",53,0,250,241,146,519,7579,1.12- 其他：
指定测试文件启动：locust -f ../locust_files/my_locust_file.py –host=http://example.com
分布式测试时作为主测试机：locust -f ../locust_files/my_locust_file.py –master –host=http://example.com
分布式测试时作为从测试机：locust -f ../locust_files/my_locust_file.py –slave –master-host=192.168.0.100 –host=http://example.com。master-host的默认值是127.0.0.1。
locustfile
locustfile需要定义至少一个locust类。
Locust类
locust类代表用户。属性如下：
- task_set属性
task_set属性指向定义了用户的行为的TaskSet类。
- min_wait和max_wait属性
两次执行之间的最小和最长等待时间，单位：毫秒，即执行各任务之间等待时间。默认为1000，并且因此蝗虫永远等待1秒各任务之间如果min_wait和MAX_WAIT未声明。
用下面locustfile，每个用户将等待任务之间5到15秒：
- weight属性
可以同时执行同一文件的多个locust：
# locust -f locust_file.py WebUserLocust MobileUserLocustweight标识执行比例，这里WebUserLocust的执行次数3倍于MobileUserLocust：
class WebUserLocust(Locust): weight = 3 ....class MobileUserLocust(Locust): weight = 1 ....- host属性
URL的前缀（如”http://automationtesting.sinaapp.com”）。通常在命令行使用–host选项指定。也可以设置host属性，在命令行没有指定时作为默认值。
TaskSet类
TaskSet表示任务的集合。任务可以嵌套，比如：
Main user behaviour
Watch movie
Filter movies
Read thread
New thread
View next page
Reply
Index page
Forum page
Browse categories
About page
嵌套的python代码示例：
class ForumPage(TaskSet): @task(20) def read_thread(self): pass @task(1) def new_thread(self): pass @task(5) def stop(self): self.interrupt()class UserBehaviour(TaskSet): tasks = {ForumPage:10} @task def index(self): pass</pre>类嵌套示例：
class MyTaskSet(TaskSet): @task class SubTaskSet(TaskSet): @task def my_task(self): pass</pre>HTTP请求
HttpLocust继承自Locust，添加了client属性。client属性是HttpSession实例，调用了requests，可以用于生成HTTP请求。 self.client设置了属性指向 self.locust.client。
get 和post示例：
# getresponse = self.client.get("/about")print "Response status code:", response.status_codeprint "Response content:", response.content# postresponse = self.client.post("/login", {"username":"testuser", "password":"secret"})</pre>注意失败的任何请求如连接错误，超时等不产生异常，而是返回None，status_code是0。
默认只要返回的不是2都是失败。也可以设置失败和成功：
with client.get("/", catch_response=True) as response: if response.content != "Success": response.failure("Got wrong response")with client.get("/does_not_exist/", catch_response=True) as response: if response.status_code == 404: response.success()</pre>动态参数：
# Statistics for these requests will be grouped under: /blog/?id=[id]for i in range(10): client.get("/blog?id=%i" % i, name="/blog?id=[id]")</pre>分布式测试
主机使用–master，它不会模拟任何用户。实际测试机需要–slave和–master-host参数。通常一个cpu核可以执行一个从机。
master的参数还有: “–master-bind-host=X.X.X.X”和–master-bind-host=X.X.X.X。
从机的参数有：”–master-port=5557″。
参考资料
- 讨论qq群144081101 591302926 567351477 钉钉免费群21745728
- 本文涉及的python测试开发库 请在github上点赞，谢谢！
- 本文相关书籍下载
- locustio英文文档
文章标题：性能测试工具locustio
文章版权：SBKKO 所发布的内容，部分为原创文章，转载请注明来源，网络转载文章如有侵权请联系我们！
