To install the New Relic Prometheus OpenMetrics integration in a Docker environment:
- Create a configuration file
config.yaml. Use the example configuration file, or look at the
nri-prometheus-latest.yamlmanifest file, which includes the
nri-prometheus-cfgconfig map and an example configuration.
- Required: Add your and a cluster name to identify your Docker container.
- Add the endpoints to scrape; for example, add the
http://localhost:8080/metricsendpoint to collect metrics about the integration itself.
- Specify which metrics you want to ignore or include according to the prefixes for the metrics and labels. For more information, see the metrics filtering documentation.
Start the integration in the background:docker run -d --restart unless-stopped \--name nri-prometheus \-e LICENSE_KEY="YOUR_LICENSE_KEY" \-v "$(pwd)/config.yaml:/config.yaml" \newrelic/nri-prometheus:2.18.0
Confirm the container is running properly:docker ps -f "name=nri-prometheus"
Confirm that the integration has been configured correctly: Wait a few minutes, then go to the New Relic UI, and run this NRQL query to see if data has been reported:FROM Metric SELECT count(*) WHERE clusterName = 'YOUR_CLUSTER_NAME' since 1 hour ago
Did this doc help with your installation?
Update the integration
To update the Prometheus OpenMetrics integration, follow the procedures for Docker as applicable:
- Remove the Docker container.
- Follow standard installation procedures to start a new Docker container.
The integration logs its current version when it starts up. To determine the running version:
docker logs nri-prometheus 2>&1 | grep "Integration version"
time="2019-02-26T09:21:21Z" level=info msg="Starting New Relic's Prometheus OpenMetrics Integration version 1.0.0"
To uninstall the Prometheus OpenMetrics integration for Docker or Kubernetes, execute the following command:
docker rm -f nri-prometheus
Prometheus Open Metrics integration for Kubernetes has been discontinued and will only be supported until the end of June 2023.
Please, check the following page to understand the benefits of the Prometheus Agent and get a full visiblity of your Prometheus workloads running in a Kubernetes cluster.
In case you need to migrate from the Prometheus Open Metrics integration to Open Metrics check the following migration guide.