New Relic for Atlassian Bamboo

The New Relic for Atlassian Bamboo plugin allows you to track metrics in six categories: agent metrics, build metrics , indexing metrics, threading metrics, plugin metrics, and Java metrics. Sampling of those values is done every 60 seconds.

Agent metrics

This plugin allows you to view the statistics below in table form, or to add them to custom dashboards so that you can track them alongside metrics from other sources. The metrics available to you are:

  • The number of local agents
  • The number of remote agents
  • Ths number of on-line elastic agents
  • For each active and enable agent:
    • the average build duration for that agent; and
    • the average queuing time for that agent.

Build metrics

These metrics include:

  • The number of enabled build plans
  • The number of build result summaries

Indexing metrics

Re-indexing build result summaries is a relatively heavy-weight server process. To help you guage the level of indexing activity, the following metrics are provided:

  • How long will it take to reindex all build results
  • How many documents all indexes have in total

Thread metrics

Bamboo runs tasks in background threads. The plugin presents the following thread-related metrics:

  • How many threads are currently executing
  • The maximmum number of threads
  • The number of runnables that are waiting to be run

Plugin metrics

There’s not much to report here, since plugins vary in their internal use of system resources. The plugin simply reports the number of plugins that are enabled.

Java metrics

This category includes a few Java internal metrics that are known to affect Bamboo’s performance. Although a much more comprehensive view of the Java Virtual Machine (JVM) internals would be provided by New Relic’s APM product, in many cases, a more coarse-grained view is sufficient for basic Bamboo server health monitoring. The included metrics are:

  • The number of available processors
  • The amount of memory used by Java
  • The amount of free memory available
  • The total amount of server memory

Plugin requirements

This plugin is compatible with Atlassian Bamboo version 5.6.0 and later.
You will need System Administrator privileges on your Bamboo instance in order to install the add-on for that platform, and configure it with your New Relic account details.
In order that metrics about your Bamboo instance can be published to you New Relic account, your Bamboo instance will need access to the Internet via SSL (HTTPS), and specifically the domain.


  1. Download the Bamboo add-on from the AppFusions download page. The Bamboo add-on is supplied as a file with a .obr extension.

  2. Perform these steps to install the add-on in Bamboo:
    a. Log into Bamboo using an account that has System Administrator privileges.
    b. From the Bamboo menu bar click Administration (the cog icon) -> Add-ons.
    c. Click Manage add-ons.
    d. Click Upload add-on.
    e. Click Choose File and use the resulting file browser to select the .obr file that you downloaded earlier.
    f. Click Upload. The add-on will be installed in Bamboo. When it has finished being installed, a dialog will appear indicating that the installation was successful.
    g. In the installation completion dialog box, click Configure. This will take you to the New Relic for Atlassian Bamboo configuration and license page. You can also get to that page by clicking the ‘New Relic for Bamboo’ link under ‘APPFUSIONS ADD-ONS’ in the Bamboo Administration area. Follow the instructions below for licensing and configuring the New Relic for Atlassian Bamboo plugin.

Obtaining and Installing a license

In order to activate the New Relic for Atlassian Bamboo add-on, you must obtain a free license. Visit the plugin license and configuration page by clicking the ‘New Relic for Bamboo’ link under ‘APPFUSIONS ADD-ONS’ in the Bamboo Administration area.

Click Request a License, and follow the instructions for obtaining a license for the plugin.

When you have obtained your license, simply copy-and-paste the license key into the License panel, where you see ‘Paste your license key here’. Then click Install.

Configuration of the Bamboo add-on

By installing a valid license, you will have gained access to the Configure tab for New Relic for Atlassian Bamboo. On that tab, click the Add a New Relic Account button. A dialog box will appear, with spaces for an account name and a license key.

The account name

You can enter any name that is meaningful to you into the Account name field - it’s only used to remind you which account you’ve set up.

The license key

You must copy-and-paste your New Relic license key, which you will find on the Account settings page on the New Relic website.
When you have filled in those fields, click Add account. The dialog box will close, and a new row will appear in the New Relic Accounts table.
You can add as many New Relic accounts as you like; metrics will be posted to each of those accounts at the same time.


AppFusions provides support for this plugin. To view frequently-asked questions, or to find out how to contact an AppFusions support person, visit the support page.