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