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.
Prometheus OpenMetrics or remote write integration?
We currently offer two integration options: Prometheus remote write integration and Prometheus OpenMetrics integration for Kubernetes or Docker. We recommend getting started with the remote write integration if you already have a Prometheus server install base. If you find it hard to manage your Prometheus cluster, or if you are getting started with integrating Prometheus Metrics, you should use OpenMetrics.
|Prometheus remote write integration||Prometheus OpenMetrics for Kubernetes or Docker|
|Keep in mind||
Regardless of the option you chose, with our Prometheus integrations:
- You can use Grafana or other query tools via New Relic's Prometheus' API.
- You benefit from more nuanced security and user management options as part of New Relic One.
- The New Relic Telemetry Data Platform can be the centralized long-term data store for all your Prometheus metrics, allowing you to observe all your data in one place.
- You can execute queries to scale, supported by New Relic.
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).
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:
- Generate your
- Add the new
remote_writeURL to the configuration file for your Prometheus server.
- Restart your Prometheus server.
- Check for your data.
- 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).
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.
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/scrapeannotation or label. You can also identify additional static endpoints in the configuration.
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.
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.
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.
Ready to get moving? Here are some suggested next steps:
- Read the how-to for completing the remote write integration.
- Learn about Grafana support options.
- Explore the range of other options available as part of the Telemetry Data Platform.