Documentation

Prometheus

This page documents an earlier version of InfluxDB. InfluxDB v2.7 is the latest stable version.

Prometheus remote read and write API support

InfluxDB support for the Prometheus remote read and write API is experimental for both Prometheus and InfluxDB. Prometheus documentation states that their remote_read and remote_write configuration settings are “experimental: breaking changes to configuration are likely in future releases.”

InfluxDB support for the Prometheus remote read and write API adds the following two HTTP endpoints to the InfluxDB httpd handler:

  • /api/v1/prom/read
  • /api/v1/prom/write

Configuration

To enable the use of the Prometheus remote read and write API with InfluxDB, you need to add URL values to the following settings in the Prometheus configuration file:

Example (Prometheus configuration):

# Remote write configuration (for Graphite, OpenTSDB, or InfluxDB).
remote_write:
  - url: "http://localhost:8086/api/v1/prom/write?u=paul&p=foo&db=prometheus"
# Remote read configuration (for InfluxDB only at the moment).
remote_read:
  - url: "http://localhost:8086/api/v1/prom/read?u=paul&p=foo&db=prometheus"

You can use query parameters to pass in the database to write data to and optional user and password.

Note: Including the password in the config file is not ideal. See Prometheus issue: “Support for environment variable substitution in configuration file”.


Was this page helpful?

Thank you for your feedback!


Set your InfluxDB URL

Introducing InfluxDB 3.0

The new core of InfluxDB built with Rust and Apache Arrow. Available today in InfluxDB Cloud Dedicated.

Learn more

State of the InfluxDB Cloud Serverless documentation

The new documentation for InfluxDB Cloud Serverless is a work in progress. We are adding new information and content almost daily. Thank you for your patience!

If there is specific information you’re looking for, please submit a documentation issue.