本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
转换
本文件主題是針對支援 Grafana 8.x 版的 Grafana 工作區所設計。
如需支援 Grafana 10.x 版的 Grafana 工作區,請參閱。在 Grafana 第 10 版工作
如需支援 Grafana 9.x 版的 Grafana 工作區,請參閱。在 Grafana 第 9 版中工作
轉換會在結果集傳遞至視覺效果之前處理結果集。您可以在 Amazon 受管的 Grafana 面板編輯器的「轉換」索引標籤中存取轉換。
您可以使用轉換來重新命名欄位、將不同的時間序列結合在一起、跨查詢執行數學運算等等。如果您有大型儀表板或大量查詢,則能夠將查詢結果從一個面板重複使用到另一個面板可以提供巨大的效能增益。
注意
轉換有時會導致無法繪製圖形的資料。發生這種情況時,Amazon 受管 Grafana 會在視覺效果上顯示建議。選擇切換到表可視化的建議。這通常可以幫助您更好地了解轉型對數據的影響。
Amazon 受管的 Grafana 按照屏幕上列出的順序應用轉換。每個轉換都會建立一個新的結果集,該結果集會傳遞至管線中的下一個轉換。
訂單可以使你的結果看起來有巨大的差異. 例如,如果您使用 reduce 轉換將一個資料欄的所有結果壓縮為單一值,則只能將變形套用至該單一值。
先決條件
在套用變形之前,下列所有條件都必須成立:
-
您已輸入查詢並從資料來源傳回資料。如需有關查詢的詳細資訊,請參閱查詢。
-
您已套用支援查詢的視覺效果,例如下列其中一個視覺效果:
-
棒規
-
量測計
-
圖表
-
熱圖
-
日誌
-
Stat
-
資料表
-
套用轉換
您可以從面板編輯器底部窗格的「轉換」標籤 (位於「查詢」頁籤旁) 找到轉換。
套用變形的步驟
-
在您要新增變形的面板上,選擇面板標題,然後選擇「編輯」。
-
選擇轉換索引標籤。
-
選取轉換。
在顯示的轉換資料列中,您可以設定轉換選項。
-
若要套用其他變形,請選擇「新增變形」。請記住,下一個轉換作用於上一個轉換所傳回的結果集。
如果您遇到問題,請選擇錯誤圖示來偵錯轉換。
若要移除轉換,請選擇垃圾桶圖示。
轉換類型和選項
Grafana 工作區包含下列轉換。
減少
當您想要將結果簡化為一個值時,請套用「減少」轉換。減少基本上刪除時間組件。如果視覺化為一個表,它減少了一列下降到一行(值)。
在「計算」欄位中,輸入一或多個計算類型。選擇以查看計算選項清單。如需有關可用計算的資訊,請參閱計算清單。
選取至少一個計算後,Amazon 受管 Grafana 會使用您選取的計算方式顯示一個值。如果您選取多個計算,則會顯示多個值。
Merge
使用此轉換可將多個查詢的結果合併為單一結果。這在使用表格面板視覺效果時很有幫助。可以合併的值會合併到同一列中。如果共用欄位包含相同的資料,則可以合併值。
在下列範例中,兩個查詢會傳回資料表資料。在套用轉換之前,資料會視覺化為兩個獨立的表格。
查詢 A
時間 | 任務 | 運行時 |
---|---|---|
2020-07-07 11:34:20 | 節點 | 25260122 |
2020-07-07 | 後備 | 123001233 |
查詢 B
時間 | 任務 | 錯誤 |
---|---|---|
2020-07-07 11:34:20 | 節點 | 15 |
2020-07-07 | 後備 | 5 |
這是應用合併轉換後的結果。
時間 | 任務 | 錯誤 | 運行時 |
---|---|---|---|
2020-07-07 11:34:20 | 節點 | 15 | 25260122 |
2020-07-07 | 後備 | 5 | 123001233 |
按名稱篩選
使用此轉換可移除部分查詢結果。
Amazon 受管 Grafana 會顯示識別碼欄位,後面接著查詢傳回的欄位。
您可以使用下列兩種方式之一來套用篩選條件:
-
輸入正則表達式表達式。
-
選擇要在該欄位上切換篩選的欄位。篩選的欄位會以深灰色文字顯示,未篩選的欄位則為白色文字。
按查詢過濾數據
如果您要隱藏一或多個查詢,請在具有多個查詢的面板中使用此轉換。
Amazon 受管的 Grafana 會以深灰色文字顯示查詢識別字母。若要切換篩選,請選擇查詢識別碼。如果查詢字母為白色,則會顯示結果。如果查詢字母很暗,則會隱藏結果。
組織欄位
使用此轉換可重新命名、重新排序或隱藏查詢傳回的欄位。
注意
此轉換只能在具有單一查詢的面板中運作。如果您的面板有多個查詢,則必須應用連接按字段(外部聯接)轉換或刪除額外的查詢。
Amazon 受管的 Grafana 顯示查詢返回的字段列表。您可以進行下列任何變更:
-
通過暫停在字段上來更改字段順序。游標會變成一隻手,然後您可以將欄位拖曳到新位置。
-
選擇欄位名稱旁的眼睛圖示,以隱藏或顯示欄位。
-
在「重新命名」方塊中輸入新名稱來重新命名欄位。
按字段加入(外部連接)
使用此轉換可依欄位連接結果集中的多個時間序列。
如果您要合併查詢,以便計算欄位中的結果,此轉換非常有用。
從計算新增欄位
使用此轉換可新增從其他兩個欄位計算的新欄位。每次轉換都允許您添加一個新字段。
-
模式 — 選取模式:
-
減少列 — 對所選欄位的每一列單獨套用選取的計算。
-
二進位選項 — 對兩個選取欄位中單列的值套用基本數學運算 (
sum
multiply
、等)。
-
-
欄位名稱 — 選取要用於計算新欄位的欄位名稱。
-
計算- 選取要在 Amazon 受管 Grafana 建立新欄位時使用的計算。選擇欄位以查看計算選項清單。如需有關可用計算的資訊,請參閱計算清單。
-
別名 — (選擇性) 輸入新欄位的名稱。如果您將此欄位保留空白,則會命名該欄位以符合計算。
-
取代所有欄位 — (選用) 如果您想要隱藏所有其他欄位,並在視覺效果中僅顯示您的計算欄位,請使用此選項。
欄位的標籤
注意
若要套用此轉換,您的查詢必須傳回已標記的欄位。
當您選取此轉換時,Amazon 受管 Grafana 會自動將所有標記的資料轉換為欄位。
例如,假設兩個時間序列的查詢結果。
1:標籤服務器 = 服務器 A,數據中心 = 歐盟 2:標籤服務器 = 服務器 B,數據中心 = 歐盟
此轉換將產生下表。
時間 | Server | Datacenter | Value |
---|---|---|---|
2020-07-07 11:34:20 | 伺服器 A | 歐盟 | 1 |
2020-07-07 11:34:20 | 服務器 B | 歐盟 | 2 |
值欄位名稱;如果您選取 Server
「值」欄位名稱,則每個Server
標籤值都會有一個欄位。
時間 | Datacenter | 伺服器 A | 服務器 B |
---|---|---|---|
2020-07-07 11:34:20 | 歐盟 | 1 | 2 |
分組依據
此轉換會依設定的欄位對每個影格進行排序。核取reverse
時,會以相反的順序傳回值。
分組依據
此轉換會依指定的欄位 (欄) 值將資料分組,並處理每個群組的計算。可用的計算方式與「減少」轉換的計算方式相同。
以下是原始資料的範例。
時間 | 伺服器 ID | CPU 溫度 | 伺服器狀態 |
---|---|---|---|
2020-07-07 11:34:20 | 服務器 1 | 80 | Shutdown |
2020-07-07 11:34:20 | 服務器 3 | 62 | OK |
2020-07-07 | 服務器 2 | 90 | 超載 |
2020-07-07 10:31:22 | 服務器 3 | 55 | OK |
2020-07-07 09:30:57 | 服務器 3 | 62 | Rebooting (重新開機中) |
2020-07-07 | 服務器 2 | 88 | OK |
2020-07-07 09:28:06 | 服務器 1 | 80 | OK |
2020-07-07 09:25 | 服務器 2 | 88 | OK |
2020-07-07 | 服務器 1 | 86 | OK |
此轉換需要兩個步驟。首先,您可以指定一個或多個欄位來分組資料。這會將這些欄位的所有相同值分組在一起,就好像您對它們進行排序一樣。例如,如果您按Server ID
字段分組,它將以這種方式對數據進行分組:
時間 | 伺服器 ID | CPU 溫度 | 伺服器狀態 |
---|---|---|---|
2020-07-07 11:34:20 | 服務器 1 | 80 | Shutdown |
2020-07-07 09:28:06 | 服務器 1 | 80 | OK |
2020-07-07 | 服務器 1 | 86 | OK |
2020-07-07 10:32:20 | server 2 | 90 | Overload 2020-07-07 09:30:05 | server 2 | 88 | OK 2020-07-07 09:25:05 | server 2 | 88 | OK 2020-07-07 11:34:20 | server 3 | 62 | OK 2020-07-07 10:31:22 | server 3 | 55 | OK 2020-07-07 09:30:57 | server 3 | 62 | Rebooting
具有相同值的所有列Server ID
都會群組在一起。
選擇要對數據進行分組的字段後,您可以在其他字段上添加各種計算,並且計算將應用於每組行。例如,您可能想要計算每個伺服器的平均值CPU
temperature
。您可以添加應用於CPU
Temperature
字段的平均值計算以獲取以下內容。
伺服器 ID | CPU 溫度 (平均值) |
---|---|
服務器 1 | 82 |
服務器 2 | 88.6 |
服務器 3 | 59.6 |
您可以新增多個這些計算。例如,您可以使用以下計算。
-
對於現場
Time
,您可以計算最後一個值,以了解每個服務器的最後一個數據點何時接收到。 -
對於欄位
Server Status
,您可以計算「最後」值以瞭解每個伺服器的最後一個狀態值。 -
對於現場
Temperature
,您還可以計算最後一個值以了解每台服務器的最新監控溫度。
「群組依據」轉換會產生下列結果。
伺服器 ID | CPU 溫度 (平均值) | CPU 溫度 (最後一個) | 時間 (最後) | 伺服器狀態 (最後一個) |
---|---|---|---|---|
服務器 1 | 82 | 80 | 2020-07-07 11:34:20 | Shutdown |
服務器 2 | 88.6 | 90 | 2020-07-07 | 超載 |
服務器 3 | 59.6 | 62 | 2020-07-07 11:34:20 | OK |
使用此轉換,您可以從時間序列中提取一些關鍵信息,並以便捷的方式顯示它。
序列到行
使用此轉換可將來自多個時間序列資料查詢的結果合併為單一結果。這在使用表格面板視覺效果時很有幫助。
此轉換的結果將包含三個資料欄:Time
Metric
、和Value
。此資Metric
料欄已新增,讓您可以查看測量結果來源於哪個查詢。透過在來源查詢Label
上定義來自訂此值。
在以下範例中,兩個查詢會傳回時間序列資料。在套用轉換之前,它會視覺化為兩個獨立的表格。
查詢 A
時間 | 溫度 |
---|---|
2020-07-07 11:34:20 | 25 |
2020-07-07 10:31:22 | 22 |
2020-07-07 | 19 |
查詢 B
時間 | 濕度 |
---|---|
2020-07-07 11:34:20 | 24 |
2020-07-07 | 29 |
2020-07-07 09:30:57 | 33 |
套用Series to rows
變形會產生下列結果。
時間 | 指標 | Value |
---|---|---|
2020-07-07 11:34:20 | 溫度 | 25 |
2020-07-07 11:34:20 | 濕度 | 22 |
2020-07-07 | 濕度 | 29 |
2020-07-07 10:31:22 | 溫度 | 22 |
2020-07-07 09:30:57 | 濕度 | 33 |
2020-07-07 | 溫度 | 19 |
按值過濾數據
此轉換可讓您直接在 Grafana 工作區中篩選資料,並從查詢結果中移除一些資料點。您可以選擇包含或排除符合您定義之一或多個條件的資料。條件會套用至選取的欄位。
如果您的資料來源未依值進行原生篩選,則此轉換非常有用。如果您使用共用查詢,也可以使用此選項來縮小顯示的值。
所有欄位的可用條件如下:
-
正則表達式-匹配正則表達式。
-
為空 — 如果值為空,則相符。
-
不為空值 — 如果值不為空,則相符。
-
E@@ qual — 如果值等於指定值,則相符。
-
不同 — 如果值與指定值不同,則相符。
數字欄位的可用條件如下:
-
大於 — 如果值大於指定值,則相符。
-
較低 — 如果值小於指定值,則相符。
-
大於或等於 — 如果值大於或等於指定值,則相符。
-
小於或等於 — 如果值小於或等於指定值,則相符。
-
範圍 — 符合指定最小值和最大值之間的範圍。最小值和最大值都包含在範圍內。
您可以將多個條件新增至篩選器。當您有多個條件時,您可以選擇是否要在符合所有條件的列上套用「包含」或「排除」動作。
系統會忽略無效或設定不完整的條件。
除錯轉換
若要查看轉換的輸入和輸出結果集,請選擇轉換資料列右側的錯誤圖示。
Amazon 受管的 Grafana 會在轉換列下方顯示轉換偵錯檢視。