{"id":28089356,"url":"https://github.com/redistimeseries/prometheus-redistimeseries-adapter","last_synced_at":"2025-05-13T12:57:33.440Z","repository":{"id":34295227,"uuid":"157354185","full_name":"RedisTimeSeries/prometheus-redistimeseries-adapter","owner":"RedisTimeSeries","description":"Prometheus remote storage adapter for RedisTimeSeries","archived":false,"fork":false,"pushed_at":"2023-11-21T15:05:12.000Z","size":6587,"stargazers_count":35,"open_issues_count":33,"forks_count":11,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-05-07T23:35:15.378Z","etag":null,"topics":["prometheus","redis","timeseries"],"latest_commit_sha":null,"homepage":"https://redistimeseries.io","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RedisTimeSeries.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2018-11-13T09:28:27.000Z","updated_at":"2025-05-07T00:17:45.000Z","dependencies_parsed_at":"2023-02-19T01:01:37.881Z","dependency_job_id":"ae4d0d3e-6e33-46ad-8a2f-5c0a075b64e8","html_url":"https://github.com/RedisTimeSeries/prometheus-redistimeseries-adapter","commit_stats":{"total_commits":87,"total_committers":14,"mean_commits":6.214285714285714,"dds":0.5057471264367817,"last_synced_commit":"a6c67dfcf7638a5f83dddc0bd25c4b3fdc35c80c"},"previous_names":["redislabs/redis-ts-adapter","redislabs/prometheus-redis-ts-adapter"],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RedisTimeSeries%2Fprometheus-redistimeseries-adapter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RedisTimeSeries%2Fprometheus-redistimeseries-adapter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RedisTimeSeries%2Fprometheus-redistimeseries-adapter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RedisTimeSeries%2Fprometheus-redistimeseries-adapter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RedisTimeSeries","download_url":"https://codeload.github.com/RedisTimeSeries/prometheus-redistimeseries-adapter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253948349,"owners_count":21988953,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["prometheus","redis","timeseries"],"created_at":"2025-05-13T12:57:32.747Z","updated_at":"2025-05-13T12:57:33.428Z","avatar_url":"https://github.com/RedisTimeSeries.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![license](https://img.shields.io/github/license/RedisTimeSeries/redis-ts-adapter.svg)](https://github.com/RedisTimeSeries/redis-ts-adapter)\n[![Integration](https://github.com/RedisTimeSeries/prometheus-redistimeseries-adapter/actions/workflows/integration.yml/badge.svg)](https://github.com/RedisTimeSeries/prometheus-redistimeseries-adapter/actions/workflows/integration.yml)\n[![GitHub issues](https://img.shields.io/github/release/RedisTimeSeries/redis-ts-adapter.svg)](https://github.com/RedisTimeSeries/redis-ts-adapter/releases/latest)\n[![Go Report Card](https://goreportcard.com/badge/RedisTimeSeries/prometheus-redistimeseries-adapter)](https://goreportcard.com/report/RedisTimeSeries/prometheus-redistimeseries-adapter)\n\n# Prometheus-RedisTimeSeries Adapter\nRedis TimeSeries Adapter receives [Prometheus][prometheus] metrics via the \n[remote write][prometheus_remote_write], \nand writes to [Redis with TimeSeries module][redis_time_series].\n\n## QuickStart\nYou can tryout the Prometheus-RedisTimeSeries and RedisTimeSeries with Prometheus and Grafana in a single docker compose\n```bash\ncd compose\ndocker-compose up\n```\nGrafana can be accessed on port 3000 (admin:admin) Prometheus on port 9090\n\n## Getting Started\nto build the project:\n```bash\nmake build\ncd bin\n```\n\nTo send metrics to Redis, provide address in host:port format. \n```bash\nredis-ts-adapter --redis-address localhost:6379\n```\n\nTo receive metrics from Prometheus, Add [remote write][prometheus_remote_write_config] \nsection to prometheus configuration:\n```yaml\nremote_write:\n  - url: 'http://127.0.0.1:9201/write'\n```  \n\n## Makefile commands\nrun tests:\n```bash\nmake test\n```\ngo linting:\n```bash\nmake lint\n```\n### Redis Sentinel\nIf you have Redis Sentinel set up for high availability redis, use the `redis-sentinel` flags:\n```bash\nredis-ts-adapter --redis-sentinel-address localhost:26379 --redis-sentinel-master mydb\n```\n\n## Additional flags\n\nPrint help:\n```bash\nredis-ts-adapter --help\n```\n\nSet log level:\n```bash\nredis-ts-adapter --log.level debug\n```\n\nSet the timeout to use when sending samples to the remote storage:\n```bash\nredis-ts-adapter --send-timeout 60s\n```\nSet the listening port for prometheus to send metrics: \n```bash\nredis-ts-adapter --web.listen-address 127.0.0.1:9201\n```\n\n## Contributing\n[Contribution guidelines for this project](CONTRIBUTING.md)\n\n## Releases\nSee the [releases on this repository](https://github.com/RedisTimeSeries/prometheus-redistimeseries-adapter/releases).\n\n## Contributors\nSee also the list of [contributors](https://github.com/RedisTimeSeries/prometheus-redistimeseries-adapter/contributors) who participated in this project.\n\n## License\n\nSee the [LICENSE](LICENSE) file for details.\n\n## Acknowledgments\n\n* Thanks to the prometheus community for the awesome [prometheus project][prometheus], and for [the example adapter](https://github.com/prometheus/prometheus/tree/master/documentation/examples/remote_storage/remote_storage_adapter), that was adapted to this project.\n* Thanks to the [go-redis](https://github.com/go-redis/redis) community, for the golang redis client used here.\n* Thanks to [PurpleBooth](https://github.com/PurpleBooth) for [readme template](https://gist.github.com/PurpleBooth/109311bb0361f32d87a2)\n\n[prometheus]: https://prometheus.io\n[prometheus_remote_write]: https://prometheus.io/docs/prometheus/latest/storage/#remote-storage-integrations\n[prometheus_remote_write_config]: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#%3Cremote_write%3E\n[redis_time_series]: https://github.com/RedisLabsModules/redis-timeseries\n[project_github_url]: https://github.com/RedisTimeSeries/prometheus-redistimeseries-adapter/internal/redis_ts\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fredistimeseries%2Fprometheus-redistimeseries-adapter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fredistimeseries%2Fprometheus-redistimeseries-adapter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fredistimeseries%2Fprometheus-redistimeseries-adapter/lists"}