跳转到主要内容
变量把在网格上方选中的值代入每个面板的查询、标题和链接。这样一个仪表盘就能服务所有服务、主机或环境,而不必为每一个复制一份。

添加变量

打开编辑器,点击 设置 → 变量,然后添加变量: 保存仪表盘后变量才会保留。

类型

查询变量

查询变量在当前时间范围内读取取值。选择 查询类型: 第一个取值作为默认值。查询中可以使用其他变量,例如在 SQL 中写 WHERE environment = '$env',这样选中某个环境后,服务列表会随之缩小。

使用变量

在查询、面板标题、文本元素或链接中写 $name 或 ${name}。名称后面紧跟字母时需要花括号,例如 ${service}_errors。多选变量的多个取值默认用逗号连接;加上格式可以改变连接方式: 例如 PromQL 面板 sum(rate(http_requests_total{service=~"${service:regex}"}[5m])) 会跟随选中的服务变化。

地址中的取值

选中的取值保存在仪表盘地址中,形式为 var-<name>=<value>,多选变量的每个取值各占一个参数。复制地址,或用这些参数拼出链接,即可用同样的取值打开仪表盘。数据链接也可以把变量传递下去。

按变量重复面板

在面板的 面板 标签页中选择 重复变量。仪表盘会为每个选中的取值绘制一份面板副本,副本中的变量取该值。选择 重复方向(横向、纵向 或 网格)和 每行最多数量。只有原始面板会被保存,副本跟随选择变化。
最后修改于 2026年10月26日