Query Inspector 是什么
Query Inspector 是 Grafana 面板级的排障入口,能查看面板真实发出的请求、数据源返回的原始数据与查询耗时。出现「无数据」、数值不符或加载很慢时,先用它把问题定位到查询层还是展示层,比反复刷新有效率得多。
基本信息
| 入口 | Panel 菜单 → Inspect → Query |
|---|---|
| Query 页 | 请求体:表达式、时间范围、步长 |
| Data 页 | 返回的原始数据帧 |
| Stats 页 | 查询耗时与数据量 |
| Panel JSON | 当前面板完整配置 |
| 适用范围 | 任意面板类型 |
典型使用场景
- 面板显示「无数据」,确认是查询为空还是数据源异常
- 图上数值与预期不符,核对返回数据与转换结果
- 看板加载慢,按 Stats 里的耗时定位是哪一段查询拖慢的
- 复制面板时变量没替换成功,用请求体检查实际下发的表达式
- 排查转换与覆盖配置的影响,对比 Data 页与最终渲染
- 导出面板 JSON 做版本对比,确认配置被谁改过
使用路径与分工
使用路径与分工
Panel 菜单 → Inspect → Query
Query:请求体(表达式/时间范围/步长)与响应
Data:返回的数据帧(原始序列/表)
Stats:查询耗时与数据量
Panel 菜单 → Inspect → Panel JSON:当前面板配置
排查顺序:请求 → 数据 → 转换/覆盖 → 显示看哪个标签页
| 现象 | 先看 | 判断依据 |
|---|---|---|
| 无数据 | Query | 请求体里的表达式是否正确 |
| 数值不符 | Data | 返回数据与转换结果是否一致 |
| 加载慢 | Stats | 每段查询的耗时与数据量 |
| 变量没生效 | Query | 请求体里变量是否被替换 |
| 配置被改动 | Panel JSON | 与已知版本的差异 |
数据正常而画面异常,问题多在 Transformations 与 Field overrides;请求层就异常,则回到查询表达式与数据源本身。
只看 Query 标签容易漏掉变换阶段的问题,核对数据要切到 Data 标签,那里能看到进入渲染前的真实数据帧。
耗时高先从查询复杂度与步长下手:反复刷新解决不了根因,优化查询或改用记录规则才是正解。
Query Inspector 能看到实际下发的表达式,是把看板问题与数据源问题分开的最快手段,也是提交问题工单时最有用的证据。