JMeter Performance Lab

触发场景

当用户提出以下需求时启用：

• “帮我生成 JMeter 脚本 / .jmx / 压测脚本”
• “用自然语言执行本地 JMeter / 跑一下这个 jmx”
• “根据 JTL 生成性能测试报告 / 精美报告 / JMeter HTML 报告”
• “分析吞吐、P95、P99、错误率、Apdex、瓶颈”

能力边界

擅长做

• 将自然语言转为结构化压测规格，再生成 .jmx。
• 支持 HTTP/HTTPS、线程组、Ramp-up、循环、Duration、Header、Body、响应断言、CSV 参数化、Think Time。
• 检测并调用本地 JMeter：JMETER_HOME 或 PATH 中的 jmeter。
• 生成 result.jtl、JMeter 原生 native-report/ 与自定义精美 HTML 报告。
• 从 JTL 计算样本数、平均响应、P50/P90/P95/P99、吞吐、错误率、Apdex 和接口明细。

谨慎做

• 生产环境压测必须确认授权、窗口期、限流、回滚和监控负责人。
• 大并发、长时间、外部第三方接口压测必须先给出风险提示与小流量试跑方案。
• 本地未安装 JMeter 时，只生成脚本和命令，不假装已执行。

不能做

• 不帮助攻击、绕过限流、DDoS、未授权压测或隐藏来源。
• 不承诺“零风险”“绝对容量上限”；容量结论必须附环境、数据规模和假设。
• 不明文写入 Token、Cookie、密码；用 ${TOKEN}、${USER} 等占位符。

工作流

1. 澄清与脱敏：确认目标域名、接口、并发、Ramp-up、持续时间、断言、数据文件、是否授权；敏感值改占位符。
2. 自然语言路由：
• 要脚本 → 生成 JSON spec → 调用 scripts/jmx_generator.py。
• 要执行 → 检测 JMeter → 生成安全命令 → 调用 scripts/run_jmeter.py。
• 要报告 → 读取 JTL → 调用 scripts/report_builder.py，必要时同时指向原生 native-report/。
3. 执行前保护：生产环境、高并发、未知目标、无授权时先询问确认，不直接执行。
4. 结果交付：返回 .jmx、JTL/原生报告位置、自定义 HTML 报告、关键指标和风险说明。
5. 失败降级：JMeter 不存在时输出安装/配置建议；JTL 缺字段时标注无法计算的指标。

自然语言转 spec 示例

{
  "name": "order-api-load-test",
  "base_url": "https://api.example.com",
  "users": 50,
  "ramp_up": 120,
  "loops": 1,
  "duration": 600,
  "think_time_ms": 500,
  "headers": {"Authorization": "Bearer ${TOKEN}", "Content-Type": "application/json"},
  "csv": {"filename": "users.csv", "variables": "USER_ID,TOKEN"},
  "requests": [
    {"name": "query-order", "method": "GET", "path": "/orders/${USER_ID}", "assertion": {"contains": "orderId"}},
    {"name": "create-order", "method": "POST", "path": "/orders", "body": "{\"userId\":\"${USER_ID}\"}", "assertion": {"contains": "success"}}
  ]
}

脚本用法

生成 JMX：

"$BOX_AGENT_PYTHON" scripts/jmx_generator.py --spec spec.json --out output/test-plan.jmx

执行 JMeter：

"$BOX_AGENT_PYTHON" scripts/run_jmeter.py --jmx output/test-plan.jmx --outdir output/run-001

输出：result.jtl、native-report/、jmeter-run.log。

生成精美报告：

"$BOX_AGENT_PYTHON" scripts/report_builder.py --jtl output/run-001/result.jtl --out output/run-001/summary-report.html --title "性能测试报告"

输出格式

• 脚本交付：说明压测目标、线程组、断言、参数化、运行命令和注意事项。
• 执行交付：说明命令、状态、JTL、原生报告目录、日志位置。
• 报告交付：结论等级、关键指标卡片、接口明细、瓶颈诊断、下一步建议。

验收标准

• .jmx 能被 JMeter 5.x 打开或 jmeter -n -t 识别。
• 本地 JMeter 缺失时给出明确配置建议，不报假结果。
• JTL 报告至少输出样本数、错误率、平均、P50/P90/P95/P99、吞吐、Apdex。
• 所有生产/高压场景均有授权确认和风险提示。
• 所有敏感信息均脱敏为占位符。

FAQ

详见 references/faq.md。

参考资料

• references/natural-language-routing.md
• references/jmx-generation-guide.md
• references/execution-guide.md
• references/report-guide.md
• references/security-and-anti-patterns.md
• references/faq.md
• references/trace-self-check.md
• scripts/jmx_generator.py
• scripts/run_jmeter.py
• scripts/report_builder.py