xe-nvdk/rtcollector: A modular, RedisTimeSeries-native observability agent. Designed for developers, tinkerers, and infrastructure teams who want full control over metrics collection, without the bloat.

A modular, RedisTimeSeries-native observability agent.
Designed for developers, tinkerers, and infrastructure teams who want full control over metrics collection, without the bloat.

rtcollector is a lightweight, plugin-based agent for collecting system and application metrics, and pushing them to RedisTimeSeries.

It works like Telegraf, but is designed specifically for the Redis Stack ecosystem.

Think of it as your Redis-native observability layer: simple, fast, hackable.

Because most modern observability agents:

• Are too bloated or overkill for smaller projects or edge deployments
• Assume you’re using Prometheus, InfluxDB, or Elastic
• Lack good support for RedisTimeSeries as a first-class output
• Why not?

rtcollector was born out of the need for:

✅ Something modular
✅ Configurable with a YAML file
✅ Built with RedisStack in mind
✅ Small enough to embed anywhere (VMs, Docker, homelabs, edge devices)

• ⏱️ Collect metrics at configurable intervals
• 📦 Modular input plugins (Linux CPU, Mem, Disk, etc.)
• 🚀 Push metrics to RedisTimeSeries (via TS.ADD)
• ⚙️ Fully YAML-configurable. No code changes needed to enable/disable plugins
• 📚 Built with Python and easy to extend
• 💻 Support for MacOS and Linux
• 🏷️ Label-based key creation with per-host and per-core tags
• 🐞 Debug logging and one-shot execution support
• 🐳 Docker metrics via container stats and engine info
• 🕒 Per-plugin timing with slow detection and warning indicators

interval: 5
hostname: atila
retention: 86400000
debug: true
once: false

inputs:
  - linux_cpu
  - linux_mem
  - docker:
      endpoint: "unix:///var/run/docker.sock"
      gather_services: false

outputs:
  - redistimeseries:
      host: localhost
      port: 6379

• DevOps engineers running Redis Stack
• Homelab enthusiasts
• IoT builders using RedisTimeSeries
• Anyone who wants a custom, no-bloat collector for metrics

This project is just getting started, contributions, ideas, and PRs are more than welcome!

To get started:

1. Fork this repo
2. Clone your fork
3. Create a branch (git checkout -b my-feature)
4. Commit your changes (git commit -am 'Add feature')
5. Push to the branch (git push origin my-feature)
6. Open a pull request

This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).

You are free to use, modify, and distribute this code , as long as you open source any changes and make your source code available if you deploy a modified version as a network service.

Keep your files stored safely and securely with the SanDisk 2TB Extreme Portable SSD. With over 69,505 ratings and an impressive 4.6 out of 5 stars, this product has been purchased over 8K+ times in the past month. At only $129.99, this Amazon’s Choice product is a must-have for secure file storage.

Help keep private content private with the included password protection featuring 256-bit AES hardware encryption. Order now for just $129.99 on Amazon!

Help Power Techcratic’s Future – Scan To Support

If Techcratic’s content and insights have helped you, consider giving back by supporting the platform with crypto. Every contribution makes a difference, whether it’s for high-quality content, server maintenance, or future updates. Techcratic is constantly evolving, and your support helps drive that progress.

As a solo operator who wears all the hats, creating content, managing the tech, and running the site, your support allows me to stay focused on delivering valuable resources. Your support keeps everything running smoothly and enables me to continue creating the content you love. I’m deeply grateful for your support, it truly means the world to me! Thank you!