New Relic

ApplicationPREMIUM

The official New Relic app from Grafana Labs

Premium plugins, along with support and assistance from the core team behind Grafana, are available with all Grafana Support subscriptions. Starting at just $80 per month.

Please sign up or log in to get started.

Sign Up

New Relic App

This is an app to install and configure the datasource for use with the New Relic APM (application performance monitoring).

Configuration

After installing New Relic plugin, go to Plugins -> Apps, choose New Relic plugin and enable it. Then add your New Relic's REST API key, which you can generate from INTEGRATIONS -> API keys page in your New Relic account settings.

App config

Data source with name New Relic will be added automatically.

Usage

Query Editor

Query editor is very simple, just select metric source type (Application, Server or Plugin are supported), select needed app, server or component (plugin), then choose metric and value.

query editor

simple graph

Aliases

New Relic plugin supports advanced alias patterns and special variables. Default alias is $__nr_metric: $__nr_metric_value, but you can rewrite it using these variables:

Variable              Description             Example
$__nr_metric          Metric name             CPU/User time
$__nr_metric_value    Metric values           average_value
$__nr_application     Application name
$__nr_server          Server name
$__nr_component       Plugin name

Combine plain text with variables to set desired alias, for example: Server: $__nr_server Metric: $__nr_metric.

Templating

New Relic data source support template variables. You can fetch different type of data for using as template variable values. First, you can get list of available applications, servers or plugins:

applications or applications/ - list of applications
servers or servers/ - list of servers
components or components/ - list of components (plugins)

Templating_1

Also, you can pull list of available metrics from particular application, server or component. Use these formats:

applications/{application_id}/metrics/
servers/{application_id}/metrics/
components/{application_id}/metrics/

For example, servers/62535318/metrics/. It isn't so useful to write id's of your apps or servers, so better to combine these endpoints with first type of variables, for example:

Variable       Query
$app           applications
$appMetrics    applications/$app/metrics

By this way you can choose application and get list of metrics in $appMetrics variable.

Multi-value variables support

You can set your variable as multi-value. These variables are supported in Metric and Value fields. So you can select several metrics using one query.

Multi-value variable

Annotations

Annotations allows to get alert events from New Relic and display it on graphs.

Annotations editor

Select your New Relic data source and set additional filters. Without any filters set all events will be returned. If you want to filter events by Entity ID, better to use template variables because in this case you can select entity name instead of ID. For example, to filter events for particular application create a variable $app which retrieves a list of apps and use it as Entity ID filter.

Install Plugin

Version

Dependencies:
  • Grafana ^3.0.1