TSLASTN

This page documents the preview (v2.21) version. Preview includes features under active development and is for development and testing only. For production, use the stable (v2024.1) version.

Synopsis

TSLASTN key N

This command fetches the latest N entries in the time series that is specified by the given key. The elements are returned in ascending order of timestamps.

  • If the given key is associated with non-time series data, an error is raised.
  • If the given N is not a positive 32 bit integer, an error is raised.

Return value

Returns a list of timestamp, value pairs for the latest N entries in the time series.

Examples

You can do this as shown below.

$ TSADD ts_key 10 v1 20 v2 30 v3 40 v4 50 v5
"OK"
$ TSLASTN ts_key 2
1) "40"
2) "v4"
3) "50"
4) "v5"
$ TSLASTN ts_key 3
1) "30"
2) "v3"
3) "40"
4) "v4"
5) "50"
6) "v5"
$ TSLASTN ts_key 9999999999
(error) ERR tslastn: limit field 9999999999 is not within valid bounds
$ TSLASTN ts_key 0
(error) ERR tslastn: limit field 0 is not within valid bounds
$ TSLASTN ts_key -1
(error) ERR tslastn: limit field -1 is not within valid bounds

See also

tsadd, tsget, tsrem, tsrangebytime, tsrangebytime, tscard