学技术学英文：通过jmeter命令行工具生成聚合报告文件到csv文件

发布于：2025-02-10 ⋅ 阅读:(22) ⋅ 点赞:(0)

单词

汉语意思

音标

aggregate

聚合

/ˈæɡrɪɡeɪt/

command-line

命令行

/kəˈmænd laɪn/

distribution

分布

/ˌdɪstrɪˈbjuːʃn/

extractor

提取器

/ɪkˈstræktər/

granulation

细分

/ˌɡrænjuˈleɪʃn/

jmeter

JMeter（软件）

/ˈdʒeɪˌmiːtər/

latencies

延迟

/ˈleɪtənsiz/

merge

合并

/mɜːrdʒ/

outliers

异常值

/ˈaʊtˌlaɪərz/

parameters

参数

/pəˈræmɪtərz/

percentiles

百分位数

/pərˈsɛntaɪlz/

plugin

插件

/ˈplʌɡɪn/

regex

正则表达式

/ˈriːɡɛks/

synthesis

综合

/ˈsɪnθəsɪs/

throughput

吞吐量

/ˈθruːpʊt/

transactions

事务

/trænˈzækʃənz/

utility

工具

/juːˈtɪlɪti/

visualization

可视化

/ˌvɪʒuəlɪˈzeɪʃn/

zeroing

归零

/ˈzɪərɪŋ/

customization

定制

/ˌkʌstəmaɪˈzeɪʃn/

JMeterPluginsCMD Command Line Tool

 Download

There is small command-line utility for generating graphs out of JTL files. It behave just like right-click context menu on all graphs. The tool can generate PNG, CSV or both.

Note you can use GraphsGeneratorListener if you want to bulk generate graphs after a test or for existing results.

Installation

The tool is installed normally with PluginsManager, producing launcher bat/sh files in JMeter's bin directory. Use JMeterPluginsCMD.bat on Windows and JMeterPluginsCMD.sh on MacOS and Linux.

Usage and Parameters

Generating PNG:

JMeterPluginsCMD.bat --generate-png test.png --input-jtl results.jtl --plugin-type ResponseTimesOverTime --width 800 --height 600

Generating CSV:

JMeterPluginsCMD.bat --generate-csv test.csv --input-jtl results.jtl --plugin-type ResponseTimesOverTime

Yoy may generate CSV and PNG in single tool run. --help will show you short help list on available parameters.

--generate-png <file> generate PNG file containing graph
--generate-csv <file> generate CSV file containing graph data
--input-jtl <file> load data from specified JTL file
--plugin-type <class> which type of graph use for results generation

Use --input-jtl merge-results.properties with --plugin-type MergeResults. The merge-results.properties file is in JMETER_HOME/bin dir.

You may customize graph drawing and data processing like GUI settings do with optional parameters:

--width <pixels> for PNG only - width of the image, default is 800
--height <pixels> for PNG only - height of the image, default is 600
--granulation <ms> granulation time for samples
--relative-times <yes/no> use relative X axis times, no will set absolute times
--aggregate-rows <yes/no> aggregate all rows into one
--paint-gradient <yes/no> paint gradient background
--paint-zeroing <yes/no> paint zeroing lines
--paint-markers <yes/no> paint markers on data points (since 1.1.3)
--prevent-outliers <yes/no> prevent outliers on distribution graph
--limit-rows <num of points> limit number of points in row
--force-y <limit> force Y axis limit
--hide-low-counts <limit> hide points with sample count below limit
--success-filter <true/false> filter samples by success flag (since 0.5.6), possible values are true, false, if not set no filtering on success flag will occur
--include-labels <labels list> include in report only samples with specified labels, comma-separated
--exclude-labels <labels list> exclude from report samples with specified labels, comma-separated
--auto-scale <yes/no> enable/disable auto-scale multipliers for perfmon/composite graph
--line-weight <num of pixels> line thickness for graph rows
--extractor-regexps <regExps list> list of keyRegExp and valRegExp pairs separated with {;}, only used by PageDataExtractorOverTime
--include-label-regex <true/false> include samples using regular expression
--exclude-label-regex <true/false> exclude samples using regular expression
--start-offset <sec> include in report only samples with (timestamp - relativeStartTime) > startOffset
--end-offset <sec> include in report only samples with (timestamp - relativeStartTime) < endOffset
--yAxisLabel <String> Set Y-Axis label on charts

Plugin Type Classes

Make note that you need to install corresponding plugins set to have Extras plugins available in CMD.

Most of class names are self-explanatory:

  • AggregateReport = JMeter's native Aggregate Report, can be saved only as CSV
  • SynthesisReport = mix between JMeter's native Summary Report and Aggregate Report, can be saved only as CSV
  • ThreadsStateOverTime = Active Threads Over Time
  • BytesThroughputOverTime
  • HitsPerSecond
  • LatenciesOverTime
  • PerfMon = PerfMon Metrics Collector
  • DbMon = DbMon Metrics Collector, DataBase, get performance counters via sql
  • JMXMon = JMXMon Metrics Collector, Java Management Extensions counters
  • ResponseCodesPerSecond
  • ResponseTimesDistribution
  • ResponseTimesOverTime
  • ResponseTimesPercentiles
  • ThroughputVsThreads
  • TimesVsThreads = Response Times VS Threads
  • TransactionsPerSecond
  • PageDataExtractorOverTime
  • MergeResults = MergeResults Command Line Merge Tool to simplify the comparison of two or more load tests, need properties file (like merge-results.properties)

中文总结：

  • JMeterPluginsCMD 是一个用于从 JTL 文件生成图表的小型命令行工具。

  • 可以生成 PNG 或 CSV 格式的图表，甚至可以同时生成两种格式。

  • 安装工具时，会在 JMeter 的 bin 文件夹中生成启动脚本（bat/sh 文件）。

  • 使用 --generate-png 和 --generate-csv 参数来指定生成的文件名。

  • --input-jtl 参数用于指定输入的 JTL 文件。

  • --plugin-type 参数决定使用哪种类型的图表生成结果。

  • 可以通过 --width 和 --height 参数调整生成的 PNG 图表尺寸。

  • 提供了诸如 --relative-times, --aggregate-rows, --paint-gradient 等参数来定制图表的展示和数据处理。

  • 可以使用正则表达式 (--include-label-regex, --exclude-label-regex) 来包含或排除特定标签的样本。

  • 需要安装相应的插件集才能在命令行工具中使用额外的插件功能。

 

网站公告

今日签到

点亮在社区的每一天
去签到

热门文章

最新发布