1
0
mirror of https://github.com/SAP/jenkins-library.git synced 2024-12-14 11:03:09 +02:00
sap-jenkins-library/documentation/docs/steps/durationMeasure.md
Oliver Nocon 749aa5e7ed
InfluxDB support (#52)
* adding step for writing metrics to InfluxDB including dependencies
* added documentation
* incorporated PR feedback
2018-01-24 09:55:38 +01:00

1.3 KiB

durationMeasure

Description

This step is used to measure the duration of a set of steps, e.g. a certain stage. The duration is stored in a Map. The measurement data can then be written to an Influx database using step influxWriteData.

!!! tip Measuring for example the duration of pipeline stages helps to identify potential bottlenecks within the deployment pipeline. This then helps to counter identified issues with respective optimization measures, e.g parallelization of tests.

Prerequisites

none

Pipeline configuration

none

Explanation of pipeline step

Usage of pipeline step:

durationMeasure (script: this, measurementName: 'build_duration') {
    //execute your build
}

Available parameters:

parameter mandatory default possible values
script no empty globalPipelineEnvironment
measurementName no test_duration

Details:

  • script defines the global script environment of the Jenkinsfile run. Typically this is passed to this parameter. This allows the function to access the commonPipelineEnvironment for storing the measured duration.
  • measurementName defines the name of the measurement which is written to the Influx database.