Grafana查询RedisTimeSeries数据无返回：连接正常却无法获取数据

1. 核对键名的精确匹配 #

RedisTimeSeries键名大小写敏感，检查Grafana查询中的键名和Redis内实际键名是否完全一致（包括大小写、特殊字符）。可以在Redis-cli中执行TS.INFO <key>命令，确认目标键存在且包含数据点。

2. 检查时间范围匹配度 #

• 若测试数据是手动插入的历史数据（如几天前），但Grafana面板默认选择「最近15分钟」，会导致数据不在查询范围内。可切换时间范围为「自定义」，覆盖数据实际的时间区间。
• 确认RedisTimeSeries数据的时间戳单位：RedisTimeSeries支持秒/毫秒级Unix时间戳，若插入时用错单位（比如本该用毫秒却用了秒），数据会显示在错误的时间区间。执行TS.RANGE <key> - +命令查看数据的时间戳，对比Grafana的时间范围。

3. 验证查询语法正确性 #

RedisTimeSeries在Grafana中的查询需符合插件规范：

• 基础查询格式示例：TS.RANGE <key> $__timeFrom $__timeBucket，或带聚合函数的TS.AGGREGATION <key> avg $__interval $__timeFrom $__timeTo。
• 若使用标签过滤，确保标签键值对准确，比如TS.MRANGE $__timeFrom $__timeTo AGGREGATION avg $__interval FILTER host=server01，需通过TS.INFO <key>的labels字段确认标签存在。
• 避免给键名添加多余引号，比如不要写成TS.RANGE "temperature:server01" ...，Redis键名无需引号包裹。

4. 检查数据保留策略 #

若目标键设置了保留策略，超出保留时间的数据会被自动删除。执行TS.INFO <key>查看retentionTime字段，确认数据时间戳在保留范围内。

5. 验证插件与版本兼容性 #

检查RedisTimeSeries插件和Grafana版本是否兼容，旧版插件可能不支持新版RedisTimeSeries的查询语法，或新版Grafana对插件有新要求。可尝试将插件更新至最新稳定版，或回退到兼容版本。

6. 在Redis-cli中直接测试查询 #

将Grafana中的查询转换为Redis-cli可执行的命令，替换$__timeFrom和$__timeTo为实际时间戳（比如用date +%s获取当前秒级时间戳，减去3600得到一小时前的时间），示例：

TS.RANGE temperature:server01 1690000000 1690003600

如果该命令能返回数据但Grafana中不行，说明问题出在Grafana的查询参数替换或配置上；如果也返回空，说明Redis内的数据确实不在目标时间范围，或键名错误。

内容的提问来源于stack exchange，提问作者Classified