RedisTimeSeries数据导入Grafana查询无返回的故障问询

当前业务流程：

• 将RedisTimeSeries格式的数据存储在Docker部署的Redis实例中，通过RedisInsight CLI可正常访问该数据（参考界面：RedisInsight CLI访问数据页）
• 已在Grafana中成功将Redis添加为数据源（参考界面：Grafana Redis数据源配置页）
• 已完成对应可视化仪表盘的导入操作（参考界面：Grafana仪表盘导入页）

现存异常：

• 在Grafana仪表盘加载数据时，查询始终处于无响应状态（参考界面：Grafana查询无响应页）
• 在Grafana内置CLI查询模式下，使用全时间范围参数- +或指定起止时间戳的TS.RANGE命令查询时，无任何结果返回（参考界面：Grafana内TS.RANGE查询无结果页）
• 完全相同的TS.RANGE命令，在原生Redis CLI中可正常返回查询结果，仅在Grafana的查询链路中失效

按照故障出现概率从高到低排序，依次检查以下配置项：

1. Grafana Redis数据源连接配置校验 #

• 检查数据源绑定的Redis账号权限：登录Redis实例执行ACL GETUSER <Grafana绑定的账号名>，确认命令权限列表中包含TS.RANGE、TS.MRANGE、TS.INFO等时序查询相关命令，无规则拦截上述命令的执行。
• 核对数据源配置的*Redis逻辑库（db index）*参数：Docker部署的Redis默认逻辑库为db0，需保证Grafana数据源配置的db号，和Redis CLI查询数据时使用的db号完全一致，避免跨库检索不到时序键。
• 逐行对比RedisInsight和Grafana的连接参数：检查Grafana数据源是否错误开启了TLS加密、Sentinel/Cluster模式选项，而实际Redis实例为无加密的单机部署，这类配置会出现连接校验通过但实际命令被静默拦截的问题。

2. 查询参数适配性检查 #

• 校验时间戳单位配置：RedisTimeSeries的TS.RANGE命令默认接受毫秒级时间戳，需确认Grafana数据源配置中设置的时间戳单位和存储数据的时间戳单位完全匹配，可在Grafana CLI中执行最简命令TS.RANGE <目标时序键名> 0 -1，若返回空结果但原生Redis CLI返回正常，即为单位不匹配问题。
• 核对查询的键名匹配规则：若仪表盘配置的查询使用了通配符键名，可在Grafana CLI中执行SCAN 0 MATCH <键名匹配模式>，验证是否能检索到目标时序键，排除通配符规则写错的问题。
• 简化查询参数验证链路：去掉查询中的聚合、降采样参数，执行最基础的TS.RANGE <目标时序键名> - +，确认基础查询链路是否连通，排除错误聚合配置导致的空结果问题。

3. 版本兼容性校验 #

• 核对Grafana官方Redis数据源插件版本与Docker部署的RedisTimeSeries模块的兼容性：v2.x版本以下的Redis插件不支持新版本RedisTimeSeries的命令语法，会出现命令发送后无响应的问题，需将插件升级到最新稳定版，或回退RedisTimeSeries模块到插件适配的版本。
• 检查Redis实例的redis.conf配置，确认TS.RANGE、TS.MRANGE等核心查询命令没有被rename-command配置重命名，避免Grafana发送的原命令无法被Redis识别。

4. 网络链路排查 #

• 若Grafana同样为Docker容器部署，需检查容器间的网络连通性：虽然Grafana数据源页面显示连接成功，但可能存在防火墙、安全组拦截命令响应包的问题，可进入Grafana容器内部执行redis-cli -h <Redis容器地址> -p <端口> ping，验证是否能收到PONG响应，再执行完整的TS.RANGE命令，排查网络层丢包问题。
• 筛选Grafana服务日志中Redis数据源相关的报错，重点定位“command not allowed”、“timeout”、“invalid syntax”类报错，对应调整配置即可定位根因。

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