TS.INFO
Syntax
TS.INFO key [DEBUG]
- Available in:
- Redis Stack / TimeSeries 1.0.0
- Time complexity:
- O(1)
返回时间序列的信息和统计信息。
必需的参数
key
is key name of the time series.
可选参数
[DEBUG]
是一个可选标志,用于获取有关块的更详细信息。
返回值
Array reply 包含有关时间序列的信息(名称-值对):
| 名称 Simple string reply |
描述 |
|---|---|
totalSamples |
Integer reply 此时间序列中的样本总数 |
memoryUsage |
Integer reply 为该时间序列分配的总字节数,其总和包括 - 用于存储序列配置参数(保留期、复制策略等)的内存 - 用于存储序列压缩规则的内存 - 用于存储序列标签(键值对)的内存 - 用于存储块(块头 + 压缩/未压缩数据)的内存 |
firstTimestamp |
Integer reply 此时间序列中的第一个时间戳(Unix时间戳,以毫秒为单位) |
lastTimestamp |
Integer reply 此时间序列中的最后时间戳(Unix时间戳,以毫秒为单位) |
retentionTime |
Integer reply 该时间序列的保留时间,以毫秒为单位 |
chunkCount |
Integer reply 用于此时间序列的块数 |
chunkSize |
Integer reply 每个新块的数据部分的初始分配大小,以字节为单位。 实际块可能会消耗更多内存。更改块大小(使用 TS.ALTER)不会影响现有的块。 |
chunkType |
Simple string reply 块类型: compressed 或 uncompressed |
duplicatePolicy |
Simple string reply 或 Nil reply 该时间序列的 重复策略 |
labels |
Array reply 或 Nil reply 此时间序列的元数据标签 每个元素是一个2元素的 Array reply,表示(标签,值)的 (Bulk string reply, Bulk string reply) |
sourceKey |
Bulk string reply 或 Nil reply 如果当前序列是压缩规则的目标,则为源时间序列的键名 |
rules |
Array reply Compaction rules 定义在这个时间序列中 每个规则是一个包含4个元素的 Array reply: - Bulk string reply: 压缩键 - Integer reply: 桶持续时间 - Simple string reply: 聚合器 - Integer reply: 对齐(自 RedisTimeSeries v1.8 起) |
当指定DEBUG时,响应还包含:
| 名称 Simple string reply |
描述 |
|---|---|
keySelfName |
Bulk string reply 键的名称 |
Chunks |
Array reply 包含有关块的信息 每个元素是一个Array reply,包含有关单个块的信息,以名称(Simple string reply)-值对的形式呈现: - startTimestamp - Integer reply - 块中存在的第一个时间戳- endTimestamp - Integer reply - 块中存在的最后一个时间戳- samples - Integer reply - 块中的样本总数- size - Integer reply - 块的内部数据大小(不包括开销),以字节为单位- bytesPerSample - Bulk string reply (double) - size 和 samples 的比率 |
示例
Find information about a temperature/humidity time series by location and sensor type
创建一组传感器来测量您书房和厨房的温度和湿度。
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