Locust接口性能测试

Locust接口性能测试全解析
原创 于 2025-08-14 15:01:59 发布 · 807 阅读 · 8 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#职场和发展 #软件测试 #功能测试 #自动化测试

谈到性能测试工具，我们首先想到的是LoadRunner或JMeter。LoadRunner是非常有名的商业性能测试工具，功能非常强大。但现在一般不推荐使用该工具来进行性能测试，主要是使用也较为复杂，而且该工具体积比较大，需要付费且价格不便宜。

JMeter同样是非常有名的开源性能测试工具，功能也很完善，我们之前介绍了它作为接口测试工具的使用。

Locust同样是性能测试工具，虽然官方这样来描述它：“An open source load testing tool.”，但它和前面两个工具有一些不同。

Locust简介

Locust完全基于Python编程语言，采用纯 Python描述测试脚本，并且HTTP请求完全基于Requests库。除了HTTP/HTTPS协议外，Locust还可以测试其他协议的系统，只需采用Python调用对应的库进行请求描述即可。

LoadRunner和JMeter这类采用进程和线程的测试工具，都很难在单机上模拟出较高的并发压力。Locust的并发机制摒弃了进程和线程，采用协程（gevent）的机制。协程避免了系统级资源调度，因此可以大幅提高单机的并发能力。

下载安装

官网地址：https://www.locust.io

使用pip命令安装Locust：

pip install locustio

安装完成之后检测是否安装成功：

C:\Users\Shuqing>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'.

Default: locustfile

....

测试案例

测试场景

针对如下两个接口进行性能测试：

http://127.0.0.1:8000/users/

http://127.0.0.1:8000/groups/

以上两个接口也就是我们之前项目django_restful的接口

负载场景

  • 每秒生成2个用户，总共生成60个用户。
  • 负载测试5分钟然后查看接口的平均响应时间。
脚本实现

restful_api_locust.py

from locust import HttpLocust,TaskSet,task


class UserBehavior(TaskSet):


@task(2)

def test_users(self):

self.client.get("/users/",auth=('51zxw','zxw20182018'))



@task(1)

def test_groups(self):

self.client.get("/groups/",auth=('51zxw','zxw20182018'))



class WebsiteUser(HttpLocust):

task_set = UserBehavior

min_wait = 3000

max_wait = 6000

UserBehavior类继承TaskSet类，用于描述用户行为。

  • @task装饰该方法为一个事务,后面的数字表示请求比例，上面的比例为2:1 默认都是1:1
  • test_users()方法表示一个用户行为，这里是请求user接口。
  • test_groups()方法表示请求group接口。
  • client.get()用于指定请求的路径。

WebsiteUser类用于设置性能测试。

  • task_set：指向一个定义的用户行为类。
  • min_wait：执行事务之间用户等待时间的下界（单位：毫秒）。
  • max_wait：执行事务之间用户等待时间的上界（单位：毫秒）。
执行测试

使用如下命令开始启动测试

C:\Users\Shuqing>locust -f D:\api_test\locust\restful_api_locust.py --host=http://127.0.0.1:8000

[2018-07-24 15:39:22,917] LAPTOP-8B5JADC8/INFO/locust.main: Starting web monitor at *:8089

[2018-07-24 15:39:22,917] LAPTOP-8B5JADC8/INFO/locust.main: Starting Locust 0.8.1

在浏览器打开localhost:8089可以看到如下页面：

  • Number of users to simulate：设置模拟用户数。
  • Hatch rate（users spawned/second）：每秒产生（启动）的虚拟用户数。
  • 单击“Start swarming”按钮，开始运行性能测试

运行之后可以看到主界面如下：

性能测试参数如下。

  • Type：请求的类型，例如GET/POST。
  • Name：请求的路径。
  • request：当前请求的数量。
  • fails：当前请求失败的数量。
  • Median：中间值，单位毫秒，一半的服务器响应时间低于该值，而另一半高于该值。
  • Average：平均值，单位毫秒，所有请求的平均响应时间。
  • Min：请求的最小服务器响应时间，单位毫秒。
  • Max：请求的最大服务器响应时间，单位毫秒。
  • Content Size：单个请求的大小，单位字节。
  • reqs/sec：每秒钟请求的个数。

点击 Charts 菜单可以查看性能图表

图表含义如下：

  • Total Request per Second ：每秒的请求数
  • Average Response Time: 平均响应时间
  • Number of Users: 用户数

参数化

测试场景

如果想对如下接口进行并发测试，则可以将id进行参数化设置

http://127.0.0.1:8000/groups/1/

