Ubuntu上JMeter报告怎么生成

Ubuntu上生成JMeter HTML报告

一 准备环境

• 安装 JDK 8 或 11（JMeter 5.x 推荐），并确认 java -version 正常。
• 安装 Apache JMeter（建议 5.4+），解压到如 /usr/local/jmeter，并把 $JMETER_HOME/bin 加入 PATH，以便直接执行 jmeter 命令。

二 两种生成方式

• 方式一 已有结果文件生成报告
  使用已有的 .jtl 结果直接生成 HTML 报告：
  jmeter -g /path/to/result.jtl -o /path/to/report
  说明：-g 指定结果文件，-o 指定输出目录（必须为空或不存在）。生成后用浏览器打开 /path/to/report/index.html 查看。

• 方式二 执行脚本同时生成报告
  一条命令完成压测并导出 HTML：
  jmeter -n -t /path/to/test.jmx -l /path/to/result.jtl -e -o /path/to/report
  常用参数：

  • -n 非 GUI 模式
  • -t 测试脚本 .jmx
  • -l 结果文件 .jtl（该文件必须不存在，否则报错）
  • -e 测试结束后生成 HTML 报告
  • -o 报告输出目录（必须为空或不存在）
    报告查看方式同上，打开 index.html。

三 常用命令示例

• 仅保存结果，不生成报告：
  jmeter -n -t test.jmx -l jtl/result.jtl
• 执行并生成报告（报告目录需为空）：
  jmeter -n -t test.jmx -l jtl/result.jtl -e -o html/report_20260103
• 用已有结果生成报告：
  jmeter -g jtl/result.jtl -o html/report_from_jtl
  以上命令中的路径可按你的实际目录调整。

四 报告内容与查看

• 报告由 Dashboard 与 Charts 组成：
  • Dashboard：包含 Test and Report informations、APDEX、Requests Summary 等概览指标。
  • Charts：包含随时间变化的 Response Times、Throughput、TPS、Percentiles 等关键图表，用于定位性能拐点与稳定性问题。
• 在 Ubuntu 服务器上生成后，可将报告目录拷贝到本地，或用 scp/sz 下载，再用浏览器打开 index.html 查看完整图表。

五 常见问题与排查

• 报错“结果文件已存在”：执行时使用的 .jtl 必须不存在；如需覆盖，请先删除旧文件或更换文件名。
• 报错“输出目录已存在”：-o 指定的报告目录必须为空或不存在；请先清空或更换目录。
• 中文或字体显示异常：建议使用 JMeter 3.0+ 版本，其 Dashboard Report 对中文支持更好。
• 分布式压测需要远程启动 agent 时，可加 -r 参数（如：jmeter -n -t test.jmx -l result.jtl -e -o report -r）。