

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 正在連結
<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` 定義時間範圍的下限，以 ms epoch 指定。
+  `to` 定義時間範圍的上限，以 ms epoch 指定。
+  `time` 和 `time.window`定義從 `time-time.window/2`到 的時間範圍`time+time.window/2`。這兩個參數應以毫秒為單位指定。例如， `?time=1500000000000&time.window=10000` 將產生從 1499999995000 到 1500000005000 的 10 秒時間範圍 

# 儀表板連結
<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` 定義時間範圍的下限，以 ms epoch 指定。
     +  `to` 定義時間範圍的上限，以 ms epoch 指定。
     +  `time` 和 `time.window`定義從 `time-time.window/2`到 的時間範圍`time+time.window/2`。這兩個參數應以毫秒為單位指定。例如， `?time=1500000000000&time.window=10000` 會產生從 1499999995000 到 1500000005000 的 10 秒時間範圍。
   +  **變數值** – 選取此選項，以在連結中包含目前用作查詢參數的範本變數。當使用者選擇連結時，連結儀表板中的任何相符範本都會設定為連結中的值；例如，https：//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\$1Space** 或 **Cmd\$1Space**，然後選擇 **URL** 欄位以查看可用的變數。當您將範本變數新增至面板連結時，連結會將使用者傳送至正確的內容，並已設定相關變數。您也可以使用時間變數 
   +  `from` 定義時間範圍的下限，以 ms epoch 指定。
   +  `to` 定義時間範圍的上限，以 ms epoch 指定。
   +  `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)。

## Typeahead 建議
<a name="typeahead-suggestions"></a>

 當您建立或更新資料連結時，請按鍵盤上的 **Ctrl\$1Space** 或 **Cmd\$1Space** Cmd\$1Space 開啟預先輸入建議，以更輕鬆地將變數新增至 URL。

## 新增資料連結
<a name="add-a-data-link"></a>

1.  在您要新增連結的面板上暫停，然後按 **e**。或者，選擇面板標題旁的下拉箭頭，然後選擇**編輯**。

1.  在**欄位**索引標籤上，向下捲動至**資料連結**區段。

1.  展開**資料連結**，然後選擇**新增連結**。

1.  輸入連結的**標題**。標題會顯示在 UI 中。

1.  輸入您要連結的 **URL**。

    您可以新增儀表板中定義的其中一個範本變數。選擇 **URL** 欄位，然後輸入 **\$1**，或按 ****Ctrl\$1Space 或 **Cmd\$1Space** 以查看可用變數的清單。當您將範本變數新增至面板連結時，連結會將使用者傳送至正確的內容，並已設定相關變數。如需詳細資訊，請參閱[資料連結變數](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` – 值的 URL 時間戳記 (Unix ms epoch)；例如， `?time=1560268814105`
+  `__value.raw` – 原始值 
+  `__value.numeric` – 值的數值表示法 
+  `__value.text` – 值的文字表示 
+  `__value.calc` – 如果值是計算的結果，則為計算名稱 

### 範本變數
<a name="template-variables"></a>

 連結至使用範本變數的另一個儀表板時，請為任何選擇連結的人員選取變數值。

 使用 `var-myvar=${myvar}`，其中 `myvar`是範本變數的名稱，與您要使用的目前儀表板中的變數相符。

 若要將目前儀表板的所有變數新增至 URL，請使用 `__all_variables`。