本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
本文件主題專為支援 Grafana 10.x 版的 Grafana 工作區而設計。
如需支援 Grafana 9.x 版的 Grafana 工作區，請參閱使用 Grafana 第 9 版。
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱使用 Grafana 第 8 版。
資料連結可讓您提供更精細的連結內容。您可以建立連結，其中包含系列名稱，甚至是游標下方的值。例如，如果您的視覺化顯示四部伺服器，您可以將資料連結新增至其中一或兩部伺服器。您也可以使用資料連結來連結面板。
根據視覺化效果，連結本身可以以不同的方式存取。例如，對於時間序列視覺化，您可以選擇資料點或行。對於大型區域視覺化，例如統計資料、量測計或長條圖，您可以選擇視覺化上的任意位置來開啟內容選單。
如果視覺效果中只有一個資料連結，請選擇視覺效果上的任意位置，開啟連結，而不是內容選單。
支援的視覺化效果
長條圖
長條規
蠟燭圖
Canvas
量測計
地理地圖
熱度圖
直方圖
圓餅圖
Stat
狀態時間軸
狀態歷史記錄
資料表
時間序列
趨勢
資料連結變數
資料連結中的變數可讓您將人員傳送至具有保留資料篩選條件的詳細儀表板。例如，您可以使用變數來指定標籤、時間範圍、序列或變數選擇。
若要查看可用變數的清單，$請輸入資料連結 URL 欄位。
您也可以在資料連結 URLs中使用範本變數，請參閱 Variables。
時間範圍面板變數
這些變數可讓您在資料連結 URL 中包含目前的時間範圍。
系列變數
系列特定變數可在__series命名空間下使用：
-
__series.name– URL 的系列名稱
欄位變數
欄位特定的變數可在__field命名空間下使用：
-
__field.name– 欄位的名稱 -
__field.labels.<LABEL>– 標籤的 URL 值。如果您的標籤包含點，請使用__field.labels["<LABEL>"]語法。
值變數
值特定的變數可在__value命名空間下使用：
-
__value.time– 值對 URL 的時間戳記 (Unix ms epoch) （即?time=1560268814105) -
__value.raw– 原始值 -
__value.numeric– 數值的數值表示法 -
__value.text– 值的文字表示 -
__value.calc– 如果值是計算的結果，則計算名稱
在資料連結中使用值特定的變數，可以根據工具提示模式的設定選項顯示不同的結果。
資料變數
若要從其他欄位存取值，請使用：
-
__data.fields[i]– 欄位的值i（在同一列）。 -
__data.fields["NameOfField"]– 使用名稱而非索引的欄位值。 -
__data.fields[i].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 以查看可用變數的清單。 -
如果您想要在新索引標籤中開啟連結，請選取在新索引標籤中開啟。
-
選擇儲存以儲存變更並關閉對話方塊。
-
將變更儲存至儀表板。
