首页/云/可观测性速查/Query 变量:从指标里展开下拉选项
本包目录(282 条)
监控体系与方法40 条Prometheus 与采集64 条
Grafana 与看板53 条
日志平台52 条链路追踪23 条告警与响应50 条

Query 变量:从指标里展开下拉选项

模板变量让同一看板适配多实例/多任务:绑定 Prometheus 数据源的 Query 变量常用 label_values 取标签值,也可用 query_result 跑任意 PromQL。

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

变量查询写法

变量查询写法
label_values(node_uname_info, instance)              # 取实例列表
label_values(kube_pod_info{namespace="prod"}, pod)  # 带筛选
metrics(node_filesystem_.*)                          # 匹配指标名
query_result(topk(3, sum by (job) (up)))             # 任意查询 + regex 提取
引用写法$job 或 ${job},也可用于标题与图例
Multi-value多选后 allValue 控制 All 的匹配正则
RefreshOn dashboard load / On time range change 二选一控制刷新时机
变量查询本身也是一次查询,高基数 label_values 会显著拖慢看板加载。

易错点

  • regex 过滤要写清捕获组(如 /(.+)$/ 思路),否则下拉项是整串文本
  • 把所有指标丢给 label_values(instance) 会拉爆查询,优先带 metric 或选择器缩小范围

数据来源与参考

  • Grafana 官方文档 · Prometheus template variables
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