Track New Relic app metrics in Geckoboard

New Relic website: http://newrelic.com/

New Relic allows to you monitor, diagnose and tune web applications whether they're written in Ruby, Java, .NET, PHP or Python. This provides you with immediate insight from the end user's behavior, through servers, and down to individual lines of code.

(*) NOTE: Insights by New Relic are currently not supported by this integration.

 

In this article:

 

Add a New Relic widget to your dashboard


  1. Click Add Widget at the top right of your dashboard.
  2. On the page of Integrations, choose New Relic (or search for "New Relic" in the search box).
  3. Finally, select the type of New Relic widget you would like to add.

Back to top

Creating a connection and authenticating with New Relic


When you first add a New Relic widget to your Geckoboard dashboard, you will be asked to give the connection a name and provide the New Relic API key and account ID.

Here give the connection a name. It can be something straightforward such as 'New Relic', or if you plan to use more than one New Relic account you should name it something distinct to differentiate it from other accounts later.

API key:

  1. You'll need to use New Relic's REST API Key (and not the user account specific keys). To find the REST API key you will first need to activate API access. From the New Relic title bar, select Account settings (from the top right drop-down menu)

  2. Then select 'Data Sharing' from the left-hand side list under the 'Integrations' section. If your API key does not appear, select Enable API access.

  3. Copy the API key (highlighted in the image above) and navigate back to the Geckoboard 'Create a connection' page and paste it in the API key field:

Account ID:

  1. Your New Relic Account ID is found by looking at the address bar on the New Relic page. It is the number after '/accounts/'

  2. Copy this (highlighted in red above) into the Account ID field in the Geckoboard 'Create a connection' page:

Back to top

Types of New Relic widgets and example configurations


Chart types:

 Back to top

New Relic Highcharts

One feature of Geckoboard's integration with New Relic is the ability to embed other* New Relic charts into your dashboard using the New Relic Highcharts widget within Geckoboard. This makes it possible to add charts and visualizations you have access to in New Relic, but which are not possible with Geckoboard's out-of-the-box widgets.

To embed a chart:

  1. In New Relic, drill down in to the chart you wish to embed in your dashboard
  2. Hover over the chart and click the 'Embed' button that appears below and to the right of the chart
  3. You will then be asked of you wish to create a publicly accessible embed link for the chart. Much like Geckoboard's sharing URLs, these links will allow anybody who clicks them to view your data, however the link will not be 'discoverable' by search engines or other New Relic users unless you choose to share it publicly. 
  4. After confirming you want to create an embed link, a popup will appear that contains an embed code and a preview of the chart.

In order to add this New Relic Highcharts to your Geckoboard dashboard:

  1. Click Add Widget at the top right of your dashboard.
  2. On the page of Integrations, choose New Relic (or search for "New Relic" in the search box).
  3. Finally, select New Relic Highcharts
  4. If you haven't created a connection already, you will be asked to do so now. See the 'Creating a connection' section above.
  5. From New Relic, copy the embed code (underlined in red in the screenshot above) and then navigate back to your Geckoboard dashboard and paste the code into the 'New Relic URL' field
  6. Click 'Add widget' to save the configuration.

Your widget should now appear on your dashboard and contain the chart visible in the preview within New Relic.

Notes: 

  • To view a list of embed links that have been created in your New Relic account, open 'Tools' and then 'Embedded Charts' within your New Relic account.
  • More information on New Relic's embedding feature are available in their help article Embed: Creating iFrames for charts

Back to Chart types

Back to top

 

Number Stat

To set up your widget give it a title, choose a size, and select the application and metric to display.

 

Back to Chart types

Back to top

 

Metrics Trend Chart

To set up your widget give it a title, choose a size, and select the application, metric, field and period to display.

Back to Chart types

Back to top

 

Metrics Line Chart

To set up your widget give it a title, choose a size, and select the application, metric, field and period to display. As well, choose whether you would like to show a comparison period and mark an optional threshold value.

Back to Chart types

Back to top

 

Server Stats

To set up your widget give it a title, choose a size, and select the server and metric to display.

Back to Chart types

Back to top

 

Was this article helpful?
👍

Thank you for your feedback!