文档

Grafana 文档

面板和可视化

配置数据链接和操作

Grafana Cloud Enterprise Open source

配置数据链接和操作

数据链接允许你链接到其他面板、仪表盘和外部资源，而操作则允许你触发基本的、无需身份验证的 API 调用。在这两种情况下，你都可以在保留源面板上下文的同时执行这些任务。

数据链接

使用数据链接，你可以创建包含系列名称甚至光标下值的链接。例如，如果你的可视化显示了四台服务器，你可以为其中一两台添加数据链接。

链接本身的访问方式取决于可视化类型。对于时间序列可视化，你需要点击一个数据点或线

对于统计图、仪表盘或柱状仪表盘等可视化，你可以点击可视化上的任意位置打开上下文菜单。

如果可视化中只有一个数据链接，点击可视化上的任意位置将直接打开链接，而不是上下文菜单。

支持的可视化类型

你可以为以下可视化配置数据链接：

操作

使用操作，你可以直接从仪表盘面板触发进程，例如启动或关闭服务器。API 设置在添加操作对话框中配置。你也可以在 API 编辑器中传递变量。

支持的可视化类型

你可以为以下可视化配置操作：

数据链接和操作变量

数据链接和操作中的变量允许你将用户引导至详细的仪表盘或触发保留数据过滤条件的 API 调用。例如，你可以使用变量指定标签、时间范围、系列或变量选择。

要查看可用变量列表，在数据链接或操作的 URL 字段中输入 $ 或按 Ctrl+Space 或 Cmd+Space。

注意
这些变量在 6.4 版本中有所更改，因此如果你使用的是旧版 Grafana，请使用版本选择器选择旧版 Grafana 的文档。

Azure Monitor、CloudWatch 和 Google Cloud Monitoring 具有预配置的数据链接，称为深度链接。

你还可以在数据链接或操作 URL 中使用模板变量。更多信息，请参阅模板和变量。

时间范围面板变量

这些变量允许你在数据链接或操作 URL 中包含当前时间范围：

变量	描述
`__url_time_range`	当前仪表盘的时间范围（例如，`?from=now-6h&to=now`）
`__from`	更多信息，请参阅全局变量。
`__to`	更多信息，请参阅全局变量。

当你在 URL 中使用 __url_time_range 等时间范围变量创建数据链接和操作时，你需要自行构建查询参数语法；也就是说，你必须使用问号 (?) 和连接符 (&) 语法格式化 URL 来附加查询参数。这些字符不会自动生成。

系列变量

系列特有变量在 __series 命名空间下可用：

变量	描述
`__series.name`	将系列名称添加到 URL

字段变量

字段特有变量在 __field 命名空间下可用：

变量	描述
`__field.name`	字段名称
`__field.labels.<LABEL>`	将标签值添加到 URL。如果你的标签包含点号，请使用 `__field.labels["<LABEL>"]` 语法。

值变量

值特有变量在 __value 命名空间下可用：

变量	描述
`__value.time`	将值的 Unix 毫秒时间戳添加到 URL（例如，`?time=1560268814105`）
`__value.raw`	原始值
`__value.numeric`	值的数字表示
`__value.text`	值的文本表示
`__value.calc`	如果值是计算结果，则为计算名称

在数据链接和操作中使用值特有变量可能会根据提示信息模式设置的不同而显示不同结果。

当你在 URL 中使用 __value.time 等时间范围变量创建数据链接和操作时，你需要自行构建查询参数语法；也就是说，你必须添加问号 (?) 和连接符 (&)。这些字符不会自动生成。

数据变量

要访问其他字段的值和标签，请使用：

变量	描述
`__data.fields[i]`	字段 `i` 的值（在同一行）
`__data.fields["NameOfField"]`	使用名称而不是索引的字段值
`__data.fields[1].labels.cluster`	访问另一个字段的标签

模板变量

当链接到使用模板变量的另一个仪表盘时，为点击链接的用户选择变量值。

${var-myvar:queryparam} - 其中 var-myvar 是模板变量的名称，与当前仪表盘中你想使用的变量匹配。

变量状态	生成的 URL 中的结果
选中单个值	`var-myvar=value1`
选中多个值	`var-myvar=value1&var-myvar=value2`
选中 `All`	`var-myvar=All`

如果你想将当前仪表盘的所有变量添加到 URL 中，则使用 ${__all_variables}。

添加数据链接或操作

以下任务描述了如何配置数据链接和操作。

要添加数据链接，请按照以下步骤操作：

导航到你想添加数据链接的面板。
将鼠标悬停在面板的任意部分，以显示右上角的菜单图标。
点击菜单图标并选择编辑以打开面板编辑器。
向下滚动到数据链接和操作部分并展开。
点击+ 添加链接。
在打开的对话框中，输入标题。
这是在 UI 中显示的链接的人类可读标签。这是必填字段。
输入你想链接到的 URL。
要添加数据链接变量，点击 URL 字段并输入 $ 或按 Ctrl+Space 或 Cmd+Space 查看可用变量列表。这是必填字段。
如果你想在新标签页中打开链接，请切换在新标签页中打开开关。
如果你想通过单击可视化来打开数据链接，请切换单击打开开关。
同时只能有一个数据链接启用单击打开。单击打开仅支持部分可视化类型。
点击保存以保存更改并关闭对话框。
点击保存仪表盘。
点击返回仪表盘，然后点击退出编辑。

注意
并非所有可视化都支持操作。有关支持的可视化列表，请参阅支持的可视化类型。

要添加操作，请按照以下步骤操作：

导航到你想添加操作的面板。
将鼠标悬停在面板的任意部分，以显示右上角的菜单图标。
点击菜单图标并选择编辑以打开面板编辑器。
向下滚动到数据链接和操作部分并展开。
点击+ 添加操作。

在打开的对话框中，定义 API 调用设置：

选项	描述
标题	在 UI 中显示的操作的人类可读标签。
确认消息	用于确认或取消操作的描述性提示。
方法	从POST、PUT或GET中选择。
URL	请求 URL。要添加变量，点击 URL 字段并输入 `$` 或按 Ctrl+Space 或 Cmd+Space 查看可用变量列表。
查询参数	键和值对。点击 + 图标可以添加任意数量的键/值对。
请求头	由键和值对以及 Content-Type 组成。点击 + 图标可以添加任意数量的键/值对。
Content-Type	从以下选项中选择：application/json、text/plain、application/XML 和 application/x-www-form-urlencoded。
请求体	请求体。