Follow these steps to add New Relic as a Prometheus data source for Grafana.
You must complete the Prometheus remote-write integration process prior to beginning the configuration process.
These instructions detail how to complete the process when working with Grafana versions 6.7 and higher.
On New Relic, Create a new Insights query key.
Note: In Grafana, you'll need put this in a custom X-Query-Key HTTP header (see step 7 below), but it is the same entity as the New Relic Query key.
From the Grafana Home screen, go to Configuration > Data Sources and click Add data source.
From the Add data source screen under Time series databases options, select Prometheus.
Enter the Name you want to use for your new Prometheus data source.
Set the Default toggle to the on or off position, depending on whether you want this to be your default data source for Prometheus queries.
- Off: this is not your default data source
- On: this is your default data source
Enter the correct URL:
Under Custom Headers, select Add Header. Set the Header name to X-Query-Key. For the Value, enter to the Query key you created in step 1.
Click Save & Test.
If your graphs appear as groupings of dots and not as connected lines, you can change the graph style to display lines instead. To do this, go to Grafana's Graph panel and select Stacking and null value > connected.
New Relic strongly recommends using versions 6.7.x and higher to configure New Relic as a Prometheus data source. If you do chose to complete the configuration while running an earlier version, you will need to do one of the following to successfully configure your data source:
- Configure the new data source to use basic authentication and then enter the Query-key as the password in the basic authentication workflow.
- Configure the new data source URL to include the Query-key:
Headers are particularly important if you have connected multiple Prometheus servers to New Relic using the remote write integration. Here are some details about customization.
To delete a data source in Grafana:
- Go to Configuration > Data Sources.
- Click on the data source you want to delete.
- Click the Delete button at the bottom of the page.
If you need more help, check out these support and learning resources:
- Browse the Explorers Hub to get help from the community and join in discussions.
- Find answers on our sites and learn how to use our support portal.
- Run New Relic Diagnostics, our troubleshooting tool for Linux, Windows, and macOS.
- Review New Relic's data security and licenses documentation.