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

The Bamboo Charts gadget displays various charts and plan statistics from a particular Bamboo server.

What does it look like?

The Bamboo Charts gadget should appear as follows on the dashboard:

Screenshot: 'Bamboo Charts' gadget

The Bamboo Charts 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 Charts gadget available per server, e.g. 'Bamboo Charts Gadget from http://172.20.5.83:8085', 'Bamboo Charts Gadget from http://172.19.6.93:8085', etc.

Adding the 'Bamboo Charts' gadget to your Dashboard

  1. Go to your JIRA dashboard and click 'Add Gadget'.
  2. The 'Gadget Directory' will appear. Locate the 'Bamboo Charts' gadget and click the 'Add it Now' button. Then click the 'Finished' button at the bottom of the Gadget Directory. The 'Bamboo Charts' 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 Report Type' — Select the Bamboo report that you would like to display as a chart.
    • 'Select Plans' — Select the plans that you would like included in the chart.
    • 'Group By' — Select the time interval to group by in your chart.
    • '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.

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.