TSGET

Synopsis

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.

Examples

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

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

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"
"OK"

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

$ TSADD cpu_usage 1509474505 "75"
"OK"
$ TSGET cpu_usage 10
"70"
$ TSGET cpu_usage 100
(nil)
$ TSGET cpu_usage 201710311100
"50"
$ TSGET cpu_usage 1509474505
"75"

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