http://127.0.0.1:8000/groups/2/

http://127.0.0.1:8000/users/1/

http://127.0.0.1:8000/users/2/
代码实现

locust_users_groups.py


from locust import HttpLocust,TaskSet,task


class UserBehavior(TaskSet):


def on_start(self):

#设置user和group参数下标初始值

self.users_index=0

self.groups_index=0


@task

def test_users(self):

#读取参数

users_id=self.locust.id[self.users_index]

url="/users/"+str(users_id)+'/'

self.client.get(url,auth=('51zxw','zxw20182018'))

#取余运算循环遍历参数

self.users_index=(self.users_index+1)%len(self.locust.id)


@task

def test_groups(self):

#参数化

groups_id=self.locust.id[self.groups_index]

url="/groups/"+str(groups_id)+"/"

self.client.get(url,auth=('51zxw','zxw20182018'))

self.groups_index=(self.groups_index+1)%len(self.locust.id)


class WebsiteUser(HttpLocust):

task_set = UserBehavior

#参数配置

id=[1,2]

min_wait = 3000

max_wait = 6000

#host配置

host = 'http://127.0.0.1:8000'
运行结果

执行如下命令即可运行测试

C:\Users\Shuqing>locust -f D:\api_test\locust\locust_users_groups.py

运行模式

no-web运行

