CentOS JMeter如何生成详细的测试报告

在CentOS上生成JMeter详细HTML报告

一 环境准备

• 安装 Java 8（OpenJDK 8）：
  • 命令：sudo yum -y install java-1.8.0-openjdk
  • 验证：java -version
• 安装 Apache JMeter（以 5.4.3 为例）：
  • 下载：wget https://dlcdn.apache.org//jmeter/binaries/apache-jmeter-5.4.3.tgz
  • 解压：tar -xzf apache-jmeter-5.4.3.tgz -C /usr/local/
  • 建议配置环境变量（可选）：
    • export JMETER_HOME=/usr/local/apache-jmeter-5.4.3
    • export PATH=$PATH:$JMETER_HOME/bin
  • 验证：jmeter -v
• 准备测试脚本：在本地 JMeter GUI 中编写并保存为 .jmx，上传至 CentOS（如：/opt/test/testplan.jmx）。

二 生成报告的两种方式

• 方式一 运行后直接导出 HTML（推荐）
  • 命令：

    cd /usr/local/apache-jmeter-5.4.3/bin
    ./jmeter -n -t /opt/test/testplan.jmx -l /opt/test/results.jtl -e -o /opt/test/report
    

  • 说明：
    • -n 非 GUI；-t 指定脚本；-l 保存结果（.jtl）；-e 生成报告；-o 指定输出目录（必须为空）。
• 方式二 已有 JTL 再生成 HTML
  • 命令：

    ./jmeter -g /opt/test/results.jtl -o /opt/test/report_from_jtl
    

  • 说明：-g 读取 .jtl 生成报告，输出目录同样必须为空。
• 查看报告：将生成的 report 目录拷贝到本地，用浏览器打开 index.html 查看详细图表与统计。

三 报告内容要点

• Dashboard：概览指标（如 Apdex，默认满意阈值 500 ms、容忍阈值 1500 ms）、关键统计数据与图表。
• Over Time 图表：默认 1 分钟一个点，含 响应时间、TPS、活跃线程数趋势。
• 聚合报告：类似 GUI 的 Aggregate Report，便于查看 样本数、平均值、最小值、最大值、错误率、吞吐量 等。

四 提升报告可读性与常见问题

• 提升报告字段丰富度（在 JMETER_HOME/bin/user.properties 追加，必要时调整 jmeter.properties）：

  jmeter.save.saveservice.assertion_results_failure_message=true
  jmeter.save.saveservice.response_code=true
  jmeter.save.saveservice.response_message=true
  jmeter.save.saveservice.successful=true
  jmeter.save.saveservice.thread_name=true
  jmeter.save.saveservice.time=true
  jmeter.save.saveservice.bytes=true
  jmeter.save.saveservice.thread_counts=true
  jmeter.save.saveservice.timestamp_format=yyyy/MM/dd HH:mm:ss.SSS
  # 可自定义
  jmeter.reportgenerator.apdex_satisfied_threshold=1500
  jmeter.reportgenerator.apdex_tolerated_threshold=3000
  jmeter.reportgenerator.overall_granularity=60000
  

  说明：更完整的字段有助于 HTML 报告展示更细的统计与图表。
• 常见问题与建议：
  • 输出目录 必须为空，否则报告生成会失败或内容异常。
  • 命令行实时日志中的 summary+/summary= 可观察 TPS、响应时间、错误率、并发数 等，便于即时排查。
  • 若需变更图表粒度，可调整 overall_granularity（单位毫秒）。