首页/云/可观测性速查/Table 面板:清单与明细
Grafana 与看板53 条

Table 面板:清单与明细

表格适合展示实例清单、版本分布、TopN 明细:Prometheus 查询选项把 Format 切到 Table,配合整理字段与表内过滤完成巡检视图。

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

Table 面板是什么

Table 面板把查询结果按行列展示,适合实例清单、版本分布、TopN 明细这类「清单型」需求。把 Prometheus 查询的 Format 切到 Table 后,返回的标签会变成列,再配合字段整理、表内过滤排序与单元格类型,就能拼出实用的巡检视图。

基本信息

适用场景清单、明细、TopN
数据格式Query options → Format = Table
列控制Field overrides 逐列调整
表内操作排序、过滤、列宽
单元格类型color text / gauge / sparkline 等
常用搭档Transformations 做合并与重命名

典型使用场景

  • 列出所有实例与版本,核对是否有漏升级的机器
  • 展示错误率 TopN 接口,直接给出待排查清单
  • 查看各队列的积压量,按数值降序排列
  • 给表格加 Data links,点击行直接跳到日志或链路页面
  • 用颜色单元格把超阈值行标红,巡检时快速扫读
  • 把聚合后的分维度数据排成表,替代难读的多曲线图

典型查询与配置

典型查询与配置
# 实例与任务清单(即时查询)
sum by (instance, job, version) (up)

# 5xx 比例 TopN
topk(10, sum by (route) (rate(http_requests_total{status=~"5.."}[5m]))
         / sum by (route) (rate(http_requests_total[5m])))

# 面板:Query options → Format = Table
# 再用 Field overrides 逐列设置单位、颜色与对齐

常用列设置

设置项作用典型用法
Unit列单位延迟用 ms、比例用 percent
Cell type单元格呈现超阈值行用 color text 标红
Cell value显示哪一列的值搭配 gauge 类型使用
Filter / Sort表内过滤排序巡检时按数值降序
Column width列宽长实例名适当加宽
表格列宽、对齐与单元格类型在 Field overrides 里逐列调,比全局默认更精确;改动只作用于当前面板,不影响其他面板。
时序查询直接切 Table 会按时间展开成海量行,先做聚合或改用即时查询,否则表格既慢又难读。
表格默认按查询返回顺序排列,需要排序或合并时要显式使用 Transformations,不能指望数据源替你做。
行数多时建议开启分页或限制条数(如先 topk),否则整屏渲染大量 DOM 会明显拖慢看板。

易错点

  • 时序查询直接切 Table 会按时间展开成海量行,先做聚合或改即时查询
  • 表格默认按查询返回顺序排列,需要排序/合并时要用 Transformations 显式处理
  • 列名依赖标签名,指标改标签后表的列会消失,看板需要同步维护
  • 行数过多会拖慢渲染,未限制条数的大清单在看板上体验很差
  • 用表格展示比率时忘了设单位,读者容易把 0.42 当成 0.42%

数据来源与参考

  • Grafana 官方文档 · Table panel
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