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.
Examine the benefits, reminders, and recommendations for each option below.
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.
- New Relic's database 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).
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:
- Generate your
remote_write
URL. - Add the new
remote_write
URL 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).
Kubernetes OpenMetrics dashboard
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.
OpenMetrics integrations compatibility and requirements
For Kubernetes and Docker OpenMetrics integrations, you should be aware of the following compatibility and requirements information.
What's next
Ready to get moving? Here are some suggested next steps:
- Read the how-to for completing the remote write integration.
- Read the how-to for completing the Prometheus OpenMetrics integration.
- Both integration options generate dimensional metrics that are subject to the same rate limits described in the Metric API.
- Learn about Grafana support options.
For more help
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 and and documentation.