Ad hoc filters 是什么
Ad hoc filters 是 Grafana 的看板级变量类型，会在页面顶部生成一条键值过滤条：选择某个标签后，过滤条件自动叠加到绑定了同一数据源的所有查询上，用于临时缩小排查范围。它不改变看板定义，清空过滤条即恢复全量视图，适合排障时快速圈定实例或服务。
基本信息
| 创建路径 | Dashboard settings → Variables → New variable → Ad hoc filters |
|---|---|
| 绑定数据源 | 创建时选择，过滤只作用于该数据源上的查询 |
| 可选标签 | 来自数据源中实际存在的标签键，值由数据决定 |
| 作用范围 | 当前看板内所有引用该数据源的查询 |
使用方式
使用方式
# Variables → New variable → 类型选 Ad hoc filters
# 绑定数据源（如 Prometheus）后，看板顶部出现过滤条
# 选择 job=node、instance=web01 后，查询自动附带条件：
up{job="node",instance="web01"}
# 排查结束点过滤条上的清空按钮，恢复全量视图典型使用场景
- 大屏平时展示全量，临时收敛到单个实例或服务定位异常
- 多环境共用一块看板，排障时切到具体集群或环境
- 确认某个标签值是否存在，快速验证数据注入是否生效
- 配合告警排查，把看板缩到告警涉及的实例范围
使用注意
| 注意点 | 说明 |
|---|---|
| 是否支持 | 由数据源插件决定，Prometheus、InfluxDB、Elasticsearch 等支持 |
| 作用范围 | 作用于全部查询，个别面板要豁免只能改查询逻辑 |
| 标签来源 | 只有数据里真实存在的标签才会出现在下拉列表中 |
| 清空时机 | 排查结束及时清空，否则后续查看会被旧过滤误导 |
标签拼写与注入阶段不一致时下拉列表为空，先确认指标上真实的标签名，而不是先怀疑 Grafana 版本或权限。
把带过滤条的看板地址分享出去时，链接会带上当前过滤条件，分享前确认范围与内容是否符合预期。