Home > YEDIS > API reference >

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-timeseries data, an error is raised.

If the given `timestamp` is not a valid signed 64 bit integer, an error is raised.

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"

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