TS.INFO
语法
TS.INFO key [DEBUG]
- 可用版本
- Redis 开源版 / TimeSeries 1.0.0
- 时间复杂度
- O(1)
- ACL 分类
-
@timeseries,@read,@fast,
返回时间序列的信息和统计数据。
必需参数
key
时间序列的键名。可选参数
[DEBUG]
这是一个可选标志，用于获取关于数据块（chunk）的更详细信息。
返回值
数组回复 包含时间序列的信息（键值对）
| 名称 简单字符串回复 |
描述 |
|---|---|
totalSamples |
整数回复 此时间序列中的样本总数 |
memoryUsage |
整数回复 为此时间序列分配的总字节数，它是以下各项之和： - 用于存储时间序列配置参数（保留期、重复策略等）的内存 - 用于存储时间序列压缩规则的内存 - 用于存储时间序列标签（键值对）的内存 - 用于存储数据块（chunk）（数据块头 + 压缩/未压缩数据）的内存 |
firstTimestamp |
整数回复 此时间序列中存在的第一个时间戳（以毫秒为单位的 Unix 时间戳） |
lastTimestamp |
整数回复 此时间序列中存在的最后一个时间戳（以毫秒为单位的 Unix 时间戳） |
retentionTime |
整数回复 此时间序列的保留期，以毫秒为单位 |
chunkCount |
整数回复 此时间序列使用的数据块（chunk）数量 |
chunkSize |
整数回复 每个新数据块（chunk）数据部分的初始分配大小，以字节为单位。 实际数据块（chunk）可能会消耗更多内存。更改数据块（chunk）大小（使用 TS.ALTER）不会影响现有数据块。 |
chunkType |
简单字符串回复 数据块（chunk）类型： compressed 或 uncompressed |
duplicatePolicy |
简单字符串回复 或 Nil 回复 此时间序列的 重复策略 |
labels |
数组回复 或 Nil 回复 此时间序列的元数据标签 每个元素是一个包含 2 个元素的 数组回复，表示 (批量字符串回复, 批量字符串回复) 即 (标签, 值) |
sourceKey |
批量字符串回复 或 Nil 回复 如果当前时间序列是 压缩规则 的目标，则此字段为源时间序列的键名 |
rules |
数组回复 在此时间序列中定义的 压缩规则 每条规则是一个包含 4 个元素的 数组回复 - 批量字符串回复: 压缩键 - 整数回复: 桶持续时间 - 简单字符串回复: 聚合器 - 整数回复: 对齐方式（自 RedisTimeSeries v1.8 起） |
指定 DEBUG 时，响应还包含以下信息：
| 名称 简单字符串回复 |
描述 |
|---|---|
keySelfName |
批量字符串回复 键的名称 |
数据块（Chunk） |
数组回复 包含数据块（chunk）信息 每个元素是一个包含单个数据块（chunk）信息的 数组回复，信息为键(简单字符串回复)-值对形式 - startTimestamp - 整数回复 - 数据块（chunk）中存在的第一个时间戳- endTimestamp - 整数回复 - 数据块（chunk）中存在的最后一个时间戳- samples - 整数回复 - 数据块（chunk）中的样本总数- size - 整数回复 - 数据块（chunk）的内部数据大小（不含开销），以字节为单位- bytesPerSample - 批量字符串回复 (double) - 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 查询时间序列，以获取有关数据块（chunk）的更多信息。
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