RedisTimeSeries quick start tutorial

For this quick start tutorial, you need:

• Either:

  • A Redis Cloud database with the RedisTimeSeries module

    You can set up a free Redis Cloud database to see the module in action.

  • A Redis Enterprise Software database with the RedisTimeSeries module

• redis-cli with connectivity to a redis database

Quick start with redis-cli

After you set up RedisTimeSeries, you can interact with it using redis-cli.

Here we’ll create a time series representing sensor temperature measurements. After you create the time series, you can send temperature measurements. Then you can query the data for a time range on some aggregation rule.

With redis-cli

Connect to redis.

$ redis-cli -p 12543
127.0.0.1:12543>

Run these commands:

127.0.0.1:12543> TS.CREATE temperature RETENTION 60 LABELS sensor_id 2 area_id 32
OK
127.0.0.1:12543> TS.ADD temperature:3:11 1548149181 30
OK
127.0.0.1:12543> TS.ADD temperature:3:11 1548149191 42
OK
127.0.0.1:12543>  TS.RANGE temperature:3:11 1548149180 1548149210 AGGREGATION avg 5
1) 1) (integer) 1548149180
   2) "30"
2) 1) (integer) 1548149190
   2) "42"

Client libraries

Some languages have client libraries that provide support for RedisTimeSeries commands: