TSADD

Synopsis

TSADD key timestamp value [timestamp value ...] [EXPIRE_IN TTL] [EXPIRE_AT UNIX_TIMESTAMP]
This command sets the data for the given timestamp with the given value in the time series that is specified by key. This is useful in storing time series like data where the key could be a metric, the timestamp is the time when the metric was generated and value is the value of the metric at the given timestamp.

If the given `timestamp` already exists in the specified time series, this command overwrites the existing value with the given `value`.

If the given `key` does not exist, a new time series is created for the `key`, and the given values are inserted to the associated given fields.

If the given `key` exists, but is not of time series type, an error is raised.

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

`EXPIRE_IN TTL` sets the TTL (time-to-live) in seconds for the entries being added.

`EXPIRE_AT UNIX_TIMESTAMP` ensures that the entries added would expire by the given [`UNIX_TIMESTAMP`](https://en.wikipedia.org/wiki/Unix_time) (seconds since January 1, 1970).

Return value

Returns the appropriate status string.

Examples

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

"OK"

"OK"

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

"OK"

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

"OK"

"70"

"50"

"75"

Set a TTL of 3600 seconds (1 hour) for an entry that you add.

"OK"

Ensure that the entry we're adding would expire at the unix_timestamp 3513642307.

"OK"

See also

tsrem, tsget, tsrangebytime, tsrevrangebytime, tslastn, tscard