TS.INFO

语法
TS.INFO key 
  [DEBUG]
可用:
Redis 堆栈 / TimeSeries 1.0.0
时间复杂度:
O(1)

返回时间序列的信息和统计信息。

例子

必需参数

key是时间序列的键名称。

可选参数

[DEBUG]

是一个可选标志,用于获取有关 chunk 的更多详细信息。

返回值

Array reply 包含有关时间序列(名称-值对)的信息:

名称
简单字符串回复
描述
totalSamples Integer reply
此时间序列中的样本总数
memoryUsage Integer reply
为此时间序列分配的字节总数,即 -
用于存储序列配置参数(保留期、复制策略等)的内存
- 用于存储系列压缩规则
的内存 - 用于存储系列标签的内存(键值对)
- 用于存储 chunk 的内存(chunk header + 压缩/未压缩数据)
firstTimestamp Integer reply
此时间序列中存在的第一个时间戳(Unix 时间戳,以毫秒为单位)
lastTimestamp Integer reply
此时间序列中存在的最后一个时间戳(Unix 时间戳,以毫秒为单位)
retentionTime Integer reply
此时间序列的保留期(以毫秒为单位)
chunkCount Integer reply
用于此时间序列的块数
chunkSize Integer reply
每个新块的数据部分的初始分配大小(以字节为单位)。
实际块可能会消耗更多内存。更改块大小(使用
TS.ALTER) 不会影响现有块。
chunkType 简单的字符串回复
chunks 类型:
compresseduncompressed
duplicatePolicy Simple string replyNil reply
此时间序列的重复策略
labels 数组回复零回复
此时间序列
的元数据标签 每个元素都是一个 2 元素 数组回复Bulk string replyBulk string reply) 代表 (label, value)
sourceKey 批量字符串回复Nil 回复
源时间序列的键名称(如果当前序列是压缩规则的目标)
rules 数组回复
此时间序列
中定义的压缩规则 每个规则都是一个包含 4 个元素的数组回复
- 批量字符串回复:压缩键
- 整数回复:存储桶持续时间
- 简单字符串回复:聚合器
- 整数回复:对齐方式(自 RedisTimeSeries v1.8 起)

什么时候DEBUG指定,则响应还包含:

名称
简单字符串回复
描述
keySelfName 批量字符串回复
键的名称
Chunks Array reply with information about the chunk
每个元素都是 name(Simple string reply)-value 对中单个 chunk 信息的 Array reply

- startTimestamp - Integer reply - 块中存在的第一个时间戳
- endTimestamp - Integer reply - 区块中存在的最后一个时间戳
- samples - Integer reply — 数据块中的样本总数
- size - Integer reply - 块的内部数据大小(无开销),以字节为单位
- bytesPerSample - 批量字符串回复 (double) - 比率sizesamples

例子

按位置和传感器类型查找有关温度/湿度时间序列的信息

创建一组传感器来测量书房和厨房的温度和湿度。

127.0.0.1:6379> TS.CREATE telemetry:study:temperature LABELS room study type temperature
OK
127.0.0.1:6379> TS.CREATE telemetry:study:humidity LABELS room study type humidity
OK
127.0.0.1:6379> TS.CREATE telemetry:kitchen:temperature LABELS room kitchen type temperature
OK
127.0.0.1:6379> TS.CREATE telemetry:kitchen:humidity LABELS room kitchen type humidity
OK

Find information about the time series for temperature in the kitchen.

127.0.0.1:6379> TS.INFO telemetry:kitchen:temperature
 1) totalSamples
 2) (integer) 0
 3) memoryUsage
 4) (integer) 4246
 5) firstTimestamp
 6) (integer) 0
 7) lastTimestamp
 8) (integer) 0
 9) retentionTime
10) (integer) 0
11) chunkCount
12) (integer) 1
13) chunkSize
14) (integer) 4096
15) chunkType
16) compressed
17) duplicatePolicy
18) (nil)
19) labels
20) 1) 1) "room"
       2) "kitchen"
    2) 1) "type"
       2) "temperature"
21) sourceKey
22) (nil)
23) rules
24) (empty array)

Query the time series using DEBUG to get more information about the chunks.

127.0.0.1:6379> TS.INFO telemetry:kitchen:temperature DEBUG
 1) totalSamples
 2) (integer) 0
 3) memoryUsage
 4) (integer) 4246
 5) firstTimestamp
 6) (integer) 0
 7) lastTimestamp
 8) (integer) 0
 9) retentionTime
10) (integer) 0
11) chunkCount
12) (integer) 1
13) chunkSize
14) (integer) 4096
15) chunkType
16) compressed
17) duplicatePolicy
18) (nil)
19) labels
20) 1) 1) "room"
       2) "kitchen"
    2) 1) "type"
       2) "temperature"
21) sourceKey
22) (nil)
23) rules
24) (empty array)
25) keySelfName
26) "telemetry:kitchen:temperature"
27) Chunks
28) 1)  1) startTimestamp
        2) (integer) 0
        3) endTimestamp
        4) (integer) 0
        5) samples
        6) (integer) 0
        7) size
        8) (integer) 4096
        9) bytesPerSample
       10) "inf"

See also

TS.RANGE | TS.QUERYINDEX | TS.GET

RedisTimeSeries


RATE THIS PAGE
Back to top ↑