The following plugin provides functionality available through Pipeline-compatible steps. Read more about how to integrate steps into your Pipeline in the Steps section of the Pipeline Syntax page.

For a list of other such plugins, see the Pipeline Steps Reference page.

Performance Plugin

perfReport: Publish Performance test result report

  • sourceDataFiles

    Specify the path to the Performance report files, relative to the workspace root. Plugin will be automatically detect parser for each report file.

    • You can specify multiple files and directories separated by semicolon.
    • You use an Ant 'fileset' pattern.

    Default Values are:

    • JMeter reports: "**/*.jtl"
    • JMeter csv reports: "**/*.csv"
    • JMeter Summariser reports: "**/*.log"
    • Taurus reports: "**/*.xml"
    • JUnit report: "**/TEST-*.xml"
    • wrk report: "**/*.wrk"

    * By default jmeter writes summariser statistics to jmeter.log. To enable logging summariser statistics to separate log file add the property to jmeter.properties file to #Logging Configuration block : "log_file.jmeter.reporters.Summariser=filename.log"

    ** Default time format, that JMeter used for logging is "yyyy/mm/dd HH:mm:ss". See "log_format" property in jmeter.properties file in #Logging Configuration block.

    *** By default wrk does not write output files. You'll need to redirect the STDOUT output for a file as in

    wrk [options] [url] > results.wrk
    • Type: String
  • baselineBuild (optional)
    • Type: int
  • compareBuildPrevious (optional)
    • Type: boolean
  • configType (optional)
    • Type: String
  • constraints (optional)
      Array/List
      hudson.plugins.performance.constraints.AbstractConstraint
  • errorFailedThreshold (optional)
    • Type: int
  • errorUnstableResponseTimeThreshold (optional)
    The thresholds settings should be delimited by a new line character "\n".
    The actual threshold number should be seperated from the test file name by a colon ":"
    Example:
    -------------------------------------
    JMeterResultsOrders.jtl:2000
    JMeterResultsGetCustomer.jtl:500
    JMeterResultsCreateCustomer.jtl:700
    -------------------------------------
    
    • Type: String
  • errorUnstableThreshold (optional)
    • Type: int
  • excludeResponseTime (optional)
    • Type: boolean
  • failBuildIfNoResultFile (optional)
    • Type: boolean
  • filterRegex (optional)

    If this field is not empty, its content will be considered as a regular expression to only take into account URI matching it.

    Example : ^(HP|Scenario|Search)(-success|-failure)?$

    • Type: String
  • graphType (optional)
    • Type: String
  • ignoreFailedBuilds (optional)
    • Type: boolean
  • ignoreUnstableBuilds (optional)
    • Type: boolean
  • junitOutput (optional)
    • Type: String
  • modeEvaluation (optional)

    Standard Mode activates upper box and ignores lower box.

    Expert Mode activates lower box and ignores upper box.

    • Type: boolean
  • modeOfThreshold (optional)
    • Type: boolean
  • modePerformancePerTestCase (optional)
    • Type: boolean
  • modeThroughput (optional)
    • Type: boolean
  • nthBuildNumber (optional)
    • Type: int
  • parsers (optional)
      Array/List
      Nested Choice of Objects
    • $class: 'IagoParser'
      • glob
        • Type: String
      • percentiles
        • Type: String
      • filterRegex
        • Type: String
    • $class: 'JMeterCsvParser'
      • glob
        • Type: String
      • percentiles
        • Type: String
      • filterRegex
        • Type: String
    • $class: 'JMeterParser'
      • glob
        • Type: String
      • percentiles
        • Type: String
      • filterRegex
        • Type: String
    • $class: 'JUnitParser'
      • glob
        • Type: String
      • percentiles
        • Type: String
      • filterRegex
        • Type: String
    • $class: 'JmeterSummarizerParser'
      • glob
        • Type: String
      • percentiles
        • Type: String
      • filterRegex
        • Type: String
    • $class: 'LoadRunnerParser'
      • glob
        • Type: String
      • percentiles
        • Type: String
      • filterRegex
        • Type: String
    • $class: 'TaurusParser'
      • glob
        • Type: String
      • percentiles
        • Type: String
      • filterRegex
        • Type: String
    • $class: 'WrkSummarizerParser'
      • glob
        • Type: String
      • percentiles
        • Type: String
      • filterRegex
        • Type: String
  • percentiles (optional)
    • Type: String
  • persistConstraintLog (optional)
    • Type: boolean
  • relativeFailedThresholdNegative (optional)
    • Type: double
  • relativeFailedThresholdPositive (optional)
    • Type: double
  • relativeUnstableThresholdNegative (optional)
    • Type: double
  • relativeUnstableThresholdPositive (optional)
    • Type: double

bzt: Run Performance Test

Execute Taurus with configuration files and options. You can simply specify JMX file to run, or give list of Taurus config files and options to execute.
  • params
    • Type: String
  • alwaysUseVirtualenv (optional)
    • Type: boolean
  • bztVersion (optional)
    • Type: String
  • generatePerformanceTrend (optional)
    • Type: boolean
  • printDebugOutput (optional)
    • Type: boolean
  • useBztExitCode (optional)
    • Type: boolean
  • useSystemSitePackages (optional)
    • Type: boolean
  • workingDirectory (optional)
    • Type: String
  • workspace (optional)
    • Type: String

Was this page helpful?

Please submit your feedback about this page through this quick form.

Alternatively, if you don't wish to complete the quick form, you can simply indicate if you found this page helpful?

    


See existing feedback here.