Skip to content

Jenkins plugin to load benchmark results in Jenkins and evaluate them. Make automated decisions about the success of a build based on benchmark results.

License

Notifications You must be signed in to change notification settings

jenkinsci/benchmark-evaluator-plugin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

69 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Benchmark Evaluator Plugin

This Plugin provides to load benchmark data to Jenkins.

The plugin persists the data and decides on success or failure of the evaluated build. Therefore, Service Level Agreements, software specifications, or relative thresholds can be set in a simple graphical interface.

The Visual Interface visualizes the benchmarking results for human users. It can plot individual runs or the development of aggregates across versions, e.g., as line charts.

Currently the plugin only reads comma-separated values (CSV) and Yahoo Cloud Serving Benchmark (YCSB) data. Using small shell scripts the benchmark results of different tools can be converted into CSV files. Classes for new data types can be easily integrated via an interface.

If you use this software in a publication, please cite it as:

Text

Martin Grambow, Fabian Lehmann, David Bermbach. Continuous Benchmarking: Using System Benchmarking in Build Pipelines. In: Proceedings of the 1st Workshop on Service Quality and Quantitative Evaluation in new Emerging Technologies (SQUEET 2019). IEEE 2019.

BibTeX

@inproceedings{grambow_continuous_benchmarking:_2019,
    title = {Continuous Benchmarking: Using System Benchmarking in Build Pipelines},
    booktitle = {Proceedings of the 1st Workshop on Service Quality and Quantitative Evaluation in new Emerging Technologies (SQUEET 2019)},
    author = {Grambow, Martin and Lehmann, Fabian and Bermbach, David},
    year = {2019},
    publisher = {IEEE}
}

A full list of our publications and prototypes is available on our group website.

License

The code in this repository is licensed under the terms of the MIT license.

How to use this Plugin

  1. Add a "Benchmark" build step. Specify the file path to the benchmark results. alt text

    The files can be located locally or on the Internet and can be available via http/https, as well as on an ftp server. Also in the second case it is important that the URL ends with the type (e.g. http://www.example.com/benchmark_results.csv). The file type must always be specified locally and on ftp as well. A CSV-file must be structured according to the following schema:

    metric name;value
    ExampleMetric1;40.1
    ExampleMetric2;-42.4
    
    • first line is optional and may be a header, which is ignored
    • all following lines must have exactly two columns separated by one semicolon ; or comma ,.
    • the first column specifies the name of the metric.
    • the second column specifies the value of the metric. Floating point values should use the dot .; a comma , is only allowed when semicolon ; is used as the field separator.

    Optional a line can be "name;[Build specific name]"

  2. "Benchmark Results" and "Benchmark Configuration" will be added to the project overview. alt text

  3. Specify the thresholds after the first run or by using the add button. alt text

  4. There is a detailed overview for each build. alt text

  5. The results are visualized for all builds in line diagrams. alt text

How the plugin can be used can be seen in our paper Continuous Benchmarking: Using System Benchmarking in Build Pipelines.

About

Jenkins plugin to load benchmark results in Jenkins and evaluate them. Make automated decisions about the success of a build based on benchmark results.

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors 4

  •  
  •  
  •  
  •  

Languages