ubuntu jmeter报告生成

Ubuntu 下使用 JMeter 生成 HTML 报告

一准备环境

安装 Java（Ubuntu 推荐 OpenJDK 8 或 11）：sudo apt-get update && sudo apt-get install -y openjdk-11-jdk-headless
验证：java -version
安装 JMeter（示例为 5.4.x）：
- 下载并解压：wget -c https://archive.apache.org/dist/jmeter/binaries/apache-jmeter-5.4.1.tgz && tar -zxvf apache-jmeter-5.4.1.tgz -C /opt
- 配置环境变量（/etc/profile 或 ~/.bashrc）：
  - export JMETER_HOME=/opt/apache-jmeter-5.4.1
  - export PATH=$JMETER_HOME/bin:$PATH
- 生效：source /etc/profile
- 验证：jmeter -v

二生成报告的两种方式

方式一直接运行脚本并生成报告（推荐）
- 命令：jmeter -n -t your_plan.jmx -l result.jtl -e -o ./report
- 说明：
  - -n 非 GUI 模式；-t 指定 JMX 脚本；-l 保存结果到 JTL；-e 测试结束后生成报告；-o 指定报告输出目录
  - 若使用 分布式/远程执行，可加 -r
方式二基于已有 JTL 生成报告
- 命令：jmeter -g result.jtl -e -o ./report_from_jtl
查看报告：在输出目录打开 index.html（可用本机浏览器打开，或用 scp 复制到本地查看）

三常用命令参数速查

四常见问题与排查

报告目录非空导致失败：-o 指定的目录必须为空或不存在，否则会报错，请先清理或更换目录
JTL 结果文件已存在：命令行不会自动覆盖，建议每次使用唯一文件名，或先删除旧文件
生成报告中文或路径异常：JMeter 在 Linux 下对脚本路径/内容中的中文字符支持不佳，建议使用英文路径与名称
查看历史 JTL 结果：将 .jtl 下载到本地 JMeter GUI，添加监听器（如聚合报告、查看结果树），通过“浏览”加载 JTL 即可查看
分布式执行：确保 -r 前已正确配置并启动远程引擎，否则会报错

五报告定制与高级用法

报告字段与格式：在 jmeter.properties 中启用必要字段，例如将结果保存为 CSV 并包含关键列：
- jmeter.save.saveservice.output_format=csv
- jmeter.save.saveservice.label=true
- jmeter.save.saveservice.response_code=true
- jmeter.save.saveservice.successful=true
- jmeter.save.saveservice.time=true
- jmeter.save.saveservice.latency=true
- jmeter.save.saveservice.bytes=true
- jmeter.save.saveservice.sent_bytes=true
- jmeter.save.saveservice.connect_time=true
- jmeter.save.saveservice.assertions=true
- jmeter.save.saveservice.subresults=true
报告外观与内容：可配置报告标题与图表项，例如
- jmeter.reportgenerator.report_title=My Performance Report
- 启用/禁用图表：jmeter.reportgenerator.exporter.html.property.graph_response_time_distribution、graph_response_time_percentiles 等
图表导出（命令行）：使用 CMDRunner.jar 将 JTL 转为 PNG/SVG/CSV 等图表，例如
- java -jar lib/ext/CMDRunner.jar --tool Reporter --generate-png threads.png --input-jtl result.jtl --plugin-type ThreadsStateOverTime

最新问答