關聯配置

本文件主題是針對支援 Grafana 10.x 版的 Grafana 工作區所設計。

如需支援 Grafana 9.x 版的 Grafana 工作區，請參閱。在 Grafana 第 9 版中工作

如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱。在 Grafana 第 8 版中工作

每個關聯都使用下列選項進行設定：

標籤

連結標籤，顯示在視覺效果中。

Description

選用的描述。

來源資料來源

顯示連結的結果來源。

結果欄位

定義連結在視覺效果中的顯示位置。

目標查詢

目標查詢會在按一下連結時執行。

转换

對包含傳遞至目標查詢的來源資料的選擇性操作。

如需有關建立關聯的詳細資訊，請參閱建立關聯。

來源資料來源和結果欄位

關聯的來源資料來源結果會顯示在「瀏覽」視覺效果中的連結。系統會根據關聯規劃 (結果欄位) 中提供的結果，將連結指定給其中一個欄位。每個視覺效果都以不同的方式顯示帶有連結的欄位。

目標查詢

在視覺效果中按一下連結時，即會執行目標查詢。您可以使用所選目標資料來源的查詢編輯器來指定目標查詢。源數據結果可以與變量的目標查詢中進行訪問。

關聯變數

您可以使用目標查詢內的變數來存取與查詢相關的來源資料。相關性使用 Grafana 變量的語法。選擇連結時，變數會填入來源結果中的值。您可以使用兩種類型的變數：

• 欄位變數 (用於存取欄位值和標籤)。

• 關聯變量（訪問字段值和轉換）。

示例：如果源結果包含名為的字段employee，則可以使用以下命令訪問該字段的值：

• 欄位變數${__data.fields.employee}。

• 將上述欄位值對應至的關聯變數${employee}。

除了將欄位值對應到較短的變數名稱之外，還可以透過將轉換套用至現有欄位來建立更多關聯變數。

僅當所有變數在所選資料列中具有值時，關聯才會建立資料連結。全域變數是此規則的例外狀況，不需要從傳回的資料中填入。這些變數會由資料來源自動內插。

相关转换

轉換提供了一種從字段值中提取更多變量的方法。轉換的輸出是一組新的變量，可以作為任何其他變量進行訪問。

有兩種類型的轉換：logfmt 和正則表達式。

每個轉換都會使用選取的欄位值做為輸入。轉換的輸出是一組基於轉換的類型和選項的新變數。

洛格夫特转换

logfmt 轉換解構包含使用 logfmt 鍵/值對格式化的文本的字段值。每對成為一個變量，密鑰是變量的名稱。

如果您希望轉換套用至與結果欄位不同的欄位，logfmt 轉換只需要指定輸入欄位名稱。範例輸出變數field = "host=srv001 endpoint=/test app=foo"：

name	value
託管	srv001
端點	/測試
應用程式	富

規則運算式轉換

規則運算式轉換會根據提供的規則運算式解構欄位值。

規則運算式轉換選項：

字段

輸入欄位名稱

運算式

規則運算式。命名捕獲組映射到匹配組名的變量。如果使用非命名匹配組，則會在第一個匹配項中創建一個變量。值會覆寫符合輸入欄位的變數，或者如果提供了 MapValue，則會建立新變數 (請參閱下表中的範例)。

映射值

用於沒有命名匹配組的簡單正則表達式組。默認情況下，第一個匹配覆蓋用作輸入字段的名稱的變量。若要變更該預設行為，您可以指定 mapValue 屬性。提供的名稱用於創建一個新的變量。如果您的目標查詢同時需要確切的值以及隨轉換所擷取的值的一部分，此功能會很有用。

範例：假設選取的欄位名稱為employee且欄位值為John Doe。

基於表達式和 MapValue 選項的各種輸出變量：

expression	映射值	輸出變數	comment
/\w+ (\w+)/	-	employee=Doe	沒有提供映射值。第一個相符項目會對應至現有的欄位名稱變數 (employee)。
/(\w+) (\w+)/	name	name=John	第一個匹配被映射到一個名為的新變量name。
/(?\w+) (?\w+)/	-	firstName=John, lastName=Doe	當使用命名組時，它們是輸出變量的名稱，並且 MapValue 被忽略。
/(?\w+) (?\w+)/	name	firstName=John, lastName=Doe	同上