性能测试工具locustio

0.382字数 1472阅读 1321

locustio

什么是locustio?

Locust是易于使用、分布式的用户负载测试工具。用于网站(或其他系统)的负载测试,计算出系统可以处理并发用户数。

测试时大量蝗虫会攻击你的网站。每只蝗虫(或叫测试用户)可以自定义、测试过程由web界面实时监控。这能帮助测试并确定瓶颈。

Locust 完全基于的事件,单机可以支持数千用户。它不使用回调,而是基于轻量进程gevent, 能简单地实线各种场景。

image.png

特点

  • 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 --help
Usage: 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, task

class 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 = 9000

HttpLocust继承自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",提交执行测试。

图片.png

这时在浏览器就可以看到实时的测试结果。点击浏览器上方的"stop”即可停止测试。

图片.png
  • 查看报告:

命令行按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.30

Percentage 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 MobileUserLocust

weight标识执行比例,这里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

推荐阅读更多精彩内容