redislabs/prometheus-redistimeseries-adapter

![CircleCI]([] ![Go Report Card]([]

Prometheus-RedisTimeSeries Adapter

Redis TimeSeries Adapter receives Prometheus metrics via the remote write, and writes to https://github.com/RedisLabsModules/redis-timeseries.

QuickStart

You can tryout the Prometheus-RedisTimeSeries and RedisTimeSeries with Prometheus and Grafana in a single docker compose

bash
cd compose
docker-compose up

Grafana can be accessed on port 3000 (admin:admin) Prometheus on port 9090

Getting Started

to build the project:

bash
make build
cd bin

To send metrics to Redis, provide address in host:port format.

bash
redis-ts-adapter --redis-address localhost:6379

To receive metrics from Prometheus, Add remote write section to prometheus configuration:

yaml
remote_write:
  - url: 'http://127.0.0.1:9201/write'

Makefile commands

run tests:

bash
make test

go linting:

bash
make lint

Redis Sentinel

If you have Redis Sentinel set up for high availability redis, use the redis-sentinel flags:

bash
redis-ts-adapter --redis-sentinel-address localhost:26379 --redis-sentinel-master mydb

Additional flags

Print help:

bash
redis-ts-adapter --help

Set log level:

bash
redis-ts-adapter --log.level debug

Set the timeout to use when sending samples to the remote storage:

bash
redis-ts-adapter --send-timeout 60s

Set the listening port for prometheus to send metrics:

bash
redis-ts-adapter --web.listen-address 127.0.0.1:9201

Contributing

Contribution guidelines for this project

Releases

See the https://github.com/RedisTimeSeries/prometheus-redistimeseries-adapter/releases.

Contributors

See also the list of https://github.com/RedisTimeSeries/prometheus-redistimeseries-adapter/contributors who participated in this project.

License

See the LICENSE file for details.

Acknowledgments

• Thanks to the prometheus community for the awesome prometheus project, and for https://github.com/prometheus/prometheus/tree/master/documentation/examples/remote_storage/remote_storage_adapter, that was adapted to this project.
• Thanks to the https://github.com/go-redis/redis community, for the golang redis client used here.
• Thanks to https://github.com/PurpleBooth for https://gist.github.com/PurpleBooth/***bb0361f32d87a2