This Plugin provides to load benchmark data to Jenkins.
The plugin persists the data and decides on success or failure of the evaluated build. Therefor, 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 CSV and 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.
How to use this Plugin
1.) Add a "Benchmark" build step. Specify the file path to the benchmark results.
{width="577"
height="214"}
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 |
Optinal a line can be "name;[Build specific name]"
2.) "Benchmark Results" and "Benchmark Configuration" will be added to the project overview.
3.) Specify the thresholds after the first run or by using the add button.
- There is a detailed overview for each build.
- The results are visualized for all builds in line diagrams.
How the plugin can be used can be seen in our paper Continuous Benchmarking: Using System Benchmarking in Build Pipelines.