一个基础的locust压测框架,可以拿过来在这个框架基础上进行二次开发
Repo ljxpython/locust_framework, read from GitHub 1 min ago. ljxpython has not joined Take My Repo.
ljxpython/locust_framework is a public repo on GitHub by ljxpython. 一个基础的locust压测框架,可以拿过来在这个框架基础上进行二次开发. It declares no license on GitHub. Public does not mean open source: without a license, nobody is granted the right to reuse it. It is written mainly in Python, has 16 stars and last changed on 2025-08-29. Nobody has reviewed it on Take My Repo yet, which says nothing about its quality. Read from GitHub on 2026-11-20.
In the maintainer's words. Shown from GitHub; Take My Repo does not keep a copy.
🎯 企业级性能测试解决方案 - 基于Locust框架的二次开发,支持分层架构、松耦合、高内聚的设计原则
一个功能强大、易于扩展的性能测试框架,专为现代化测试需求而设计。框架采用插件化架构,支持多种负载模式、实时监控、智能分析和多渠道告警,让性能测试变得更加简单高效。
# 克隆项目 git clone git@github.com:ljxpython/locust_framework.git cd locust_framework # 创建虚拟环境 python -m venv venv source venv/bin/activate # Linux/Mac # 或 venv\Scripts\activate # Windows # 安装依赖 pip install -r requirements.txt
# locustfiles/quickstart.py from locust import HttpUser, task from src.utils.locust_report import manual_report class QuickStartUser(HttpUser): host = "https://httpbin.org" @task def test_get(self): with manual_report("GET请求测试"): self.client.get("/get") @task(2) # 权重为2 def test_post(self): with manual_report("POST请求测试"): self.client.post("/post", json={"key": "value"})
# 使用Make命令(推荐) make run-web script=locustfiles/quickstart.py # 或使用原生Locust命令 locust -f locustfiles/quickstart.py
访问Web界面
无头模式测试
# 快速执行 make run script=locustfiles/quickstart.py u=10 r=2 t=60s # 完整参数 locust -f locustfiles/quickstart.py --headless -u 10 -r 2 -t 60s --html=reports/report.html
locust_framework/
├── 📁 conf/ # 配置文件
│ ├── config.py # 配置管理
│ ├── constants.py # 常量定义
│ └── settings.yaml # 主配置文件
├── 📁 docs/ # 文档系统
│ ├── getting-started/ # 入门指南
│ ├── architecture/ # 架构文档
│ ├── api/ # API参考
│ ├── development/ # 开发指南
│ ├── examples/ # 使用示例
│ └── configuration/ # 配置参考
├── 📁 locustfiles/ # 测试脚本
│ ├── demo.py # 示例脚本
│ ├── shape_classes/ # 负载形状类
│ └── test_*/ # 测试场景目录
├── 📁 src/ # 核心源码
│ ├── analysis/ # 性能分析模块
│ ├── monitoring/ # 监控告警模块
│ ├── data_manager/ # 数据管理模块
│ ├── plugins/ # 插件系统
│ ├── notifications/ # 通知服务
│ ├── load_shapes/ # 负载形状
│ ├── client/ # 客户端封装
│ ├── model/ # 数据模型
│ └── utils/ # 工具模块
├── 📁 reports/ # 测试报告
├── 📁 logs/ # 日志文件
├── main.py # 主程序入口
├── requirements.txt # 依赖列表
└── README.md # 项目说明
框架支持灵活的参数传递和配置管理,让测试更加可控和可配置。
核心特性:
loop_num后自动停止压测rendezvous_num基于多维度指标的智能分析系统,提供专业的性能评估。
分析维度:
实时监控和智能告警,确保问题及时发现和处理。
支持渠道:
支持7种内置负载模式,满足不同测试场景需求。
负载模式:
强大的插件系统,支持功能扩展和定制化开发。
插件类型:
天然支持分布式部署,轻松应对大规模性能测试需求。
分布式特性:
基于locust框架进行二次开发: https://locust.io/
主要封装完善功能如下:
- 集合点
- 自定义事务
- 自定义参数
- 测试数据的动态获取及编排(可支持分布式的资源编排)
- 压测报告优化
- 优雅的停止压测
- 第三方调用(该框架已经接入到作者自己开发的测试平台中)
- 自动告警(支持邮件\飞书\钉钉群等消息上报)
- 一些其他小的优化项
框架支持多种测试执行方式,满足不同场景需求:
# 使用Make命令启动 make run-web script=locustfiles/demo.py # 或使用原生Locust命令 locust -f locustfiles/demo.py
特点:
# 快速执行 make run script=locustfiles/demo.py u=10 r=2 t=60s # 完整参数执行 locust -f locustfiles/demo.py --headless \ --users 10 --spawn-rate 2 --run-time 60s \ --html=reports/report.html \ --csv=reports/results
特点:
# 启动Master节点 locust -f locustfiles/demo.py --master # 启动Worker节点 locust -f locustfiles/demo.py --worker --master-host=<master-ip> # 多进程Worker locust -f locustfiles/demo.py --worker --processes 4
特点:
框架提供强大的参数化能力,支持灵活的测试配置:
@events.init_command_line_parser.add_listener def _(parser): parser.add_argument("--product_id", type=str, default="1925511528732168192", help="测试业务ID") parser.add_argument("--loop_num", type=int, default=1, help="执行轮数") parser.add_argument("--is_rendezvous", type=str_to_bool, default=False, help="是否使用集合点") parser.add_argument("--rendezvous_num", type=int, default=1, help="集合点数量")
class WebsiteUser(HttpUser): @task def my_task(self): # 获取自定义参数 loop_num = self.environment.parsed_options.loop_num product_id = self.environment.parsed_options.product_id # 使用集合点 if self.environment.parsed_options.is_rendezvous: with self.environment.shared: # 并发执行的业务逻辑 self.client.get(f"/api/product/{product_id}")
框架提供智能的性能分析和丰富的报告功能:
# conf/settings.yaml monitoring: alerts: response_time: warning: 1000 # 1秒警告 critical: 3000 # 3秒严重 error_rate: warning: 5 # 5%警告 critical: 10 # 10%严重 throughput: warning: 100 # 低于100 TPS警告
notifications: feishu: webhook_url: "https://open.feishu.cn/open-apis/bot/v2/hook/xxx" enabled: true dingtalk: webhook_url: "https://oapi.dingtalk.com/robot/send?access_token=xxx" enabled: true email: smtp_server: "smtp.gmail.com" smtp_port: 587 enabled: true
框架支持多种负载模式,模拟真实的用户行为:
# 在测试脚本中继承负载形状类 from locustfiles.shape_classes.wave_shape import WaveLoadShape class MyTestUser(HttpUser): # 测试逻辑 pass # 使用命令行选择负载形状 locust -f test.py --class-picker WaveLoadShape
# conf/settings.yaml plugins: enabled: - performance_analyzer - system_monitor - notification_service - data_manager
from src.plugins.base import BasePlugin class MyCustomPlugin(BasePlugin): def on_test_start(self, environment, **kwargs): # 测试开始时的逻辑 pass def on_test_stop(self, environment, **kwargs): # 测试结束时的逻辑 pass
框架支持灵活的参数传递和配置管理:
loop_num后自动停止压测rendezvous_num基于多维度指标的智能分析系统:
实时监控和智能告警系统:
支持7种内置负载模式:
天然支持分布式部署:
.
├── README.md
├── conf
│ ├── config.py
│ ├── constants.py
│ ├── settings.local.yaml
│ └── settings.yaml
├── docs
│ └── pics
│ └── img.png
├── locustfiles
│ ├── demo.py
│ ├── shape_classes
│ │ └── __init__.py
│ ├── test.py
│ ├── test_demo
│ │ └── test_good.py
│ └── test_user
│ ├── __init__.py
│ ├── __pycache__
│ │ └── test_user.cpython-312.pyc
│ └── test_user.py
├── logs
│ └── test.log
├── main.py
├── poetry.lock
├── pyproject.toml
├── reports
├── requirements.txt
├── src
│ ├── client
│ │ ├── __init__.py
│ │ └── demo_client
│ │ ├── flask_auth.py
│ │ ├── flask_client.py
│ │ └── response.py
│ ├── model
│ │ ├── __init__.py
│ │ ├── __pycache__
│ │ │ ├── locust_test.cpython-312.pyc
│ │ │ └── modelsbase.cpython-312.pyc
│ │ ├── auto_pytest.py
│ │ ├── locust_test.py
│ │ └── modelsbase.py
│ └── utils
│ ├── __init__.py
│ ├── file_operation.py
│ ├── locust_report.py
│ ├── log_moudle.py
│ ├── rendezvous.py
│ ├── robot.py
│ └── util.py
├── stop_locust.py
└── stop_locust.sh
loop_num后自动停止压测rendezvous_num@events.init_command_line_parser.add_listener
def _(parser):
parser.add_argument("--product_id", type=str, env_var="product_id", default="1925511528732168192", help="测试业务")
parser.add_argument("--node_num", type=int, env_var="node_num", default=1, help="测试的node数量")
parser.add_argument("--pod_num", type=int, env_var="pod_num", default=1, help="测试的pod数量")
parser.add_argument("--loop_num", type=int, env_var="loop_num", default=1, help="执行的轮数")
parser.add_argument("--is_rendezvous", type=str_to_bool,default=False, help="是否使用集合点")
parser.add_argument("--rendezvous_num", type=int, env_var="rendezvous_num", default=1, help="集合点的数量")
使用self.environment.parsed_options.xxxx 的方式调用
class WebsiteUser(HttpUser):
host = "127.0.0.1"
@task
def my_task(self):
global num
num += 1
time.sleep(1)
loop_num = self.environment.parsed_options.loop_num
# 集合点
if self.environment.parsed_options.is_rendezvous:
with self.environment.shared:
print('业务逻辑')
# 当达到指定轮数后停止
if loop_num < num:
self.environment.runner.quit() # 强制停止所有虚拟用户
make run script=locustfiles/xxxx.py u=2 r=1 is_rendezvous=false loop_num=10
locust -f locustfiles/cubelinux/xxxx.py --headless \
--product_id 0 \
--loop_num 10 \
--rendezvous_num 0 \
--is_rendezvous false \
--csv=logs/xxx \
--html=logs/locustfiles/xxxx.html \
-u 2 -r 1 -t 5m -s 100
make run-web script=locustfiles/xxxx.py u=2 r=1 is_rendezvous=false loop_num=10
locust -f locustfiles/cubelinux/xxxx.py \
-u 2 -r 1 -t 5m -s 100
前端选择参数
可以在web页面选择压测场景的及其权重
可以在web页面选择自定义变量
make run-web script=locustfiles/xxxx.py u=2 r=1 is_rendezvous=false loop_num=10
locust -f locustfiles/cubelinux/xxxx.py \
-u 2 -r 1 -t 5m -s 100
压测权重需预先标注,通过--xxx xxx的方式填写自定义变量
make run script=locustfiles/xxxx.py u=2 r=1 is_rendezvous=false loop_num=10
locust -f locustfiles/cubelinux/xxxx.py --headless \
--product_id 0 \
--loop_num 10 \
--rendezvous_num 0 \
--is_rendezvous false \
--csv=logs/xxx \
--html=logs/locustfiles/xxxx.html \
-u 2 -r 1 -t 5m -s 100
当压测的量级比较大时,一台开发机或者单线程不能满足需求,就需要多线程多开发机配合了,这方面locust天然支持,就不需要我进行二次封装了,方式如下:
这一步是必须的,之后让其他的woker节点加入
locust -f locustfile.py --master
processes 参数代表开启的进程数
# 同一服务器加入
locust -f - --worker --processes 4
# 其他开发机
locust -f - --worker --processes 1 --master-host 127.0.0.1
这里只提到了如何运行分布式压测,但是对于分布式压测变量如何管理,数据如何分配,因为篇幅太长,我并没有做介绍,感兴趣的可以查阅我博客的相关章节
不需要考虑并发应该如何设计,只需要考虑单个user的代码逻辑编排,可以像接口测试一样,只关注接口的参数化\接口间关联传参\断言的处理
接口一般有同步接口和异步接口,对于异步接口,封装了轮训功能,可以定期轮训查询异步完成的功能
断言部分,支持常用的接口状态断言,响应结果断言,熟悉断言使用的方法后,可大大减轻脚本编写工作者的开发时间
from src.utils.locust_report import manual_report, measure
class WebsiteUser(HttpUser):
host = "127.0.0.1"
@task
def my_task(self):
with manual_report("my_task"):
time.sleep(1)
# 如果使用measure,需自定义实现开始及结束时间及exception
measure(name="order", start_time=start_time,end_time=status['time'],exception=LocustError(f"host_id: {host} 订购失败"))
统计结果如下
HTML报告统计结果相同:
有时候我们希望的压测的模型不是先升然后平稳的运行,而是升降突然拉升等等一些模型的设计,在locustfiles/shape_classes目录下,封装几种场景的场景,也可以基于该场景进行二次开发
如何调用:在脚本中继承locustfiles/shape_classes下的相关类,在传参时加入--class-picker参数来选择要使用的形状即可
集合点:当需要指定事务同时执行时,需要使用集合点的功能,locust本身未提供需使用协程的信号量进行二次封装,支持参数指定或者动态指定集合数在集合点并发执行事务的功能
如下是一个简单的demo
from util.rendezvous import Rendezvous
@events.test_start.add_listener
def init_shared_service(environment, **kwargs):
# 仅在Master节点或独立运行模式初始化
if not isinstance(environment.runner, WorkerRunner):
environment.shared = Rendezvous(environment.parsed_options.rendezvous_num)
class WebsiteUser(HttpUser):
host = "127.0.0.1"
@task
def my_task(self):
global num
num += 1
time.sleep(1)
loop_num = self.environment.parsed_options.loop_num
# 集合点
if self.environment.parsed_options.is_rendezvous:
with self.environment.shared:
print('业务逻辑')
# 当达到指定轮数后停止
if loop_num < num:
self.environment.runner.quit() # 强制停止所有虚拟用户
如果使用make方式执行,则在测试完成或者终止后,自动生成报告,也支持自动上传到云存储服务器中
测试报告的格式如下:
如果第三方接入,实现main.py中的run_test()方式,则测试报告格式如下:
这里说一下思路: 复杂的可以使用中间件,类似于Redis这些进行资源管理,简单的可以使用locust的原生send_message方法实现
既支持csv文件指定,也支持测试时,在前置准备环境生成测试数据,且动态分配给指定的user使用
该框架是基于locust进行的二次开发,使其变得更加好用
我在这里想说的,这只是一个工具,能帮助我们更好的完成性能测试,除了工具外,我认为更重要的还是,如何进行场景的设计及指标的设定,需求明确,才能把真正的风险暴露出来.
关于如何开展性能测试,感兴趣的小伙伴可以参考我的文章:性能测试那二三事
实现main.py中的run_test()方式即可
目前作者已经相关该框架嵌入到了自己的自动化测试平台中:https://www.coder-ljx.cn:7524/locust/locustcaselist
请查阅作者博客的相关章节,里面总结了我在工作中各种场景下,使用locust进行压测的经验总结,希望能帮到你
欢迎所有形式的贡献!无论是bug报告、功能请求、代码贡献还是文档改进。
git checkout -b feature/your-feature-namegit commit -am 'Add some feature'git push origin feature/your-feature-name本项目采用 MIT License 开源协议。
感谢所有为这个项目做出贡献的开发者和用户!
特别感谢:
也欢迎和您交流讨论😊
个人微信号
⭐ 如果这个项目对您有帮助,请给我一个Star!
🔗 项目链接: GitHub Repository
📖 在线文档: 完整文档
ljxpython/locust_framework is a public repo on GitHub by ljxpython. 一个基础的locust压测框架,可以拿过来在这个框架基础上进行二次开发.
It declares no license on GitHub. Public does not mean open source: without a license, nobody is granted the right to reuse it.
Its maker has not tagged a system, so it is unknown here. Its README says what it needs.
Open "Take it" on its page: Take My Repo writes an install plan for your machine and hands it to your AI agent (Claude Code, Codex or Cursor), which asks you before each step. Take My Repo has not tested it on any machine.
Its last change on GitHub was on 2025-08-29. Take My Repo does not judge from that whether it is maintained.
Nobody has reviewed it on Take My Repo yet, which says nothing about its quality.

企业级 AI Agent 平台底座 · 基于 LangGraph 生态二次开发,开箱即用(FastAPI + Vue 3 + 持续评测飞轮 + 原生知识中台 + 全链路可观测 + 智能排障助手 + 沙箱工作区)
This page is also available as structured data, with the same sources and dates.
/api/v1/resources/gh/ljxpython/locust_frameworkTake My Repo has not tested this on your machine. Requirements come from the project's own documentation.
