chronos:jmeter

Full name:

org.codehaus.mojo:chronos-maven-plugin:1.0-SNAPSHOT:jmeter

Description:

Invokes JMeter.
JMeter is invoked by spawning a separate process to make it possible to control startup parameters. Can also be used by specifying a .jtl file as input and (possibly) a garbage collection logfile.

Attributes:

  • Requires a Maven project to be executed.
  • Requires dependency resolution of artifacts in scope: test.
  • Binds by default to the lifecycle phase: integration-test.

Required Parameters

Name Type Since Description
input File - The inputfile. This could either be a .jtl file or a .jmx file. In the latter case, jmeter is invoked, and the generated .jtl file parsed afterwards.

Optional Parameters

Name Type Since Description
bootstrapper String - Clasname of an (optional) bootstrapperclass. The purpose is to allow bootstrapping the proces eg. by initializing testdata in a relational database without measuring the time.
dataid String - The id of the jmeter invocation.
Default value is: performancetest.
gcargs List - Configuration parameters used for configurating the .
gclogfile File - The name of an (optional) garbage collection logfile. Only used when loggc is set to true.
heap String - The heapsize (both initial and max) of the spawned jvm invoking jmeter.
Default value is: 256m.
jMeterRemoteLocation String - The URL from where jMeter can be downloaded.
Default value is: http://www.eu.apache.org/dist/jakarta/jmeter/binaries/jakarta-jmeter-2.5.1.zip.
jmeterVariables Properties - Additional arguments supplied to jmeter. like invoking the jmeter startup script with using jmeterargumensts like -Jvariable=value
jmeterhome String - The path to the jmeter installation. The recommended way to set this is by specifying a property jmeter.home in the pom.xml or settings.xml.

loggc boolean - Will garbage collections be logged? Note that this is really only relevant if your tests are junitsamples in jmeter.
Default value is: true.
maxliveobjectevacuationratio String - Specifies the corresponding jvm option of the spawned jvm invoking jmeter.
maxtenuringthreshold String - Specifies the corresponding jvm option of the spawned jvm invoking jmeter.
Default value is: 2.
newsize String - Specifies the corresponding jvm option of the spawned jvm invoking jmeter.
Default value is: 128m.
options List - Optional Miscellaneous configuration parameters used when launching JMeter
permsize String - The size of the part of the spawned jmeter jvm's memory, where classes e.g. are stored.
Default value is: 64m.
project MavenProject - The current maven project.
rmigcinterval String - How often will rmi garbage collections be performed? JVM option of the spawned jvm invoking jmeter.
Default value is: 600000.
survivorratio String - Specifies the corresponding jvm option of the spawned jvm invoking jmeter.
sysproperties Properties - System-properties to the launched jvm.
targetsurvivorratio String - Specifies the corresponding jvm option of the spawned jvm invoking jmeter.

Parameter Details

bootstrapper:

Clasname of an (optional) bootstrapperclass. The purpose is to allow bootstrapping the proces eg. by initializing testdata in a relational database without measuring the time.
  • Type: java.lang.String
  • Required: No

dataid:

The id of the jmeter invocation.
  • Type: java.lang.String
  • Required: No
  • Default: performancetest

gcargs:

Configuration parameters used for configurating the .
  • Type: java.util.List
  • Required: No

gclogfile:

The name of an (optional) garbage collection logfile. Only used when loggc is set to true.
  • Type: java.io.File
  • Required: No

heap:

The heapsize (both initial and max) of the spawned jvm invoking jmeter.
  • Type: java.lang.String
  • Required: No
  • Default: 256m

input:

The inputfile. This could either be a .jtl file or a .jmx file. In the latter case, jmeter is invoked, and the generated .jtl file parsed afterwards.
  • Type: java.io.File
  • Required: Yes

jMeterRemoteLocation:

The URL from where jMeter can be downloaded.
  • Type: java.lang.String
  • Required: No
  • Default: http://www.eu.apache.org/dist/jakarta/jmeter/binaries/jakarta-jmeter-2.5.1.zip

jmeterVariables:

Additional arguments supplied to jmeter. like invoking the jmeter startup script with using jmeterargumensts like -Jvariable=value
  • Type: java.util.Properties
  • Required: No

jmeterhome:

The path to the jmeter installation. The recommended way to set this is by specifying a property jmeter.home in the pom.xml or settings.xml.
  • Type: java.lang.String
  • Required: No
  • Expression: ${project.basedir}/jmeter

loggc:

Will garbage collections be logged? Note that this is really only relevant if your tests are junitsamples in jmeter.
  • Type: boolean
  • Required: No
  • Default: true

maxliveobjectevacuationratio:

Specifies the corresponding jvm option of the spawned jvm invoking jmeter.
  • Type: java.lang.String
  • Required: No

maxtenuringthreshold:

Specifies the corresponding jvm option of the spawned jvm invoking jmeter.
  • Type: java.lang.String
  • Required: No
  • Default: 2

newsize:

Specifies the corresponding jvm option of the spawned jvm invoking jmeter.
  • Type: java.lang.String
  • Required: No
  • Default: 128m

options:

Optional Miscellaneous configuration parameters used when launching JMeter
  • Type: java.util.List
  • Required: No

permsize:

The size of the part of the spawned jmeter jvm's memory, where classes e.g. are stored.
  • Type: java.lang.String
  • Required: No
  • Default: 64m

project:

The current maven project.
  • Type: org.apache.maven.project.MavenProject
  • Required: No
  • Expression: ${project}

rmigcinterval:

How often will rmi garbage collections be performed? JVM option of the spawned jvm invoking jmeter.
  • Type: java.lang.String
  • Required: No
  • Default: 600000

survivorratio:

Specifies the corresponding jvm option of the spawned jvm invoking jmeter.
  • Type: java.lang.String
  • Required: No

sysproperties:

System-properties to the launched jvm.
  • Type: java.util.Properties
  • Required: No

targetsurvivorratio:

Specifies the corresponding jvm option of the spawned jvm invoking jmeter.
  • Type: java.lang.String
  • Required: No