

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 链接
<a name="linking-in-Amazon-Managed-Service-for-Grafana"></a>

****  
本文档主题专为支持 **Grafana 8.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。

 您可以使用链接在常用控制面板之间导航，或者将其他人连接到您的可视化。链接使您能够创建指向其他控制面板、面板甚至外部网站的快捷方式。

 Amazon Managed Grafana 支持控制面板链接、面板链接和数据链接。控制面板链接显示在控制面板顶部。选择面板左上角的图标即可访问面板链接。

## 您应使用哪种链接？
<a name="which-link-should-you-use"></a>

 首先，请检查您当前在控制面板之间导航的方式。如果您经常在一组控制面板之间跳来跳去，而且难以在每个控制面板中找到相同的上下文，那么链接有助于优化您的工作流程。

 下一步是找出哪种链接类型适合您的工作流程。尽管 Grafana 中的所有链接类型都用于创建指向其他控制面板或外部网站的快捷方式，但它们在不同的上下文中发挥作用。
+  要添加与控制面板中的大多数或全部面板相关的链接，请使用 [控制面板链接](dashboard-links.md)。
+  要深入了解特定的面板，请使用 [面板链接](panel-links.md)。
+  要链接到外部站点，您可以使用控制面板链接或面板链接。
+  要深入了解特定的序列，甚至是单个测量值，请使用 [数据链接](data-links.md)。

## 使用 URL 控制时间范围
<a name="controlling-time-range-using-the-url"></a>

 您可以通过在控制面板 URL 中提供以下查询参数来控制面板或控制面板的时间范围：
+  `from` 定义时间范围的下限，以毫秒纪元为单位指定。
+  `to` 定义时间范围的上限，以毫秒纪元为单位指定。
+  `time` 和 `time.window` 定义从 `time-time.window/2` 到 `time+time.window/2` 的时间范围。两个参数都应以毫秒为单位指定。例如，`?time=1500000000000&time.window=10000` 将得出 10 秒的时间范围，从 1499999995000 到 1500000005000 

# 控制面板链接
<a name="dashboard-links"></a>

