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
, etc.
Here is an example of the plots generated by this plugin:
The currently supported parameters are:
width (int, default: 750)
The width of the plot in pixels.height (int, default: 450)
The height of the plot in pixels.rightBuildNum (int, default: 2^38 - 1)
The right-most build number on the plot.hasLegend (boolean, default: true)
Whether or not the plot has a legend.urlNumBuilds (string, default: 2^38 - 1)
Number of builds back to show on this plot from URL.urlTitle (string, default: "")
Title of plot from URL.urlStyle (string, default: "")
Style of plot from URL.urlUseDescr (boolean, default: false)
Use description flag from URL.title (string, default: "")
Title of plot.yaxis (string, default: "")
Y-axis label.series (list)
List of data series.group (string)
Group name that this plot belongs to.numBuilds (string, default:"")
csvFileName (string, default: "$ROOT_DIR/plot-XXXX.csv")
csvLastModification (long, default: "last modified date")
The date of the last change to the CSV file.style (string, default: "line")
Style of plot: line, line3d, stackedArea, stackedBar, etc.useDescr (boolean, default: false)
Whether or not to use build descriptions as X-axis labels.keepRecords (boolean, default: false)
Keep records for builds that were deleted.exclZero (boolean, default: false)
Whether or not to exclude zero as default Y-axis value.logarithmic (boolean, default: false)
Use a logarithmic Y-axis.yaxisMinimum (string, default: "")
Minimum y-axis value.yaxisMaximum (string, default: "")
Maximum y-axis value.For a full list of parameters the best place to view is Plot.java class.
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: ''
If you have any proposals/bug reports, please create an issue on Jenkins JIRA.
See the Github releases page.
This is a backup of old release notes from wiki.
STACKED_AREA
in particular (JENKINS-50924).%name%
and %index%
replacements in the URL for XML files (http://stackoverflow.com/q/13271710/2654518).%build%
, build number placeholder.%name%
and %index%
replacements in the URL (http://stackoverflow.com/q/13271710/2654518).Uri.rawencode
instead of URLEncoder.encode
for Plot Group (JENKINS-7245, JENKINS-8143).