{jenkins-plugin-info:pluginId=plot|jiraComponent=plot-plugin}

2.0.0 version of the plugin brings Jenkins Pipeline support. It might break compatibility if you update from 1.X versions, as it contains some API changes. Please test in non-production environment before update.

This plugin provides generic plotting (or graphing) capabilities in Jenkins.

This plugin will plot one or more single values variations across builds in one or more plots. Plots for a particular job (or project) are configured in the job configuration screen, where each field has additional help information. Each plot can have one or more lines (called data series). After each build completes the plots' data series latest values are pulled from Java properties file(s), CSV file(s), or XML file(s) via an XPath (which you should have generated during the build) somewhere below your workspace. Data for each plot is stored in a CSV file within the job's root project directory.

It can generate various kind of plots, including Area, Bar, Line, Stacked Bar, Waterfall...

Here is an example of the plots generated by this plugin:

Configuration

Currently supported parameters

The currently supported parameters are:

For a full list of parameters the best place to view is Plot.java class.

Example Usage to generate detailed PMD reports

Attached is a Perl script which generates more detailed "summaries" out of PMD report files. We use this for several code analysis projects, all named trunk.codeanalysis.prefix.

To have all resulting plots on one page, give all Plots the same plot group. Because each code quality has its very own range, define each on a separate plot, not as an additional data series.

Pipeline job configuration

You can generate the required Scripted Pipeline syntax via the Snippet Generator by choosing the "plot: Plot build data" step.

Below you can find sample configuration which is auto-generated using Snippet Generator.

plot csvFileName: 'plot-8e54e334-ab7b-4c9f-94f7-b9d8965723df.csv', 
        csvSeries: [[
                            file: 'data.csv',
                            exclusionValues: '',
                            displayTableFlag: false,
                            inclusionFlag: 'OFF',
                            url: '']],
        group: 'Plot Group',
        title: 'Plot Title',
        style: 'line',
        exclZero: false,
        keepRecords: false,
        logarithmic: false,
        numBuilds: '',
        useDescr: false,
        yaxis: '',
        yaxisMaximum: '',
        yaxisMinimum: ''

JIRA issues

If you have any proposals/bug reports, please create an issue on Jenkins JIRA.

Change Log

Version 2.1.0 (Jun 4, 2018) 
Version 2.0.5 (May 15, 2018) 
Version 2.0.4 (May 5, 2018) 
Version 2.0.3 (January 24, 2018) 
Version 2.0.2 (January 3, 2018) 
Version 2.0.0 (November 2, 2017) 
Version 1.11 (April 26, 2017) 
Version 1.9 (Mar 15, 2015)
Version 1.8 (Sep 28, 2014)
Version 1.7 (Mar 11, 2014)
Version 1.6 (Jan 16, 2014)
Version 1.5 (Jul 10, 2011)
Version 1.4 (Nov 21, 2010)
Version 1.3 (Jul 20, 2010)
Version 1.2 (Sep 24, 2008)