本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
探索中的關聯編輯器
本文件主題是針對支援 Grafana 10.x 版的 Grafana 工作區所設計。
如需支援 Grafana 9.x 版的 Grafana 工作區,請參閱。在 Grafana 第 9 版中工作
如需支援 Grafana 8.x 版的 Grafana 工作區,請參閱。在 Grafana 第 8 版中工作
關聯允許用戶在任意兩個數據源之間構建鏈接。若要取得更多資訊,包括關聯的概觀,請參閱〈〉在 Grafana 版本 10 相關。
建立關聯
您可以從「瀏覽」(Explore) 頁面建立關聯。
若要建立關聯
-
在您的 Amazon 受管 Grafana 工作區中,導覽至「探索」頁面。
-
選取您希望成為新關聯之來源的資料來源。
-
在支援的視覺效果中執行產生資料的查詢。
-
選擇頂部工具欄中的 + 添加,然後選擇添加關聯(您也可以從命令調色板中選擇相關性編輯器。
「探索」現在處於「關聯編輯器」模式中,以藍色邊框和頂端列表示。您可以通過選擇頂部欄中的退出退出來退出關聯編輯器。
-
您現在可以使用附加至可用來建立新查詢之資料的連結,為視覺效果建立下列新關聯:
-
防護記錄 — 連結會顯示在每個記錄資料列的記錄詳細資料內的欄位值旁邊。
-
表格 — 每個表格儲存格都是一個連結。
-
-
選擇連結以新增關聯。連結與用作關聯結果欄位的欄位相關聯。如需詳細資訊,請參閱關聯配置。
-
在開啟的分割檢視中,使用右窗格設定關聯的目標查詢來源。如需詳細資訊,請參閱目標查詢。
-
使用變數語法搭配窗格頂端提供的清單中的變數來建立目標查詢。清單包含來自所選資料列的範例值。
-
提供標籤和說明 (選擇性)。標籤將用作視覺效果內部連結的名稱,並且可以包含變數。
-
提供轉換(可選;詳見下文)。
-
選擇頂部工具欄中的「保存」以保存關聯並退出「關聯編輯器」模式。用於建立關聯的連結將被每列中的資料連結取代。選取連結後,您定義的查詢將在另一個窗格中執行,並以所選列中的值動態取代變數。
转换
轉換允許您提取存在於具有其他數據的字段中的值。例如,使用轉換時,您可以擷取記錄行的一部分,以便在關聯中使用。如需關聯中轉換的詳細資訊,請參閱。相关转换
在編輯器模式下選擇其中一個產生的連結之後,您可以在「轉換」下拉式功能表中選取「新增轉換」來新增變形。
若要在關聯中使用轉換
-
選取要套用轉換的欄位。選取要用於轉換的欄位部分。例如,記錄行。選取之後,此欄位的值將用於協助您建立轉換。
-
選取轉換的類型。相关转换如需選項和相關設定,請參閱。
-
根據您的選擇,您可能會看到一個或多個變數填入,或者您可能需要在顯示的選項中提供更多規格。
-
選取「將轉換新增至關聯」,將指定的變數加入至可用變數清單。
注意
對於此對話方塊中的規則運算式,此Variable Name
處會呼叫其他文件中mapValue
所提及的規則運算式。Grafana 會反白顯示與欄位值中表示式相符的任何文字。使用規則運算式擷取群組來選取應擷取相符項目的哪一部分。當提供有效的規則運算式時,變數和該變數的值會出現在Variable
Name
欄位下方。
相關範例
下列範例顯示如何使用「瀏覽器」中的「關聯編輯器」建立關聯性。如果您想要遵循這些範例,請務必設定測試資料來源。
創建一個文本到圖形的關聯
此範例顯示如何使用「瀏覽器」中的「關聯編輯器」建立關聯。
關聯可讓您使用一個查詢的結果,在任何資料來源中執行新的查詢。在此範例中,您將執行呈現表格式資料的查詢。該數據將被用來運行產生一個圖形結果的不同查詢。
若要遵循此範例,請確定您已設定測試資料來源。
若要建立文字與圖形的關聯
-
在 Grafana 中,導覽至「探索」。
-
從頁面左上方的下拉式功能表中選取測試資料來源。
-
在右側的下拉式選單中選擇 [+ 新增],然後選取 [新增關聯性]。
-
「探索」現在處於「關聯編輯器」模式中,以藍色邊框表示。
-
從案例下拉式功能表中選取下列案例:CSV 檔案。
-
選取檔案 population_by_state.csv。每個儲存格都是一個連結,您可以按一下該連結以開始建立新關聯。
-
按一下
State
欄中的任何儲存格,以建立將資料連結貼附至該項目的新關聯。例如,選取California
。 -
在分割檢視中,選取您在左窗格中選取的相同資料來源。查詢編輯器上方的輔助程式包含您可以使用目標查詢的所有可用變數。變數包含所選列中的所有資料欄位 (表格欄)。
-
在「案例」功能表中,選取「CSV 度量值」。「查詢編輯器
String Input
」中的欄位會提供具有每年人口值的變數:${1980},${2000},${2020}
。這將使用變量值生成一個圖形。 -
在「查詢編輯器別名」欄位中,輸入
${State}
。執行查詢,查看它是否使用變數的範例值產生圖表。
-
選擇「儲存」以儲存關聯並結束「關聯編輯器」。
儲存關聯後,Explore 會在左窗格中重新執行查詢。按一下狀態名稱,右側的查詢會以插入 CSV 的資料列中的值重新執行,進而變更圖形。每次您按一下狀態名稱時,都會以更新的值重新執行查詢。
您可以將相同的步驟套用至任何資料來源。關聯可讓您在視覺效果中建立連結,以根據選取的資料執行動態查詢。在此範例中,我們使用查詢傳回的資料來建立使用相同資料來源產生不同視覺效果的新查詢。但是,您可以在任何資料來源之間建立關聯性,以建立自訂探索流程。
建立資料表關聯的記錄
在此範例中,您將建立關聯,以示範如何使用轉換從記錄行和其他欄位擷取值。
若要遵循此範例,請確定您已設定測試資料來源。
若要建立資料表關聯的記錄
-
在 Grafana 中,導覽至「探索」。
-
從頁面左上方的下拉式功能表中選取測試資料來源。
-
在右側的下拉式選單中選擇 [+ 新增],然後選取 [新增關聯性]。
-
「探索」現在處於「關聯編輯器」模式中,以藍色邊框表示。
-
在案例功能表中,選取記錄。
-
展開記錄行以查看關聯連結。選取
Correlate with hostname
。 -
「探索」會以分割檢視開啟。選取您在左窗格中選取的相同資料來源。查詢編輯器上方的輔助程式包含您可以使用目標查詢的所有可用變數。
-
展開「變形」區段,然後按一下「新增轉換」。
-
在 [欄位] 下拉式選單中,選取 [訊息]。記錄行會顯示為範例資料。
-
在「類型」下,選取「記錄檔」。這將填充變量列表。
-
選擇「將轉換新增至關聯」。
-
再次選擇「添加轉換」,然後在「字段」下選擇主机
-
在類型之下,選取規則運算式。
-
在「表示式」下,輸入下列內容:
-([0-9]\*)
這會選取虛線右側的任何數字。 -
在「變數名稱」下,輸入下列內容:
hostNumber
這將填充變量列表。 -
選擇「將轉換新增至關聯」,將其新增至其他變數。
-
在資料來源編輯器中,開啟「案例」下拉式功能表,然後選取「CSV 內容」。
-
在下面的文字方塊中,提供下列資訊並儲存關聯:
time,msg,hostNumber,status ${time},${msg},${hostNumber},${status}
這會關閉分割檢視並重新執行左側查詢。展開任何記錄行以查看關聯按鈕。選擇關聯按鈕打開拆分視圖
time
(一個字段),msg
(使用 logfmt 從日誌行中提取),host number
(使用正則表達式從中提取hostname
)和(使用 logfmt 從日誌行中提取)。status