****  
本文档主题专为支持 **Grafana 8.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。

 创建控制面板链接时，可包含时间范围和当前模板变量，以直接跳转到另一个控制面板中的相同上下文。这有助于确保您向其发送链接的人员看到的是正确数据。有关其他类型的链接，请参阅 [数据链接变量](linking-in-Amazon-Managed-Service-for-Grafana.md#data-link-variables)。

 添加控制面板链接后，链接会显示在控制面板的右上角。

## 向控制面板添加链接
<a name="add-links-to-dashboards"></a>

 在当前控制面板的顶部添加指向其他控制面板的链接。

1.  在查看要向其添加链接的控制面板时，选择屏幕顶部的齿轮图标，打开**控制面板设置**。

1.  选择**链接**，然后选择**添加控制面板链接**或**新建**。

1.  在**类型**中，选择**控制面板**。

1.  选择链接选项：
   +  **带标签**：输入标签，将链接的控制面板限制为仅包含带有您所输入标签的控制面板。否则，Grafana 工作区将包含指向所有其他控制面板的链接。
   +  **作为下拉列表**：如果要链接到多个控制面板，选择此选项，并在下拉列表中添加可选标题。如果未选择此选项，Grafana 工作区会在控制面板顶部并排显示控制面板链接。
   +  **时间范围**：选择此选项可在链接中包含控制面板的时间范围。当用户选择链接时，链接的控制面板将会打开，并显示已设置的指示时间范围。
   +  **变量值**：选择此选项可在链接中包含当前用作查询参数的模板变量。当用户选择链接时，链接的控制面板中的任何匹配模板都将设置为链接中的值。
   +  **在新选项卡中打开**：选择此选项可在新选项卡或窗口中打开控制面板链接。

1.  选择**添加**。

## 向控制面板添加 URL 链接
<a name="add-a-url-link-to-a-dashboard"></a>

 在当前控制面板的顶部添加指向 URL 的链接。您可以链接到任何可用的 URL，包括控制面板、面板或外部站点。您甚至可以控制时间范围，以确保用户在 Grafana 工作区中看到特定数据。

1.  在查看要链接到的控制面板时，选择屏幕顶部的齿轮图标，打开**控制面板设置**。

1.  选择**链接**，然后选择**添加控制面板链接**或**新建**。

1.  在**类型**中，选择**链接**。

1.  选择链接选项：
   +  **Url**：输入要链接的 URL。根据目标，您可能希望包含字段值。
   +  **标题**：输入您希望链接显示的标题。
   +  **工具提示**：输入您希望用户将鼠标悬停在链接上时，链接显示的工具提示内容。
   +  **图标**：选择要与链接一起显示的图标。
   +  **时间范围**：选择此选项可在链接中包含控制面板的时间范围。当用户选择链接时，链接的控制面板将会打开，并显示已设置的指示时间范围。
     +  `from` 定义时间范围的下限，以毫秒纪元为单位指定。
     +  `to` 定义时间范围的上限，以毫秒纪元为单位指定。
     +  `time` 和 `time.window` 定义从 `time-time.window/2` 到 `time+time.window/2` 的时间范围。两个参数都应以毫秒为单位指定。例如，`?time=1500000000000&time.window=10000` 的结果是一个从 1499999995000 到 1500000005000 的 10 秒时间范围。
   +  **变量值**：选择此选项可在链接中包含当前用作查询参数的模板变量。当用户选择链接时，链接的仪表板中的所有匹配模板都将设置为链接中的值；例如 https://play.grafana。 org/d/000000074/alerting？ var-app=backend&var-server=backend\$101&var-server=backend\$103&var-interval=1h 
   +  **在新选项卡中打开**：选择此选项可在新选项卡或窗口中打开控制面板链接。

1.  选择**添加**。

## 更新控制面板链接
<a name="update-a-dashboard-link"></a>

 要更改或更新现有控制面板链接，请使用以下步骤。

1.  在**控制面板设置**的**链接**选项卡上，选择要编辑的现有链接。

1.  更改设置，然后选择**更新**。

## 复制控制面板链接
<a name="duplicate-a-dashboard-link"></a>

 要复制现有控制面板链接，请选择要复制的现有链接旁边的复制图标。

## 删除控制面板链接
<a name="delete-a-dashboard-link"></a>

 要删除现有控制面板链接，请选择要删除的链接旁边的垃圾桶图标。

# 面板链接
<a name="panel-links"></a>

****  
本文档主题专为支持 **Grafana 8.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。

 每个面板都有自己的一组链接，这些链接显示在面板左上角。您可以链接到任何可用的站点 URLs，包括仪表板、面板或外部站点。您甚至可以控制时间范围，以确保用户在 Grafana 工作区中看到特定数据。

选择面板左上角的图标以查看可用的面板链接。

## 添加面板链接
<a name="add-a-panel-link"></a>

1.  在要添加链接的面板上暂停，然后按 **e**。或者选择面板标题旁边的下拉箭头，然后选择**编辑**。

1.  在**面板**选项卡上，向下滚动到**链接**部分。

1.  展开**链接**，然后选择**添加链接**。

1.  输入链接的**标题**。标题将显示在 UI 中。

1.  输入要链接到的 **URL**。您可以包括在控制面板中定义的模板变量之一。按 **Ctrl \$1 空格键**或 **Cmd \$1 空格键**，然后选择 **URL** 字段以查看可用的变量。当您将模板变量添加到面板链接时，该链接会向用户显示正确的上下文，其中相关变量已设置完毕。您还可以使用时间变量 
   +  `from` 定义时间范围的下限，以毫秒纪元为单位指定。
   +  `to` 定义时间范围的上限，以毫秒纪元为单位指定。
   +  `time` 和 `time.window` 定义从 `time-time.window/2` 到 `time+time.window/2` 的时间范围。两个参数都应以毫秒为单位指定。例如，`?time=1500000000000&time.window=10000` 的结果是一个从 1499999995000 到 1500000005000 的 10 秒时间范围。

1.  要在新选项卡中打开，请选择**在新选项卡中打开**。

1.  选择**保存**以保存更改并关闭窗口。

1.  选择右上角的**保存**来将更改保存到控制面板。

## 更新面板链接
<a name="update-a-panel-link"></a>

1.  在**面板**选项卡上，找到要更改的链接。

1.  选择**编辑**（铅笔）图标以打开**编辑链接**窗口。

1.  进行任何必需的更改。

1.  选择**保存**以保存更改并关闭窗口。

1.  选择右上角的**保存**来将更改保存到控制面板。

## 删除面板链接
<a name="delete-a-panel-link"></a>

1.  在**面板**选项卡上，找到要删除的链接。

1.  选择要删除的链接旁边的 **X** 图标。

1.  选择右上角的**保存**来将更改保存到控制面板。

# 数据链接
<a name="data-links"></a>

****  
本文档主题专为支持 **Grafana 8.x 版本**的 Grafana 工作区而设计。  
对于支持 Grafana 10.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 10](using-grafana-v10.md)。  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。

 数据链接为您的链接提供了更精细的上下文。您可以创建包含序列名称甚至值的链接。例如，如果您的可视化显示四台服务器，则可以向其中一两台服务器添加数据链接。

 根据可视化效果，可通过不同的方式访问链接本身。对于图形面板，您需要选择一个数据点或线条。对于诸如统计数据、计量表或条形仪表之类的面板，您可以选择可视化中的任意位置来打开上下文菜单。

 您可以在数据链接中使用变量，将用户引导至具有保留数据筛选条件的详细控制面板。例如，您可以使用变量来指定时间范围、序列和变量选择。有关更多信息，请参阅 [数据链接变量](linking-in-Amazon-Managed-Service-for-Grafana.md#data-link-variables)。

## 提前输入建议
<a name="typeahead-suggestions"></a>

 创建或更新数据链接时，按键盘上的 **Ctrl \$1 空格键**或 **Cmd \$1 空格键**打开预输入建议，以便更轻松地向 URL 添加变量。

## 添加数据链接
<a name="add-a-data-link"></a>

1.  在要添加链接的面板上暂停，然后按 **e**。或者选择面板标题旁边的下拉箭头，然后选择**编辑**。

1.  在**字段**选项卡上，向下滚动到**数据链接**部分。

1.  展开**数据链接**，然后选择**添加链接**。

1.  输入链接的**标题**。标题将显示在 UI 中。

1.  输入要链接到的 **URL**。

    您可以添加在控制面板中定义的一个模板变量。选择 **URL** 字段，然后键入 **\$1**，或者按 ****Ctrl \$1 空格键或 **Cmd \$1 空格键**查看可用变量列表。当您将模板变量添加到面板链接时，该链接会向用户显示正确的上下文，其中相关变量已设置完毕。有关更多信息，请参阅 [数据链接变量](linking-in-Amazon-Managed-Service-for-Grafana.md#data-link-variables)。

1.  要在新选项卡中打开，请选择**在新选项卡中打开**。

1.  选择**保存**以保存更改并关闭窗口。

1.  选择右上角的**保存**来将更改保存到控制面板。

## 更新数据链接
<a name="update-a-data-link"></a>

1.  在**字段**选项卡上，找到要更改的链接。

1.  选择**编辑**（铅笔）图标以打开**编辑链接**窗口。

1.  进行任何必需的更改。

1.  选择**保存**以保存更改并关闭窗口。

1.  选择右上角的**保存**来将更改保存到控制面板。

## 删除数据链接
<a name="delete-a-data-link"></a>

1.  在**字段**选项卡上，找到要删除的链接。

1.  选择要删除的链接旁边的 **X** 图标。

1.  选择右上角的**保存**来将更改保存到控制面板。

## 数据链接变量
<a name="data-link-variables"></a>

 您可以使用数据链接中的变量来查看序列字段、标签和值。有关数据链接的更多信息，请参阅 [数据链接](data-links.md)。

 要查看可用变量列表，请在数据链接 **URL** 字段中输入 **\$1**。

 您也可以在数据链接中使用模板变量 URLs。有关更多信息，请参阅 [模板和变量](templates-and-variables.md)。

### 时间范围面板变量
<a name="time-range-panel-variables"></a>

 您可以使用以下变量在数据链接 URL 中包含当前时间范围：
+  `__url_time_range`：当前控制面板的时间范围；例如，`?from=now-6h&to=now`
+  `$__from and $__to`— 有关更多信息，请参阅 [全局变量] (\$1\$1< relref “.. /variables/variable-types/global-variables.md \$1\$1\$1from and-\$1\$1to” >\$1\$1)。

### 序列变量
<a name="series-variables"></a>

 特定于序列的变量在 `__series` 命名空间下可用：
+  `__series.name`：将序列名称添加到 URL 
+  `__series.labels.<LABEL>`：将标签的值添加到 URL。如果您的标签包含点，请使用 `__series.labels["<LABEL>"]` 语法。

### 字段变量
<a name="field-variables"></a>

 特定于字段的变量在 `__field` 命名空间下可用：
+  `__field.name`：字段的名称 

### 值变量
<a name="value-variables"></a>

 特定于值的变量在 `__value` 命名空间下可用：
+  `__value.time`：该值的时间戳（Unix 毫秒纪元）到 URL；例如，`?time=1560268814105`
+  `__value.raw`：原始值 
+  `__value.numeric`：值的数字表示 
+  `__value.text`：值的文本表示 
+  `__value.calc`：如果值是计算结果，则为计算名称 

### 模板变量
<a name="template-variables"></a>

 在链接到其他使用模板变量的控制面板时，请为选择链接的用户选择变量值。

 使用 `var-myvar=${myvar}`，其中 `myvar` 是模板变量的名称，该名称与您要使用的当前控制面板中的模板变量相匹配。

 要将当前控制面板的所有变量添加到 URL 中，请使用 `__all_variables`。