参考答案
内容深度:详细 · 无代码示例 · 来源:外部链接 · 未复核 · 77 天前更新 · 技术内容可能随版本变化,建议结合官方文档理解
一、核心思路:把「会变的东西」抽成变量
变量(variable)是值的占位符,可以用在数据源查询、面板重复选项、看板/面板链接、标题、描述和数据转换里。修改变量值,看板上所有引用它的元素都会同步刷新,看板无需重新编辑。
二、变量类型怎么选
- Query:取值来自数据源查询(服务名、指标名、label 值、机房),最常用,服务增删时下拉框自动跟着变。
- Custom:手工维护固定列表,适合环境(dev/test/prod)这类稳定枚举。
- Text box:允许自由输入,适合临时排查。
- Constant:看板内部复用、但不希望查看者修改的值。
- Data source:让同一份看板在多个数据源实例(多集群、多环境)之间切换,这是「一套看板管所有集群」的关键。
- Interval:让用户调整时间分组/聚合粒度。
- Filters / Switch:前者给支持的数据源做看板级键值过滤,后者做二值开关。
三、三个提效技巧
- 重复面板(repeating panels):变量开启多选后,一个面板模板可以按变量值横向/纵向展开,新增服务时看板自动多出一组面板,实现「single-source dashboard」。
- 链式变量(chained variables):先选集群 → 由集群过滤出命名空间 → 再由命名空间过滤出服务,逐级收窄,避免下拉框几千项。
- 内置全局变量:如当前时间区间、看板名、组织、登录用户、查询间隔等,可用于标题与查询,保证各面板口径一致。
四、注意事项
- 变量值默认会同步到 URL(
var-<name>=value),便于分享;若不希望被 URL 覆盖或不想在分享链接里暴露值,可在看板 JSON 中把 skipUrlSync 设为 true(Constant 变量默认即为此行为)。
- 不要滥用
All 选项:一个小变量勾选全部,可能让聚合查询的开销放大几十倍,拖垮数据源。
- 看板变多后要用变量依赖管理功能检查顺序与依赖,避免出现悬空变量。