TS.INFO

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

语法

TS.INFO key [DEBUG]

引入版本:1.0.0

复杂度摘要:O(1)

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

示例

必需参数

key

是时间序列的键名称。

可选参数

[DEBUG]

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

示例

Find information about a temperature/humidity time series by location and sensor type

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

127.0.0.1:6379> TS.CREATE 遥测:学习:温度 LABELS 房间学习类型温度 OK 127.0.0.1:6379> TS.CREATE 遥测:学习:湿度 LABELS 房间学习类型湿度 OK 127.0.0.1:6379> TS.CREATE 遥测:厨房:温度 LABELS 房间厨房类型温度 OK 127.0.0.1:6379> TS.CREATE 遥测:厨房:湿度标签房间厨房类型湿度 OK

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

127.0.0.1:6379> TS.INFO 遥测:厨房:温度 1)totalSamples 2)(整数)0 3)内存使用 4)(整数)4246 5)firstTimestamp 6)(整数)0 7)lastTimestamp 8)(整数)0 9)retentionTime 10)(整数) 0 11) chunkCount 12)(整数)1 13)chunkSize 14)(整数)4096 15)chunkType 16)压缩17)duplicatePolicy 18)(nil)19)标签20)1)1)“房间”2)“厨房”2)1)“类型”2)“温度”21)sourceKey 22) (nil) 23) 规则 24) (空数组)

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

127.0.0.1:6379> TS.INFO 遥测:厨房:温度调试 1)totalSamples 2)(整数)0 3)内存使用 4)(整数)4246 5)firstTimestamp 6)(整数)0 7)lastTimestamp 8)(整数)0 9)retentionTime 10) (整数)0 11)chunkCount 12)(整数)1 13)chunkSize 14)(整数)4096 15)chunkType 16)压缩17)duplicatePolicy 18)(nil)19)标签20)1)1)“房间”2)“厨房”2)1)“类型”2)“温度”21)sourceKey 22) (nil) 23) 规则 24) (空数组) 25) keySelfName 26) "遥测:厨房:温度" 27) 块 28) 1) 1) startTimestamp 2) (整数) 0 3) endTimestamp 4) (整数) 0 5) 样本 6) (整数) 0 7) 大小 8) (整数) 4096 9) 每个样本字节数 10) “inf”

Redis Software 与 Redis Cloud 兼容性

Redis
软件
Redis
Cloud
说明
✅ 支持
✅ 灵活且每年一次
✅ 免费和固定

返回值

RESP2

数组回复 包含有关时间序列的信息(以扁平名称-值对的形式):

名称
简单字符串回复
说明
totalSamples 整数回复
该时间序列中的样本总数
memoryUsage 整数回复
为该时间序列分配的总字节数,是以下各项的总和
- 用于存储该序列的配置参数(保留期、重复策略等)的内存
- 用于存储该序列的压缩规则的内存
- 用于存储该序列的标签(键值对)的内存
- 用于存储块的内存(块头 +压缩/未压缩数据)
firstTimestamp 整数回复
此时间序列中出现的第一个时间戳(Unix 时间戳,以毫秒为单位)
lastTimestamp 整数回复
该时间序列中存在的最后一个时间戳(Unix 时间戳以毫秒为单位)
retentionTime 整数回复
此时间序列的保留期(以毫秒为单位)
chunkCount 整数回复
此时间序列使用的块数
chunkSize 整数回复
每个新块的数据部分的初始分配大小(以字节为单位)。
实际块可能会消耗更多内存。更改块大小(使用 TS.ALTER)不会影响现有块。
chunkType 简单字符串回复
块类型:compressed 或 uncompressed
duplicatePolicy 简单字符串回复或无回复
该时间序列的重复政策
labels 数组回复或无回复
该时间序列的元数据标签
每个元素是(批量字符串回复, 批量字符串回复)的2元素数组回复,代表(标签,值)
sourceKey 批量字符串回复 或 无回复
源时间序列的键名称(如果当前序列是 压缩规则 的目标)
rules 本次时序中定义的数组回复
压实规则
每条规则都是一个数组回复,有4个元素:
- 批量字符串回复:压缩键
- 整数回复:存储桶时长
- 简单字符串回复:聚合器
- 整数回复:对齐(自 RedisTimeSeries v1.8 起)

当指定DEBUG时,响应还包含:

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

RESP3

地图回复 包含有关时间序列的信息。该映射包含与 RESP2 响应中描述的相同字段,但以映射结构而不是扁平数组中的键值对形式组织。

当指定 DEBUG 时,响应还包含附加的 keySelfName 和 Chunks 字段,如上所述。

参见

TS.RANGE | TS.QUERYINDEX | TS.GET

Redis时间系列

资料来源:Redis 官方 TS.INFO 文档;中文内容参考 Redis 文档许可。