Plugins 〉New Relic
New Relic Data Source
- Template variables
- Metric names
- Metric values
- Metric names
- Metric values
- Ad-hoc filters
- Not currently supported
- Add the data source; filling out the fields for your personal API key/user API key and account ID.
- Metrics: for querying New Relic APM via New Relic's REST API.
- Insights: for querying New Relic Insights via NRQL.
You can combine plain text with the following variables:
|Metric name||CPU/User time|
…to produce custom output. For example:
Server: $__nr_server Metric: $__nr_metric
Templates and Variables
- Create a template variable for your dashboard.
- Select the "Query" type.
- Select the "New Relic" data source.
- Formulate a query using relative REST API endpoints (excluding file extensions).
List of available applications:
List of available metrics for an application:
In order to improve the writing experience when creating NRQL queries, the editor supports predefined macros:
[[timeFilter]]) will interpolate to
SINCE <from> UNTIL <to>based on your dashboard's time range.
SELECT average(value) FROM $event_template_variable $__timeFilter TIMESERIES
For further hints on how to use macros and template variables, refer to the editor's help section.
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, please use template variables because you will be able to select the entity name instead of ID. For example, to filter events for a particular application, create a variable
which retrieves a list of apps and uses it as an Entity ID filter.
Application ID is required field.
Installing New Relic on Grafana Cloud:
Installing plugins on a Grafana Cloud instance is a one-click install; same with updates. Cool, right?
For more information, visit the docs on plugin installation.
Installing on a local Grafana:
For local instances, plugins are installed and updated via a simple CLI command. Plugins are not updated automatically, however you will be notified when updates are available right within your Grafana.
1. Install the Data Source
Use the grafana-cli tool to install New Relic from the commandline:
grafana-cli plugins install
The plugin will be installed into your grafana plugins directory; the default is /var/lib/grafana/plugins. More information on the cli tool.
Alternatively, you can manually download the .zip file for your architecture below and unpack it into your grafana plugins directory.
Alternatively, you can manually download the .zip file and unpack it into your grafana plugins directory.
2. Configure the Data Source
Accessed from the Grafana main menu, newly installed data sources can be added immediately within the Data Sources section.
Next, click the Add data source button in the upper right. The data source will be available for selection in the Type select box.
To see a list of installed data sources, click the Plugins item in the main menu. Both core data sources and installed data sources will appear.
[2.1.1] - 2021-4-12
- Chore: Update SDK
[2.1.0] - 2021-03-25
- [#283]: Replace Metric Select dropdown with Cascader
- [#285]: Remove deprecated admin key from Config Editor
- [#290]: Fix interpolate template variables for metric values
- [#293]: Allow custom label to be created for metric values
- [#286]: Return error for Insights query and health check with invalid credentials
[2.0.19] - 2021-02-10
- [#270]: NRQL Queries fail against metric table
- [#276]: Aliases no longer work
- [#278]: Value field not a multiselect, and when selecting '--remove--' the value stays as the actively selected item
- [#258]: Health check succeeds even if one of the API Keys is bad
- [#252]: New Relic: support for Insights query when query length > 4k characters
[2.0.18] - 2020-12-14
- Changed the metric selector to only show results when the user starts typing
[2.0.17] - 2020-12-14
- Updated config editor to allow empty Admin API keys now that the Admin API key and Personal API key have merged
[2.0.16] - 2020-11-19
- Fixed insights query change event sending a string instead of a query object
[2.0.15] - 2020-11-17
- Fixed issue where an unnecessary query was being ran whenever the datasource was selected
- Added the ability to "Remove" or "Reset" the "metric" selection dropdown
- Changed the default query method to "metricData" from "sourceList"
[2.0.14] - 2020-11-17
- Fixed issue where unnecessary queries were being sent before the form was completely filled out
- Fixed issue where metrics were not displaying
[2.0.13] - 2020-11-09
- Fixed issue where querying many applications causes performance issues
[2.0.12] - 2020-11-06
- Fix issue where errors were not being logged
[2.0.11] - 2020-11-04
- Fix caching issue
[2.0.10] - 2020-11-04
- Client side caching experimental/temporary feature
[2.0.9] - 2020-11-02
- Fixed issue with parsing the datasource settings
[2.0.8] - 2020-11-02
- Removed application list in healthcheck
- Upgraded newrelic-client-go to v0.47.3
- Updated framing logic
[2.0.7] - 2020-07-23
- Fix for additional time range bug
[2.0.6] - 2020-07-23
- Fix for metric data time range
- Fix for hide/show data in query editor
[2.0.5] - 2020-07-21
- Fix compatibility issues with previous single values:
- metric, value are now metrics and values (arrays) to support multi-value template variables
[2.0.4] - 2020-07-14
- Fix multi-value template variables in insights queries
[2.0.3] - 2020-06-10
- Fix template variables with insights queries
[2.0.2] - 2020-06-02
- fix release process
[2.0.1] - 2020-06-01
- Fix for query editor not releasing the cursor #197
- Better handling in queries for null return values
[2.0.0] - 2020-05-18
- Works with Grafana 7+
- Supports alerting
- Alias now supports "$__nr_metric" and "$__nr_metric_value"
- NRQL supported in template variables
- Authentication switched to using "admin key" and "personal key"
[1.4.0] - 2020-03-27
- Update components to fix insight query bug (issue #101)
[1.3.0] - 2019-04-18
- Upgrade of Slate component to make the plugin compatible with Grafana 6.4. Breaking change so is not backward compatible with previous versions of Grafana
[1.2.0] - 2019-04-18
- Multi-value variables support
- Query editor styles in Grafana 6
- Panel refresh on search field blur
- Queries with percentiles
[1.1.0] - 2019-03-27
- Support queries with percentiles
- Queries with FACET keyword and without TIMESERIES
- Plugin tries to pull metric list from APM in Insights mode
[1.0.0] - 2018-09-25
- Support for annotations for Insights API
- Improved NRQL query editor with intellisense
[0.4.1] - 2018-08-02
- Support queries without TIMESERIES
[0.4.0] - 2018-08-01
- Support for NewRelic Insights API
- NRQL query editor with intellisense
[0.3.4] - 2018-03-29
- Able to get application deployments as annotation
[0.3.3] - 2018-03-05
- Replace variables in metric find query
[0.3.2] - 2017-11-13
- Optional name filters for apps/servers/plugins in template variable editor
- Filter apps/servers/plugins by name on the NewRelic side (add filter param to API calls)
- Template variable rendering in selection dropdown
[0.2.1] - 2017-05-22
- Add data source (with default name
New Relic) automatically when configure app, #2
- JSON.parse error when using variable with single value selected as metric
[0.2.0] - 2017-05-17
What’s new in Grafana Enterprise Metrics 1.3, our scalable, self-hosted Prometheus service
Blog post 5 min
Introducing the new Open Distro for Elasticsearch plugin for Grafana, also available in Amazon Managed Service for Grafana
Blog post 3 min
Want to visualize software development insights with Grafana? With our new Jira Enterprise plugin, you can!
Blog post 5 min
A closer look at the admin API and plugin for centralized tenant adminstration and control in Grafana Enterprise Logs
Blog post 4 min
The new Splunk Infrastructure Monitoring plugin brings the SaaS formerly known as SignalFx to your Grafana dashboards
Blog post 5 min
The Splunk plugin for Grafana now supports data links for jumping directly from logs to traces
Blog post 5 min
With the new AWS IoT SiteWise plugin, you can visualize and monitor your equipment data in Grafana dashboards
Blog post 2 min