Documentation for JIRA 4.0. Documentation for other versions of JIRA is available too.

Skip to end of metadata
Go to start of metadata

The Bamboo Plan Summary Chart gadget displays a graphical summary of a Bamboo build plan from a particular Bamboo server.

What does it look like?

There are two graph types available with the Bamboo Plan Summary Chart gadget:

1. Group By Time Period

This graph displays the percentage of successful builds over time and the average duration of the builds in each time period:

2. Group By Build

This graph displays the duration of each of the builds and the number of failed tests per build.:

The Bamboo Plan Summary gadget will only be available to add to your dashboard if your JIRA administrator has configured the Bamboo plugin on your JIRA server. Also, if you have added multiple Bamboo servers in JIRA there will be one Bamboo Status gadget available per server, e.g. 'Bamboo Status Gadget from', 'Bamboo Status Gadget from', etc.

Adding the 'Bamboo Plan Summary Chart' gadget to your Dashboard

  1. Go to your JIRA dashboard and click 'Add Gadget'.
  2. The 'Gadget Directory' will appear. Locate the 'Bamboo Plan Summary Chart' gadget and click the 'Add it Now' button. Then click the 'Finished' button at the bottom of the Gadget Directory. The 'Bamboo Plan Summary Chart' gadget will appear on your dashboard as follows, ready for you to configure.
  3. Click the arrow in the top right corner of the gadget to open the configuration menu and click 'Edit'. Configure the Bamboo information to be displayed on your gadget as follows:
    • 'Select Plan' — Select the Bamboo plan for which you would like to show a summary.
    • 'Select Chart Type' — Select the chart which you would like displayed for the plan, i.e. 'Success Rate & Duration' by desired interval (group by time period) or 'Duration and Failed Tests' by build number (group by build).
    • 'Show Builds From' — Select how many days worth of builds you would like to include.
    • 'Refresh Interval' — Select how often you would like the information on the gadget to update.
  4. Click the 'Save' button.

To move the gadget to a different position on the dashboard, simply drag-and-drop. You can also change the look and behaviour of the gadget.

Configuring your Internet Explorer cache settings

If you use Internet Explorer, you will need to configure your browser to be able to print pages with charts correctly:

  1. Select 'Internet Options' from the 'Tools' menu:
  2. The 'Internet Options' window will display. Click the 'Settings' button in the 'Temporary Internet files' (i.e. cache) section:
  3. The 'Settings' window will display. Ensure that you have do not have the 'Every visit to the page' (i.e. no caching) option selected. If so, select the 'Automatically' option instead.

Authorising JIRA to Display Bamboo Gadgets

When you add this gadget to your JIRA dashboard, you may see a message similar to this:

The website (container) you have placed this gadget on is unauthorised. Please contact your system administator to have it approved.

To fix this problem, you will need to configure your Bamboo site to allow JIRA to draw information from it via gadgets on the JIRA dashboard. To do this, your JIRA administrator first needs to define your JIRA site as an OAuth consumer in Bamboo. You will then be required to perform a once-off authentication before your gadget will display correctly.