TS.INFO

语法
TS.INFO key 
  [DEBUG]
可用于
Redis Stack / 时间序列 1.0.0
时间复杂度
O(1)

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

示例

必填参数

键是时间序列的键名。

可选参数

[调试]

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

返回值

数组回复，包含有关时间序列的信息（键值对）

名称
简单字符串回复		 描述
totalSamples 整数回复
此时间序列中的样本总数
memoryUsage 整数回复
为此时间序列分配的总字节数，它是以下内存的总和：
- 用于存储序列配置参数（保留时间、重复策略等）的内存
- 用于存储序列压缩规则的内存
- 用于存储序列标签（键值对）的内存
- 用于存储块（块头 + 压缩/未压缩数据）的内存
firstTimestamp 整数回复
此时间序列中存在的第一个时间戳（以毫秒为单位的 Unix 时间戳）
lastTimestamp 整数回复
此时间序列中存在的最后一个时间戳（以毫秒为单位的 Unix 时间戳）
retentionTime 整数回复
此时间序列的保留时间（以毫秒为单位）
chunkCount 整数回复
为此时间序列使用的块数
chunkSize 整数回复
每个新块的数据部分的初始分配大小（以字节为单位）。
实际块可能会占用更多内存。更改块大小（使用 TS.ALTER）不会影响现有块。
chunkType 简单字符串回复
块类型：压缩 或 未压缩
duplicatePolicy 简单字符串回复 或 空回复
此时间序列的 重复策略
labels 数组回复 或 空回复
此时间序列的元数据标签
每个元素都是一个包含 2 个元素的 数组回复，表示（块字符串回复，块字符串回复），分别代表（标签，值）
sourceKey 块字符串回复 或 空回复
如果当前序列是 压缩规则 的目标，则为源时间序列的键名
rules 数组回复
在此时间序列中定义的 压缩规则
每个规则都是一个包含 4 个元素的 数组回复
- 块字符串回复：压缩键
- 整数回复：桶持续时间
- 简单字符串回复：聚合器
- 整数回复：对齐方式（自 RedisTimeSeries v1.8 起）

当指定 DEBUG 时，响应还包含

名称
简单字符串回复		 描述
keySelfName 块字符串回复
键的名称
Chunks 数组回复，包含有关块的信息
每个元素都是一个 数组回复，包含有关单个块的信息，以名称(简单字符串回复)-值对的形式
- startTimestamp - 整数回复 - 块中存在的第一个时间戳
- endTimestamp - 整数回复 - 块中存在的最后一个时间戳
- samples - 整数回复 - 块中的样本总数
- size - 整数回复 - 块的内部数据大小（不含开销），以字节为单位
- bytesPerSample - 批量字符串回复 (双精度浮点数) - size 和 samples 的比率

示例

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

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

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

查找厨房温度的时间序列信息。

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)

使用 DEBUG 查询时间序列，以获取有关块的更多信息。

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"

另请参见

TS.RANGE | TS.QUERYINDEX | TS.GET

RedisTimeSeries


RATE THIS PAGE
Back to top ↑