前面是通过登录web来运行测试的，其实也可以非web状态来运行,如cmd命令来运行。如果需要非Web形式运行，则需使用--no-web参数，并会用到如下几个参数。

  • -c, --clients：指定并发用户数；
  • -r, --hatch-rate：指定并发加压速率，默认值位1。
  • -t, --run-time：设置运行时间。如(300s,20m, 3h, 1h30m等）；

运行命令如下：

locust -f D:\api_test\locust\locust_users_groups.py --no-web -c 10 -r 2 -t 15s

运行结果如下：

C:\Users\Shuqing>locust -f D:\api_test\locust\locust_users_groups.py --no-web -c 10 -r 2 -t 15s

[2018-08-21 10:12:59,017] LAPTOP-8B5JADC8/INFO/locust.main: Run time limit set to 15 seconds

[2018-08-21 10:12:59,017] LAPTOP-8B5JADC8/INFO/locust.main: Starting Locust 0.8

[2018-08-21 10:12:59,018] LAPTOP-8B5JADC8/INFO/locust.runners: Hatching and swarming 10 clients at the rate 2 clients/s...

Name # reqs # fails Avg Min Max | Median req/s

--------------------------------------------------------------------------------------------------------------------------------------------

--------------------------------------------------------------------------------------------------------------------------------------------

Total 0 0(0.00%) 0.00


Name # reqs # fails Avg Min Max | Median req/s

--------------------------------------------------------------------------------------------------------------------------------------------

GET /groups/1/ 2 0(0.00%) 134 122 146 | 120 0.00

GET /users/1/ 2 0(0.00%) 118 100 136 | 100 0.00

--------------------------------------------------------------------------------------------------------------------------------------------

Total 4 0(0.00%) 0.00


Name # reqs # fails Avg Min Max | Median req/s

--------------------------------------------------------------------------------------------------------------------------------------------

GET /groups/1/ 4 0(0.00%) 135 122 146 | 130 1.00

GET /users/1/ 4 0(0.00%) 115 100 136 | 100 1.00

--------------------------------------------------------------------------------------------------------------------------------------------

Total 8 0(0.00%) 2.00


[2018-08-21 10:13:04,034] LAPTOP-8B5JADC8/INFO/locust.runners: All locusts hatched: WebsiteUser: 10

[2018-08-21 10:13:04,034] LAPTOP-8B5JADC8/INFO/locust.runners: Resetting stats


Name # reqs # fails Avg Min Max | Median req/s

--------------------------------------------------------------------------------------------------------------------------------------------

GET /groups/1/ 1 0(0.00%) 147 147 147 | 150 0.00

GET /users/1/ 2 0(0.00%) 110 92 128 | 92 0.00

GET /users/2/ 1 0(0.00%) 102 102 102 | 100 0.00

--------------------------------------------------------------------------------------------------------------------------------------------

Total 4 0(0.00%) 0.00


Name # reqs # fails Avg Min Max | Median req/s

--------------------------------------------------------------------------------------------------------------------------------------------

GET /groups/1/ 3 0(0.00%) 129 101 147 | 140 0.00

GET /users/1/ 3 0(0.00%) 108 92 128 | 100 0.00

GET /users/2/ 1 0(0.00%) 102 102 102 | 100 0.00

--------------------------------------------------------------------------------------------------------------------------------------------

Total 7 0(0.00%) 0.00


Name # reqs # fails Avg Min Max | Median req/s

--------------------------------------------------------------------------------------------------------------------------------------------

GET /groups/1/ 4 0(0.00%) 125 101 147 | 110 1.00

GET /groups/2/ 2 0(0.00%) 136 116 156 | 120 0.00

GET /users/1/ 3 0(0.00%) 108 92 128 | 100 1.00

GET /users/2/ 2 0(0.00%) 102 102 102 | 100 0.33

--------------------------------------------------------------------------------------------------------------------------------------------

Total 11 0(0.00%) 2.33


Name # reqs # fails Avg Min Max | Median req/s

--------------------------------------------------------------------------------------------------------------------------------------------

GET /groups/1/ 5 0(0.00%) 123 101 147 | 120 0.75

GET /groups/2/ 3 0(0.00%) 124 100 156 | 120 0.50

GET /users/1/ 3 0(0.00%) 108 92 128 | 100 0.75

GET /users/2/ 4 0(0.00%) 114 102 153 | 100 0.25

--------------------------------------------------------------------------------------------------------------------------------------------

Total 15 0(0.00%) 2.25


Name # reqs # fails Avg Min Max | Median req/s

--------------------------------------------------------------------------------------------------------------------------------------------

GET /groups/1/ 6 0(0.00%) 128 101 157 | 120 0.67

GET /groups/2/ 5 0(0.00%) 127 100 156 | 120 0.33

GET /users/1/ 4 0(0.00%) 108 92 128 | 100 0.50

GET /users/2/ 5 0(0.00%) 121 102 153 | 100 0.50

--------------------------------------------------------------------------------------------------------------------------------------------

Total 20 0(0.00%) 2.00


[2018-08-21 10:13:13,691] LAPTOP-8B5JADC8/INFO/locust.main: Time limit reached. Stopping Locust.

[2018-08-21 10:13:13,693] LAPTOP-8B5JADC8/INFO/locust.main: Shutting down (exit code 0), bye.

Name # reqs # fails Avg Min Max | Median req/s

--------------------------------------------------------------------------------------------------------------------------------------------

GET /groups/1/ 6 0(0.00%) 128 101 157 | 120 0.67

GET /groups/2/ 5 0(0.00%) 127 100 156 | 120 0.33

GET /users/1/ 4 0(0.00%) 108 92 128 | 100 0.50

GET /users/2/ 5 0(0.00%) 121 102 153 | 100 0.50

--------------------------------------------------------------------------------------------------------------------------------------------

Total 20 0(0.00%) 2.00


Percentage of the requests completed within given times

Name # reqs 50% 66% 75% 80% 90% 95% 98% 99% 100%

--------------------------------------------------------------------------------------------------------------------------------------------

GET /groups/1/ 6 140 140 150 150 160 160 160 160 157

GET /groups/2/ 5 120 150 150 160 160 160 160 160 156

GET /users/1/ 4 110 110 130 130 130 130 130 130 128

GET /users/2/ 5 100 150 150 150 150 150 150 150 153

--------------------------------------------------------------------------------------------------------------------------------------------

Total 20 120 140 150 150 160 160 160 160 157
分布式运行

上面我们都是单台机器来执行性能测试，但是当单台机器不够模拟足够多的用户时，Locust支持运行在多台机器中进行压力测试。分布式运行一般是一台master 多台slave 如下图所示：

首先定义一台 master

C:\Users\Shuqing>locust -f D:\api_test\locust\locust_users_groups.py --master

然后定义 slave

C:\Users\Shuqing>locust -f D:\api_test\locust\locust_users_groups.py  --slave

如果slave与master不在同一台机器上，还需要通过--master-host参数再指定master的IP地址。

C:\Users\Shuqing>locust -f D:\api_test\locust\locust_users_groups.py --slave --master-host <master_ip>

运行之后可以看到web界面显示的SLAVES数量

最后： 下方这份完整的软件测试视频教程已经整理上传完成，需要的朋友们可以自行领取【保证100%免费】

​​​软件测试面试文档

我们学习必然是为了找到高薪的工作，下面这些面试题是来自阿里、腾讯、字节等一线互联网大厂最新的面试资料，并且有字节大佬给出了权威的解答，刷完这一套面试资料相信大家都能找到满意的工作。

在这里插入图片描述

在这里插入图片描述

locust性能测试
Eddision的博客
10-29 535
本文以python3为例 1-环境 电脑上要安装有pip的环境,可参考我环境配置的文章 python安装和环境配置_Eddision的博客-CSDN博客 安装pyzmq 如果打算让locust分布在多个进程中，可以把pyzmq安装上 pip installpyzmq 安装locust python3以上需要到git下载locust GitHub - locustio/locust: Scalable user load testing tool written in Python 下载..
Locust性能测试
记录小白的成长之路
05-15 1732
文章目录python、Locust性能测试Locust是什么？Locust特点Locust安装Locust性能测试脚本任务集TaskSet类首页接口用户类HttpLocust运行性能测试脚本登录接口参数化数据放在程序list数组内步骤:数据放在文件内步骤:参数的上下关联步骤:分布式压测分布式压测的原理:在同一台电脑上运行多个slave:在不同的电脑上运行多个slave python、Locust性能测试 Locust是什么？ Locust翻译成中文就是蝗虫的意思，就像蝗虫一样对系统发起成千上万的请求。以测试
聊聊Locust常见参数及常用代码
最新发布
奇峰卧虎
08-13 536
Locust性能测试参数与代码详解的详细说明，涵盖命令行参数、代码配置、分布式测试及结果分析等内容。
Python Locust性能测试框架实践
aab438346的博客
10-22 1783
[本文出自天外归云的博客园] Locust的介绍 Locust是一个python的性能测试工具，你可以通过写python脚本的方式来对web接口进行负载测试。 Locust的安装 首先你要安装python2.6以上版本，而且有pip工具。之后打开命令行，分别安装locustio和pyzmq（命令如下）： pip install locustio pip install p...
Locust 接口性能测试（一）
热门推荐
xgh1951的博客
05-30 1万+
Locust是使用Python开发的支持分布式的一款开源压力测试工具，Locust在测试时，会产生大量的用户对系统进行访问，每个用户的行为是通过Python代码控制的，并且整个测试过程可以在Web的UI界面实时观察测试数据。然后我又把用户数设置为1000，每秒启动20，但是，但是，，此时，我司的后台管理系统就挂掉了，我了割草啊，吓死我了。安装的过程中会安装其他一些依赖的库，不要慌张，安装结束如上图，查看是否安装可以用 locust -h 来验证，当现实各种命令就是安装成功了！好了，这次的练习就到此为止吧！
Locust接口性能测试_python locust 接口性能
2501_90404942的博客
01-27 889
参数配置id=[1,2]#host配置。
使用Locust进行接口性能测试：Locust and TaskSet类详细分析_locust 报告接口
2401_84562425的博客
05-10 535
…wait_time = between(1, 3) # 设置任务执行的等待时间范围# 使用between函数，每个用户等待1到3秒之间的随机时间。
Locust web性能测试实践
lldhsds的专栏
06-14 1133
单机模式适用于简单的小规模测试。分布式模式适用于大规模测试，通过多个 worker 节点协同工作来模拟大量并发用户。无头模式适用于自动化测试和持续集成环境，可以在没有图形界面的情况下运行测试并输出结果。
【性能测试】使用locust进行接口的性能测试(一）
黑黑白白君的博客
07-31 2129
前置知识： 《【性能测试】性能测试基础》 《【接口测试实战(零)】接口测试简介》 文章目录1）接口性能测试1.1常见指标：QPS（Queries Per Second，每秒查询率）：*QPS VS. TPSRT（Reaction Time，响应时间）：并发数（系统同时处理的request/事务数）：资源利用率：2）Locust入门级使用2.1 Locust是什么2.2 Locust的安装2.3 写一个locust脚本HttpUser类验证响应：创建请求： 1）接口性能测试 1.1常见指标： QPS（
分布式性能测试-通篇讲解 Locust 性能测试
lixiemang8887的博客
08-26 1088
单机模式：使用-processes启动多个进程。多机模式：在 Master 上启动负载测试，并在每个 Worker 上启动 Worker 实例。：简化分布式负载生成的启动，并解决网络/防火墙问题。节点间通信：使用消息钩子在 Master 和 Worker 节点间传递信息。通过这些配置和工具，可以高效地进行大规模并发负载测试，帮助你评估系统的性能和稳定性。特殊的消息通信：如果需要在 Master 和 Worker 之间进行特定的自定义消息交换，可以使用 Locust 提供的消息机制进行扩展。
Httprunner_Locust性能测试
01-09
目录 1.安装性能测试工具Locust 1.1查看是否安装，执行命令 1.2安装locust  2.运行性能测试 2.1第一次尝试 2.2排查问题的N次尝试，直至成功 3.多进程运行模式 1.安装性能测试工具Locust 1.1查看是否安装，执行命令  locusts -V  如下图提示，则说明目前还没有被安装 1.2安装locust  pip install locustio 成功安装后，会提示： 执行 locusts -h，可查看到帮助文档。 2.运行性能测试 2.1第一次尝试 -f 可以直接执行.yml文件，执行过程包括生成对应的py文件和启动locust，我在执行过程中，报了一条
使用Locust进行性能测试
路漫漫其修远
05-31 1480
开篇 最近因为某些不可抗拒因素:-D,不能在公司使用Loadrunner,找了一下开源的性能测试工具,决定使用Locust. 什么是Locust Locust是一种易于使用的、分布式的、用户负载测试工具。它的目的是对web站点(或其他系统)做性能测试，并确定系统能够处理多少并发用户。 Locust可以在测试过程中，模拟大量Locust实例会访问目标网站。每个Locust(测试用户)的行为是由自己定义的，并且可以从一个web UI中实时监控着这些进程。 服务端性能测试工具最核心的部分是压力发生器，..
性能测试工具Locust
auo67284的博客
02-10 237
使用Python代码来定义用户行为。用它可以模拟百万计的并发用户访问你的系统。 Locust安装 1、安装Python： 官方：https://www.python.org/ 安装Python2 或Python3 2、安装Locuse 2.1， 通过pip命令安装 /> pip install locustio 2.2， 通过GitH...
性能测试工具-Locust
MRJJ_9的博客
06-28 2346
性能测试工具选择
性能测试-locust
chenlifeng8816的博客
12-05 193
既然是测试开发，就肯定要写代码才行啊。loadrunner,robot framework都是写配置文件啊。 物理环境安装locust,pip3 install locust。 开发的时候如果使用虚拟环境，就在虚拟环境下安装locust。 官方的demo，这里把登陆和登出给改...
Locust性能测试教程
weixin_45246215的博客
04-13 4715
提到性能测试，大部分小伙伴想到的就是LR和jmeter这种工具，小编一直不太喜欢写这种工具类的东西，我的原则是能用代码解决的问题，尽量不去用工具。python里面也有一个性能测试框架Locust，本篇简单的介绍Locust的基本使用环境准备：python3.6windows电脑locustLocust是一款易于使用的分布式用户负载测试工具。它用于对网站（或其他系统）进行负载测试，并确定系统可以处理多少并发用户。这个想法是，在测试期间，一群蝗虫（Locust）会攻击你的网站。
locust简单接口性能测试实战
12-27
### 使用Locust进行简单接口性能测试 #### 安装Locust 要开始使用Locust，需先确保已安装此工具。可以通过pip命令轻松完成安装： ```bash pip install locust ``` 确认安装成功后，可通过`pip show locust`查看版本信息[^1]。 #### 编写测试脚本 创建一个新的Python文件作为测试脚本来模拟用户行为。对于HTTP API的性能测试来说，主要关注点在于发送请求到服务器并记录响应时间和其他重要指标。下面是一个简单的例子展示如何针对特定URL发起GET请求来进行压力测试: ```python from locust import HttpUser, between, task class WebsiteUser(HttpUser): wait_time = between(1, 5) @task def index(self): self.client.get("/") @task def about_page(self): self.client.get("/about") ``` 这段代码定义了一个名为`WebsiteUser`的类继承自`HttpUser`, 表示每个虚拟用户的动作序列。这里设置了两个任务方法分别访问网站根路径和关于页面。注意引入了随机等待时间间隔以更贴近真实世界中的浏览模式[^2]。 如果希望调整各个任务发生的频率比例，则可以在装饰器中指定参数值，如下所示： ```python @task(3) def more_frequent_task(self): pass @task(1) def less_frequent_task(self): pass ``` 这表示前者被调用的概率大约是后者三倍[^5]。 #### 启动Locust服务端程序 保存上述脚本之后，在终端输入以下指令启动Locust Web UI (默认监听8089端口): ```bash locust -f path_to_your_script.py ``` 打开浏览器导航至 `http://localhost:8089/` 即可看到图形化操作界面，在那里能够设定并发数、持续时间和其它选项来控制整个压测过程。 #### 运行测试与分析结果 一旦配置完毕点击“Start swarming”，就开始正式执行预先编写的场景描述逻辑；与此同时，实时统计图表会动态更新反映当前系统的吞吐量、平均响应延迟等关键性能数据。当达到预期目的或发现问题所在时停止实验，并依据收集的数据做出相应优化措施[^3]。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值