History

Julius Volz 099df0c5f0 Migrate "golang.org/x/net/context" -> "context" (#3333 ) In some places, where ctxhttp or gRPC are concerned, we still need to use the old contexts.		2017-10-24 21:21:42 -07:00
..
graphite	Merge branch 'master' into dev-2.0	2017-10-07 13:37:21 +02:00
influxdb	Merge branch 'dev-2.0' into go-kit/log	2017-09-15 23:15:27 +05:30
opentsdb	Migrate "golang.org/x/net/context" -> "context" (#3333 )	2017-10-24 21:21:42 -07:00
README.md	Correct example name to adapter. (#2590 )	2017-04-10 17:24:53 +01:00
main.go	logging: Port to common/promlog	2017-09-15 12:40:50 +05:30

README.md

Remote storage adapter

This is a write adapter that receives samples via Prometheus's remote write protocol and stores them in Graphite, InfluxDB, or OpenTSDB. It is meant as a replacement for the built-in specific remote storage implementations that have been removed from Prometheus.

For InfluxDB, this binary is also a read adapter that supports reading back data through Prometheus via Prometheus's remote read protocol.

Building

go build

Running

Graphite example:

./remote_storage_adapter -graphite-address=localhost:8080

OpenTSDB example:

./remote_storage_adapter -opentsdb-url=http://localhost:8081/

InfluxDB example:

./remote_storage_adapter -influxdb-url=http://localhost:8086/ -influxdb.database=prometheus -influxdb.retention-policy=autogen

To show all flags:

./remote_storage_adapter -h

Configuring Prometheus

To configure Prometheus to send samples to this binary, add the following to your prometheus.yml:

# Remote write configuration (for Graphite, OpenTSDB, or InfluxDB).
remote_write:
  - url: "http://localhost:9201/write"

# Remote read configuration (for InfluxDB only at the moment).
remote_read:
  - url: "http://localhost:9201/read"