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 官方 TS.INFO 文档;中文内容参考 Redis 文档许可。