Plugin Information

Global build stats plugin will allow to gather and display global build result statistics.
It is a useful tool allowing to display global hudson build trend over time.

Requirements

Global build stats plugin requires Hudson 1.339 or higher.

Installation

To install Global build stats Plugin, Go to the "plugin management" section in the administration Panel.
Latest released version will be available. Install it from there (you should need to restart Hudson after that).

To verify that the plugin is well installed, go to the Administration panel : you should see an icon with mister Hudson and a graph on it :

Then you can click it and access the global build stats config panel.

Usage

The global build stats config panel is made of 4 sections :

• Basic shortcuts to other sections
• Charts displaying global build statistics & configuration (update & delete)
• Build statistic configuration (creation)
• Data initialization
  

Basic shortcuts to other sections

These shortcuts allows to jump fastly to other sections, especially on sections 3 (creation of chart) & 4 (data initialization)

Data Initialization

If you click on this button, all of your existing persisted build results will be gathered.
This is particularly useful to initialize statistics in a first step.

Take into account the following only if you are using a 0.1-alphaX version of global-build-stats plugin (for greater versions, data are merged and thus, never lost) :
Beware : this should be done only once because :

• Statistics are automatically updated after each build
• "not recoverable" statistics (for example, if you check the "delete old builds" checkbox on job configuration) will be lost if you click this button

Build stats Chart Creation

In this section, you can create a new Build Stats Chart.
Here are the different parameters :

• Chart title : Title displayed on top of the Chart
• Chart size : Width & Height (in pixels) of the created chart
• Chart Scale : Unit of chart X axis. Either Year, Month, Week, Day or Hour.
• Chart Length : Number of steps on X axis.
• Job filtering : Either All jobs (no filtering) or a job name regex
• Statuses filtering : Success, Failures, Unstables, Aborted or Not Build builds

All fields are mandatory. Chart's width, height & length should be integers.
If the server-side validation fails, Graph will not be created (and no message will be displayed - for the moment -)

Build stats Chart display

This section displays every persisted Chart Configurations.
You can, too, edit, delete or move up/down these graphs.
Graphs are created using REST-like URL so that you can export this URLs into your favourite Portal or CMS.
A chart example can be seen below :

Product backlog

Future version(s)

Features :
Allows to filter on selected hudson slaves
(done, reduced by half thanks to xstream aliases) Optimize global-build-stats.xml file size (1.5Mo for 8600 build results)
(done ?) Fix encoding of special characters ("é" for example)
Record build duration and create duration charts
Internationalize plugin
Actions in chart listing should be made with AJAX (no more refresh !)
(done) Allow security de-activation for global build stats chart listing
Allow to change y-axis unit to percent
(done) In build search results, provide a link to direct console output for a build number
In build search results, allow to limit number of results (radio button allowing "unlimited" and "limited to XXX results")
If possible, provide tooltips on chart, displaying the 10 first job names matching with the current hovered region
Switch "unstables" and "aborted" colors (unstables=yellow, aborted=pink) to fit with standard hudson display

Releases

0.2 (July, 4th, 2010)

Fixed bugs

• Bug: Hour reset lead to 00h instead of 12h

Improvements

• Global build search engine allowing to select several search criteria concerning build results and display search results
• Chart can be clicked : it will list selected builds category on clicked year/month/week/day/hour
• Change date displayed on chart depending on selected scale (time axis' height is largely lowered !)

0.1 (June, 13th, 2010)

Fixed bugs

• Fixed rootUrl problem in checkUrls AJAX validation
• Fixed vertical axis size in charts
• Synchronized blocks whenever data are recorded in order to prevent plugin from ConcurrentModificationException (plugin is now thread safe)
• "\" are now allowed in your job name regexes

Improvements

• Hudson version 1.339 is now required
• Secured chart listing screen : Administer rights needed
• Added HOURLY_FROM_NOW, DAILY_FROM_NOW, WEEKLY_FROM_NOW, MONTHLY_FROM_NOW and YEARLY_FROM_NOW chart scales.
  Beware : pre-1.0 YEARLY, MONTHLY and WEEKLY scales were acting the same as post-1.0 YEARLY_FROM_NOW, MONTHLY_FROM_NOW and WEEKLY_FROM_NOW.
  If you want to keep your chart as if it were in pre-1.0, you should update these scales !
• Improved color used
• Provided backward compatibility of BuildStatConfiguration (with 1.0-alpha1 release)
• Data initialization is now made via AJAX submission
• Data initialization now merges read data with existing data : you won't lose data anymore !
• "not build" status is unchecked by default
• Added icons instead of buttons for chart actions (delete/edit/move up/move down)

0.1-alpha4 (March, 13th, 2010)

AJAX Form validation enabled

0.1-alpha3 (March, 1st, 2010)

Fixed bug : If checkbox are unchecked, build stat config is not added
Some precision : if chart doesn't appear after form submission, check your fields : all are mandatory (except for checkboxes which can be unchecked), width & heigth & length should be integers

0.1-alpha2 (March, 1st, 2010)

Minimum Hudson version downgraded from 1.339 to 1.321
Chart persistence implemented.
Create/Update/Delete multiple chart build configurations.
Added job name filtering.
Changed displayed date pattern on chart.
Server-side form validation is done .... but nothing is displayed on the user side (due of lack on knowledge on form validation ... see 0.1 roadmap to see how this will be handled in the future)

0.1-alpha1 (February, 21th, 2010)

First release.
Contained only a unique chart and the possibility to initialize build stats from existing build results.
Chart is contructed in a RESTly way that is to say you can provide GEt parameters to the chart.
No Chart persistence implemented.