首页/云/可观测性速查/Query Inspector:面板排障入口
Grafana 与看板53 条

Query Inspector:面板排障入口

查看面板真实发出的请求、返回的原始数据与查询耗时:出现“无数据”或数值不符时,先用它把问题定位到查询层还是展示层。

可观测性速查云更新于 2026-10-13

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 能看到实际下发的表达式,是把看板问题与数据源问题分开的最快手段,也是提交问题工单时最有用的证据。

易错点

  • 只看 Query 标签容易漏掉变换阶段的问题,数据核对要切到 Data 标签
  • 耗时高先从查询复杂度与步长下手,反复刷新解决不了根因
  • 面板变量未替换时请求体里会留下原始写法,不看请求体会一直误以为是数据源问题
  • 以为「面板报错」等于「数据源宕机」,其实多数情况只是表达式或时间范围写错
  • 拿看板问题去问数据源团队前,先导出一份 Panel JSON 与请求体,能省掉大量往返沟通

数据来源与参考

  • Grafana 官方文档 · Query Inspector
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