TSGET key timestamp

This command fetches the value for the given timestamp in the time series that is specified by the given key.

  • If the given key or timestamp does not exist, nil is returned.
  • If the given key is associated with non-time series data, an error is raised.
  • If the given timestamp is not a valid signed 64 bit integer, an error is raised.

Return value

Returns the value for the given timestamp.


The timestamp can be arbitrary integers used just for sorting values in a certain order.

$ TSADD cpu_usage 10 "70"
$ TSADD cpu_usage 20 "80" 30 "60" 40 "90"

We could also encode the timestamp as “yyyymmddhhmm”, since this would still produce integers that are sortable by the actual timestamp.

$ TSADD cpu_usage 201710311100 "50"

A more common option would be to specify the timestamp as the unix timestamp.

$ TSADD cpu_usage 1509474505 "75"
$ TSGET cpu_usage 10
$ TSGET cpu_usage 100
$ TSGET cpu_usage 201710311100
$ TSGET cpu_usage 1509474505

An error is returned when the timestamp is not an int64.

$ TSGET cpu_usage xyz
(error) Request was unable to be processed from server.

See also

tsadd, tsrem, tsrangebytime, tsrevrangebytime, tslastn, tscard