简体中文
压测验收工具:场景与报告
内置场景
| 场景 | 压什么 |
|---|---|
ping | 连通性与最小开销基线 |
pay-barcode | 付款码被扫下单(最常用的容量场景) |
pay-mixed | 多种支付方式混合下单 |
refund-flow | 下单后退款 |
close-flow | 下单后关单 |
gateway | 网关支付预下单链路 |
preauth | 预授权冻结 / 请款 / 解冻 |
alloc | 分账 |
reconcile | 对账 |
callback | 回调链路 |
soak | 长稳(低 TPS 长时间) |
ramp-to-break | 阶梯探峰,找崩点 |
场景写法见场景包目录里的 _common.md。要点:
- 容量场景不要传
notifyUrl,避免商户通知干扰吞吐口径; - 单号统一
PERF-${runTag}-...,金额用整数分; - 付款码金额尾号 1 = 即时成功、3 = 处理中(可用于关单演练);
- 场景 DSL 字段严格,未知字段直接报错;改完用
perfctl scenario list|validate离线自检。
造数与数据量阶梯
bash
./perfctl.exe datagen --dataset datasets/orders-1m.yaml --yes [--dry-run]
./perfctl.exe clean --tag PERF-1M --yes
./perfctl.exe verify --tag PERF-1M --expected 1000000- 造数按依赖顺序 COPY 业务单、资金单、退款单与流水,支持状态分布、金额区间、时间回推;
- 数据集支持
refs.merchants[]多商户:按订单行号轮转,同一源订单的各类单据共用同一商户; - 清理按 tag 反向删(退款 → 流水 → 资金单 → 业务单);
- 数据量阶梯用
perfctl ladder --experiment experiments/volume-ladder.yaml --yes,按 10 万 / 100 万 / 500 万逐档造数并跑查询基准。
指标口径
| 指标 | 说明 |
|---|---|
| 延迟 | 客户端直方图(0.5ms~60s 对数桶),输出 p50 / p90 / p95 / p99 / p999 / max |
| 维度 | run / stage / flow / step / 错误类;另单列签名耗时与可选响应验签耗时 |
| 时间序列 | 每秒采样,整体与分步骤各一套 |
| 步骤时序 | steps.jsonl 每行一个 step 的每秒请求数、错误数、p50/p95/p99 |
| 资源采样 | 主应用与 mock 的 actuator(CPU / GC / Hikari / Tomcat)、PG 连接与事务、Redis INFO、压测机自身 |
| 归因 | 按资源与延迟特征输出 Top 2 嫌疑(CPU/RSA、连接池、Tomcat、Redis、PG、压测机) |
三个边界概念:
- 稳定上限:连续满足 SLA(P99、错误率、背压)的最高 TPS;
- 崩点:第一个失败档;
- 推荐容量:稳定上限 × 0.7。
报告与产物
bash
./perfctl.exe report --run run-20261025-153000
./perfctl.exe compare --a run-... --b run-...
./perfctl.exe results prune --keep 20每次 run 一个目录,report.html 离线自包含,可直接发给验收方。同目录还有:
| 文件 | 内容 |
|---|---|
meta.json | 场景快照、主机核数、mock 配置、压测库基线 |
steps.jsonl | 步骤级每秒指标 |
timeseries.jsonl | 整体每秒指标 |
resources.jsonl | 资源采样 |
attribution.json | 归因结果 |
verify.json | 响应验签抽样结果 |
阶梯实验有单独的阶梯报告(perfctl report --ladder ... 或管理台阶梯页打开)。
一致性核对
按步骤路径识别 /unipay/pay、/unipay/gateway/pre-pay、/unipay/refund 的成功请求数,与库内订单、退款数量比对;组合场景同样适用。对不上时先看 verify.json 里的验签抽样,再查 mock 是否按预期返回成功。
常见问题速查
| 现象 | 处理 |
|---|---|
体检报 DB-01 database does not exist | 压测库未创建,按压测库准备建库或改 database.name |
体检报 DB-02 配置库与实际连接不一致 | 应用还连着旧库,按目标库重启应用(工具不切库) |
体检报 MOCK-03 容量不足 | 模拟联调通道管理台把订单容量调大或设 0 |
体检报 APP-04 日志 DEBUG | 改 INFO/WARN 并重启(工具不代改) |
| WARN 阻止开压 | 确认风险后逐项勾选,或 --accept-warn ID |
| 造数提示 tag 已存在 | 换 tag,或 clean --tag 后重造;续造用 --append |
| 查询基准出现 Seq Scan | 预期会命中 pay_normal_order 缺 (mch_no, create_time) 索引,报告会标注 |