This post was originally published on New Relic’s blog. I wrote this as part of a larger announcement of a partnership between New Relic and Grafana Labs which included this blog post on the New Relic blog of an interview with Lew Cirne, CEO of New Relic, and Raj Dutt, CEO of Grafana Labs; this blog post on the Grafana blog covering the same interview, this New Relic press release; the same press release made by Grafana; and a bunch of YouTube videos of the interview with Lew and Raj (video 1, video 2, video 3, and video 4).
Grafana is great — and it makes data look really good.
We’ve talked with plenty of you who use Grafana to visualize and alert on disparate data sets, and the general consensus is you love it. It’s easy to get up and running; it connects to a wide range of telemetry data stores; and it has plenty of official and community-built dashboards to get you started. Grafana is also open source, which is a bonus for us all.
You’ve spent years building dashboards in Grafana. You’ve come to rely on them, and you have no desire to lose them.
And we don’t want you to.
To that end, we’ve teamed up with Grafana Labs so you can use our Telemetry Data Platform as a data source for Prometheus metrics and surface them in your existing dashboards. Now you can keep Prometheus and Grafana and seamlessly tap into the additional reliability, scale, and security provided by New Relic.
A platform link from Prometheus to Grafana
Prometheus’ built-in remote write capability forwards metrics from your existing Prometheus servers to the Telemetry Data Platform, a fully managed, elastic, time-series platform. The Telemetry Data Platform gives you fully connected, global views of the relationships between all your data sources—from Prometheus metrics to application logs and distributed traces.
Setting up the Prometheus remote write integration and configuring the Telemetry Data Platform as a Prometheus data source in Grafana won’t interrupt your current experience. Your existing Grafana dashboards won’t change—they’ll just pull Prometheus data from New Relic. You can even build new ones with PromQL based data stored in New Relic.
How to configure the Telemetry Data Platform as a Prometheus data store in Grafana
In this two-step example, we’ll show you how to replace your Prometheus data store with the Telemetry Data Platform and add it as a Prometheus data source in Grafana. In the end, you’ll be able to send Prometheus data to New Relic, and Grafana will populate your existing Prometheus-specific dashboards with that data.
Note: This process requires Prometheus version 2.15.0 or higher and Grafana version 6.7.0 or higher. You’ll also need to sign up for New Relic.
Step 1: Get data flowing into New Relic with the Prometheus remote write integration
Enter a name for the Prometheus server you’re connecting to and generate your
Copy and add the generated
remote writesnippet (with URL) to your Prometheus configuration file (
prometheus.yml). A good place to add this information is under
global_config, at the same indentation level as the
globalsection.1# my global config2global:3scrape_interval: 15s # Set the scrape interval to every 15 seconds. Default is every 1 minute.4evaluation_interval: 15s # Evaluate rules every 15 seconds. The default is every 1 minute.5# scrape_timeout is set to the global default (10s).67remote_write:8- url: https://metric-api.newrelic.com/prometheus/v1/write?X-License-Key=[prometheus-demo-1 key]&prometheus_server=prometheus-demo-1
Restart your Prometheus server.
Click See your data.You should get a
“Data received successfully...”message, but it may take a few minutes to see your data in New Relic.
Boom! Now your Prometheus data is flowing into the Telemetry Data Platform.
For more information on how to set up the Prometheus remote write integration, check out our docs.
Step 2: Configure your Grafana dashboards to use Prometheus data stored in New Relic
When you switch to the Telemetry Data Platform as your Prometheus data store in Grafana, you can keep your Prometheus dashboards as they are—no need to lose or rebuild them. You just need to add the Telemetry Data Platform as a Prometheus data source.
- Generate a New Relic Query key. From the New Relic One home screen, click the More > Insights, and in the left-hand nav of Insights, click Manage data > API Keys.
- Click the + icon next to Query Keys, and in the Notes field, enter a short description of what you’re using the key for, click Save your notes.
- Click Show and copy your new API key, as you’ll need it later.
- From the Grafana home page, click Configuration > Data Sources. You should see your existing Prometheus data source. Click it to edit.
- Update the URL field of the data source based on your New Relic data region:
- Set the Access field to Server.
- Under Custom Headers, select Add Header. Set the Header value to X-Query-Key and add the API key you copied above.
- Click Save & Test.
You should get a
“Data source is working”message, and if you click Back, the URL in your Prometheus data source should reflect that it’s pointed at the Telemetry Data Platform.
- Navigate to your Prometheus dashboard. You should see Prometheus data from New Relic populating your charts.
Boom! Now your Prometheus data is being stored in New Relic and being used in Grafana for visualization. Easy. Not a single dashboard to rebuild.
For more information on how to configure New Relic as a Prometheus data source for Grafana, check out our docs.
Grafana Enterprise users: query all Telemetry Data Platform data from Grafana!
Why stop at Prometheus data? With the Telemetry Data Platform, you can ingest metrics, events, logs, and traces from any source, including Telegraf, OpenTelemetry, Logstash, and Kubernetes. Your Grafana dashboards can reflect it all.
If you use Grafana Enterprise, be sure to install the New Relic data source plugin. With this plugin, you can use the New Relic query language (NRQL) to query metrics, logs, and traces from other data sources you’ve stored in the Telemetry Data Platform. Use those NRQL results to build telemetry dashboards in Grafana Enterprise.
Check out the Grafana Labs blog post about the plugin for more information.
Grafana Labs and New Relic—better together
Given the rate of innovation and diversity of technology, making real, impactful observability tooling will require collaboration in areas where competition has traditionally existed. We’re excited about this collaboration with Grafana Labs, and we’re excited to bring observability to everyone. When you’re ready to get started, sign up for a Grafana Enterprise trial, and get those dashboards populated.