Monitor a Redis key
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Monitor a Redis key


Redmon requires a working Redis connection.

To install Redmon from pip,

  pip install redmon

Or from source,

  python install


Redmon connects to your Redis connection with the following environment variables. If none are set, default values are used.

  • REDMON_REDIS_HOST (default, localhost) : Set it to where your Redis is running from.
  • REDMON_REDIS_PORT (default, 6379) : Set it to where your Redis is running on.
  • REDMON_TIME_INT (default, 1.0) : Set refresh interval for your Redis key

Get Started

To watch a Redis key, just simply

  >> redmon monitor -k sample
  >> * Watching 'sample' every 1.0 seconds (Press CTRL+C to quit)
  >> 18:30:08 - 5
  >> 18:30:09 - 5
  >> 18:30:10 - 5

Redmon now watches a key called sample every second.

Setting Refresh Intervals

Changing the refresh interval for your monitor is very simple. You can either set it with an environment variable or by passing it as an argument.

REDMON_TIME_INT=2 redmon monitor -k sample
redmon monitor -k sample -i 2

Redmon now watches a key called sample every two seconds.

Intervals passed as arguments take precedence.

REDMON_TIME_INT=2 redmon monitor -k sample -i 3

Redmon now watches a key called sample every three seconds.

Setting Expected Value

You can set an expected value for your monitor, and Redmon will warn you when your key is not set to it.

redmon monitor -k sample -t 6

Now, Redmon will watch sample and expect its value to be 6. If it is not, Redmon will print its value in red.

Running Tests

Redmon uses pytest to write/run test cases. To run the test cases,

  cd tests


  1. Fork this repo
  2. [Clone] ( your newly forked repo
  3. Write relevant test cases
  4. Raise pull requests to swaathi/redmon

Coming Up

  • Monitor multiple keys
  • Set the values your Redis key should be compared against