prometheus/documentation/examples/remote_storage/remote_storage_adapter
Tariq Ibrahim 8fdfa8abea refine error handling in prometheus (#5388)
i) Uses the more idiomatic Wrap and Wrapf methods for creating nested errors.
ii) Fixes some incorrect usages of fmt.Errorf where the error messages don't have any formatting directives.
iii) Does away with the use of fmt package for errors in favour of pkg/errors

Signed-off-by: tariqibrahim <tariq181290@gmail.com>
2019-03-26 00:01:12 +01:00
..
graphite General simplifications (#3887) 2018-02-26 07:58:10 +00:00
influxdb refine error handling in prometheus (#5388) 2019-03-26 00:01:12 +01:00
opentsdb refine error handling in prometheus (#5388) 2019-03-26 00:01:12 +01:00
README.md Correct example name to adapter. (#2590) 2017-04-10 17:24:53 +01:00
main.go update promlog to latest version (#4876) 2018-11-23 14:22:40 +01:00

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"