Graphite 模板变量

您可以使用变量来代替在指标查询中硬编码服务器、应用程序和传感器名称等详细信息。Grafana 在仪表盘顶部的下拉选择框中列出这些变量，帮助您更改仪表盘中显示的数据。Grafana 将此类变量称为模板变量。

有关模板和模板变量的介绍，请参阅模板和添加和管理变量文档。

选择查询类型

Graphite 模板变量有三种查询类型

查询类型	描述
默认查询	使用 `tags()`、`tag_values()`、`expand(<metric>)` 等函数和指标。
值查询	返回包含指标和函数的查询的所有值。
指标名称查询	返回包含指标和函数的查询的所有名称。

要使用标签值创建变量，请使用 Grafana 函数 tags 和 tag_values。

查询	描述
`tags()`	返回所有标签。
`tags(server=~backend\*)`	仅返回与过滤器表达式匹配的时间序列中出现的标签。
`tag_values(server)`	返回指定标签的标签值。
`tag_values(server, server=~backend\*)`	返回在与这些表达式匹配的时间序列中出现的指定标签的过滤标签值。

多个过滤表达式和表达式可以包含其他变量。例如

tag_values(server, server=~backend\*, app=~${apps:regex})

标签查询中的多值变量使用变量的高级格式化语法：{var:regex}。非标签查询对多值变量使用默认的 glob 格式。

使用 regex 格式和 Equal Tilde 运算符 =~

server=~${servers:regex}

有关更多信息，请参阅高级变量格式选项。

编写查询时，使用 metric find 类型的查询。

例如，prod.servers.* 这样的查询将使用通配符位置中存在的所有可能值填充变量。

结果仅包含查询最后一级出现的所有可能值。要获取与查询匹配的完整指标名称，请使用 expand 函数：expand(*.servers.*)。

展开式查询返回匹配指标的完整名称。结合正则表达式，您可以使用它提取指标名称的任何部分。相比之下，非展开式查询仅返回指标名称的最后部分，并且不允许您提取指标名称的其他部分。

考虑以下示例指标

这些示例演示了展开式和非展开式查询如何获取指标名称的特定部分

非展开式查询	结果	展开式查询	展开式结果
`*`	prod, test	`expand(*)`	prod, test
`*.servers`	servers	`expand(*.servers)`	prod.servers, test.servers
`test.servers`	servers	`expand(test.servers)`	test.servers
`.servers.`	001,002	`expand(.servers.)`	prod.servers.001, prod.servers.002, test.servers.001
`test.servers.*`	001	`expand(test.servers.*)`	test.servers.001
`.servers..cpu`	cpu	`expand(.servers..cpu)`	prod.servers.001.cpu, prod.servers.002.cpu, test.servers.001.cpu

非展开式查询与展开式查询相同，只是带有一个匹配名称最后部分的 regex。

您还可以创建嵌套变量，其定义中使用其他变量。例如，apps.$app.servers.* 在其查询定义中使用了变量 $app。

您可以在查询字段中使用 __searchFilter 根据用户在下拉选择框中输入的内容过滤查询结果。如果您没有输入任何内容，__searchFilter 的默认值为 *，当作为正则表达式的一部分使用时，其默认值为空白。

要将 __searchFilter 作为查询字段的一部分使用，以便在用户在下拉选择框中输入时能够搜索 server

查询

apps.$app.servers.$__searchFilter

标签值

tag_values(server, server=~${__searchFilter:regex})

Graphite 数据源支持两种变量语法，可用于查询字段

$<varname>，例如 apps.frontend.$server.requests.count，这种语法更易于阅读和编写，但不允许您在单词中间使用变量。
${varname}，例如 apps.frontend.${server}.requests.count，用于 my.server${serverNumber}.count 之类的表达式。