benchmark-evaluator-plugin

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

https://github.com/jenkinsci/benchmark-evaluator-plugin

Science Score: 31.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
  • DOI references
  • Academic publication links
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (15.0%) to scientific vocabulary
Last synced: 10 months ago · JSON representation ·

Repository

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

Basic Info
Statistics
  • Stars: 4
  • Watchers: 3
  • Forks: 6
  • Open Issues: 3
  • Releases: 1
Created over 7 years ago · Last pushed over 1 year ago
Metadata Files
Readme License Citation

README.md

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

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.

Owner

  • Name: Jenkins
  • Login: jenkinsci
  • Kind: organization
  • Location: United States of America

Jenkins is an open source automation server with an unparalleled plugin ecosystem to support practically every tool as part of your delivery pipelines

Citation (CITATION.bib)

@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}
}

GitHub Events

Total
  • Delete event: 2
  • Issue comment event: 2
  • Pull request event: 6
  • Create event: 2
Last Year
  • Delete event: 2
  • Issue comment event: 2
  • Pull request event: 6
  • Create event: 2

Issues and Pull Requests

Last synced: 10 months ago

All Time
  • Total issues: 0
  • Total pull requests: 3
  • Average time to close issues: N/A
  • Average time to close pull requests: about 1 year
  • Total issue authors: 0
  • Total pull request authors: 1
  • Average comments per issue: 0
  • Average comments per pull request: 0.67
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 2
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 1
  • Average comments per issue: 0
  • Average comments per pull request: 0.0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
Pull Request Authors
  • dependabot[bot] (9)
  • strangelookingnerd (4)
Top Labels
Issue Labels
Pull Request Labels
dependencies (9) java (5)

Dependencies

pom.xml maven
  • com.google.code.gson:gson 2.8.6
  • org.jenkins-ci.plugins:structs 1.10
  • org.json:json 20201115
  • org.jenkins-ci.plugins.workflow:workflow-api 2.23.1 test
  • org.jenkins-ci.plugins.workflow:workflow-basic-steps 2.6 test
  • org.jenkins-ci.plugins.workflow:workflow-cps 2.41 test
  • org.jenkins-ci.plugins.workflow:workflow-durable-task-step 2.17 test
  • org.jenkins-ci.plugins.workflow:workflow-job 2.15 test
  • org.jenkins-ci.plugins.workflow:workflow-step-api 2.13 test
  • org.jenkins-ci.plugins.workflow:workflow-support 2.16 test