The New Relic for Atlassian Bitbucket plugin allows you to track metrics in three categories: repository statistics, pull request statistics, and Java metrics. Sampling of those values is done every 60 seconds.

Repository statistics

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 repositories managed by Bitbucket
  • The total size (in bytes) of all repositories managed by Bitbucket

Pull request statistics

Pull requests are a highly valued feature of Atlassian Bitbucket, allowing programmers to submit code changes for review, and eventual merging, by other team members. The New Relic for Atlassian Bitbucket plugin presents high-level category counts of pull requests being managed by a particular server:

  • The number of open pull requests
  • The number of merged pull requests
  • The number of declined pull requests

Java metrics

This category includes a few Java internal metrics that are known to affect Bitbucket’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 Bitbucket 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 Bitbucket version 3.5.0 and later.
You will need System Administrator privileges on your Bitbucket 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 Bitbucket instance can be published to you New Relic account, your Bitbucket instance will need access to the Internet via SSL (HTTPS), and specifically the domain.


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

  2. Perform these steps to install the add-on in Bitbucket:
    a. Log into Bitbucket using an account that has System Administrator privileges.
    b. From the Bitbucket 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 Bitbucket. 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 Bitbucket configuration and license page. You can also get to that page by clicking the ‘New Relic for Bitbucket’ link under ‘APPFUSIONS ADD-ONS’ in the Bitbucket Administration area.

Obtaining and Installing a license

In order to activate the New Relic for Atlassian Bitbucket add-on, you must obtain a free license. Visit the plugin license and configuration page by clicking the ‘New Relic for Bitbucket’ link under ‘APPFUSIONS ADD-ONS’ in the Bitbucket 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 Bitbucket add-on

By installing a valid license, you will have gained access to the Configure tab for New Relic for Atlassian Bitbucket. 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.