Authorized Reseller

AppFusions resells the products we work with. We are vendor approved in many Fortune 100 corporations.

Managed Hosting

Need secure managed hosting with flexibility and skilled expertise?

New Relic® for Atlassian JIRA®

Supports JIRA 6.3.x - 7.x

Documentation

The New Relic for Atlassian JIRA plugin allows you to track metrics in two categories: database items, and Java metrics. The metrics are sampled every 60 seconds.

Database items

This category of JIRA metrics are shown on JIRA’s Administration->System Info page. This plugin allows them to be shown in table form, or added to custom dashboards so that you can track them alongside other metrics from other sources. The metrics available to you are:

  • The number of projects defined in JIRA
  • The number of issues being tracked
  • The number of custom fields that have been defined
  • The number of workflows
  • The number of attachments that have been added to issues
  • The number of comments made against issues
  • The number of JIRA users
  • The number of JIRA groups

Java metrics

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

Installation

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

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

Obtaining and Installing a license

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

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

Support

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.