Send Prometheus Metric Data to New Relic

This page provides an overview of New Relic's Prometheus integration options and how they work. The information here will help you choose from among our options based on which one best fits your unique business needs.

We currently offer two integration options:

Prometheus remote write integration

The Prometheus remote write integration allows you to forward telemetry data from your existing Prometheus servers to New Relic. Once integrated, you can leverage the full range of options for setup and management, from raw data to queries, dashboards, and more.

Scale your data and get moving quickly

With the Prometheus remote write integration, you can:

  • Store and visualize crucial metrics on a single platform
  • Combine and group data across your entire software stack
  • Get a fully connected view of the relationship between data about your software stack and the behaviors and outcomes you’re monitoring
  • Connect your Grafana dashboards (optional).
View of a remote write dashboard screen after integration.
Prometheus remote write dashboard

How it works

Signup for New Relic is fast and free — we won't even ask for a credit card number. Once logged in, you can get data flowing with a few simple steps:

  1. Generate your remote_write URL.
  2. Add the new remote_write URL to the configuration file for your Prometheus server.
  3. Restart your Prometheus server.
  4. Check for your data.
  5. Query and explore!

Remote write compatibility and requirements

New Relic supports the Prometheus remote write integration for Prometheus versions 2.15.0 or newer.

Prometheus OpenMetrics integrations

New Relic’s Prometheus OpenMetrics integrations for Docker and Kubernetes allow you to scrape Prometheus endpoints and send the data to New Relic, so you can store and visualize crucial metrics on one platform.

With these integrations, you can:

  • Automatically identify a static list of endpoints.
  • Collect metrics that are important to your business.
  • Query and visualize this data in the New Relic UI.
  • Connect your Grafana dashboards (optional).
View of an OpenMetrics dashboard screen after integration.
Kubernetes OpenMetrics dash

Reduce overhead and scale your data

Collect, analyze, and visualize your metrics data from any source, alongside your telemetry data, so you can correlate issues all in one place. Out-of-the-box integrations for open-source tools like Prometheus make it easy to get started, and eliminate the cost and complexity of hosting, operating, and managing additional monitoring systems.

Prometheus OpenMetrics integrations gather all your data in one place, and New Relic stores the metrics from Prometheus. This integration helps remove the overhead of managing storage and availability of the Prometheus server.

To learn more about how to scale your data without the hassles of managing Prometheus and a separate dashboard tool, see New Relic's Prometheus OpenMetrics integration blog post.

Kubernetes

In a Kubernetes environment, New Relic automatically discovers the endpoints in the same way that the Prometheus Kubernetes collector does it. The integration looks for the prometheus.io/scrape annotation or label. You can also identify additional static endpoints in the configuration.

Docker

The Prometheus OpenMetrics integration gathers all your data in one place, and New Relic stores the metrics from Prometheus. This integration helps remove the overhead of managing storage and availability of the Prometheus server.

OpenMetrics integrations compatibility and requirements

For Kubernetes and Docker OpenMetrics integrations, you should be aware of the following compatibility and requirements information.

Kubernetes

New Relic has contributed the Prometheus integration to the open source community under an Apache 2.0 license. This integration supports Prometheus protocol version 2 and Kubernetes versions 1.9 or higher. The integration was tested using Kubernetes 1.9, 1.11, and 1.13 on kops, GKE, and minikube.

Limits apply to the metrics you send. For more details, see the New Relic metrics API documentation.

Recommendation: Always run the scraper with one replica. Adding more replicas will result in duplicated data.

Docker

New Relic has contributed the Prometheus integration to the open source community under an Apache 2.0 license. This integration supports Prometheus protocol version 2. The integration was tested using Docker 1.9, 1.11, and 1.13 on kops, GKE, and minikube.

Limits apply to the metrics you send. For details, see New Relic metrics API documentation.

What's next

Ready to get moving? Here are some suggested next steps:

For more help

If you need more help, check out these support and learning resources: