简体中文
压测验收工具:快速开始
按下面顺序走一遍,就能在本机跑出第一份报告。工具的所有写操作都要手动确认,没有任何自动化步骤。
1. 构建
bash
go build -o perfctl.exe .产物是单个可执行文件,管理台前端已内嵌,不需要再构建前端。
2. 导入配置
工具的运行时配置只读 configs/_perf.yaml(该文件不入库)。首次使用从主项目 yml 生成候选:
bash
./perfctl.exe config import --server-dir <主项目>/daxpay-start/src/main/resources
./perfctl.exe config diff # 看差异
./perfctl.exe config apply # 合并: 默认只补空字段, 手工值优先主项目 yml 只用于一次性导入,不是运行时依赖。压测机没有主项目源码时,用管理台「配置」页的上传导入:上传 application.yml(必选)、application-<profile>.yml(可选)与商户私钥 PEM(可选),再在「地址与连接」卡片里修正主应用、mock、数据库地址。
config show 输出的是脱敏值(****(N位)),可以安全贴图。
3. 开压前体检
bash
./perfctl.exe doctor --capacity --tps 200 --duration 60s体检会检查压测库是否存在、应用实际连的库与配置是否一致、mock 容量是否够、应用日志级别是否过高、目标是否内网等,产出 doctor.json 与 doctor.md。
- FAIL:直接阻断,退出码非 0;
- WARN:需要在管理台逐项勾选确认,或命令行
--accept-warn ID,...,记录会写进 run meta。
管理台里发起压测前必须先点「重新检测」,绕不过去;应急场景才用 --skip-doctor(并在报告里留痕)。
4. 启动管理台
bash
./perfctl.exe serve管理台默认只监听本机,启动日志会打印实际访问地址。跨机(压测机与主应用不在同一台)时用 --addr 0.0.0.0:<端口> 启动,并在防火墙放行;非回环启动会打印安全提示。
页面包括:总览、压测、实时任务、造数、查询基准、阶梯实验、报告、配置、关于。
5. 压测库准备
工具不切库,下面几步由操作者完成:
- 建一个独立的压测库(不要复用开发库或生产库);
- 初始化表结构与种子:
table.sql → data.sql(联调摸底可用data-demo.sql),或由 DBA 完成; - 一键准备压测商户:
perfctl db prepare --yes(先--dry-run演练)。工具按幂等方式写入压测商户、应用、商户 RSA 公钥、mock_pay通道商户与场景路由,并把生成的身份打印出来,由你手工填回_perf.yaml; - 把主应用指向压测库并重启;
- 到模拟联调通道的管理台把订单容量调大(或设 0 不限),关闭自动回调;
- 再跑一次体检,确认库、容量、日志几项全 PASS。
工具不会自动改配置,也不会替你在 mock 侧建档。
6. 第一轮压测
- 管理台「压测」页选场景(首次就用
pay-barcode); - 设 TPS 与时长(遵守配置里的上限:
maxTps、maxDuration、maxInFlight); - 发起后到「实时任务」看 TPS、P99 与错误分类;
- 结束后在「报告」页打开离线 HTML。
想用命令行:
bash
./perfctl.exe run --scenario scenarios/pay-barcode.yaml --tps 200 --duration 60s下一步
- 场景怎么选、参数怎么写,见场景与报告;
- 想先确认工具本身没配错,
perfctl scenario validate可以离线自检场景包; - 每次 run 的产物在
results/run-*/,默认只保留最近 20 次(results.keepRuns)。