欄位選項和覆寫 - Amazon Managed Grafana

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

欄位選項和覆寫

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

如需支援 Grafana 10.x 版的 Grafana 工作區,請參閱。在 Grafana 第 10 版工作

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

本節說明 Amazon 受管 Grafana 中的欄位選項和欄位覆寫,以及如何使用這些選項。

Grafana 工作區中使用的資料模型 (資料框架) 是統一時間序列和資料表查詢結果的資料欄導向資料表結構。此結構中的每一欄稱為欄位。欄位可以代表單一時間序列或表格欄。

欄位選項可讓您變更資料在視覺效果中的顯示方式。您套用的選項和覆寫不會變更資料,而是會變更 Amazon Managed Grafana 顯示資料的方式。

欄位選項

欄位選項 (標準和自訂) 可以在面板編輯器的 [欄位] 索引標籤上找到。在該標簽上進行的變更應用于所有字段(即系列和列)。例如,如果將單位變更為百分比,則所有具有數值的欄位都會以百分比顯示。瞭解如何在中套用欄位選項設定所有欄位

欄位取代

可以在面板編輯器的「取」頁籤上加入位取代。您可以在此處新增與 [位] 索引標籤上找到的相同選項,但這些選項僅套用至特定欄位。瞭解如何在中套用優先選項設定特定欄位

可用的欄位選項和覆寫

欄位選項類型適用於欄位選項和欄位覆寫。唯一的區別是該變更將應用于所有字段(應用于「字」標簽),還是應用于字段的子集(應用于「覆蓋」標簽)。

設定所有欄位

若要變更所有欄位顯示資料的方式,您可以變更 [位] 索引標籤上的選項。然後,您可以在 [寫] 索引標籤上覆寫特定欄位的欄位選項。如需詳細資訊,請參閱 設定特定欄位

例如,您可以變更「小數」選項,變更所有欄位中顯示的小數位數。若要取得有關選項的更多資訊,請參閱標準欄位選項表格欄位選項

變更欄位選項

您可以根據需要更改任意數量的選項。

變更欄位選項的步驟
  1. 選擇您要編輯的面板,選擇面板標題,然後選擇「編輯」。

  2. 選擇「欄位」頁標。

  3. 尋找您要變更的選項。您可以定義下列項目:

  4. 透過在欄位中新增值來新增選項。若要將選項返回預設值,請刪除欄位中的白色文字。

  5. 完成對管控面板的編輯後,請選擇「儲存」。

欄位選項範例

讓我們假設結果集是由兩個字段組成的數據框:時間和溫度。

time 溫度
2020-01-02 45.0
2020-01-02 47.0
2020-01-02 48.0

此結構的每個欄位 (欄) 都可以套用欄位選項,以改變其值的顯示方式。例如,您可以將「單位」設定為「溫度 > 攝氏」,產生下表。

time 溫度
2020-01-02 攝氏 45.0 度
2020-01-02 攝氏 47.0 度
2020-01-02 攝氏 48.0 度

在這種情況下,小數位並不意味著任何東西。您可以將小數從變更auto為零 (0),產生下表。

time 溫度
2020-01-02 攝氏 45 度
2020-01-02 攝氏 47 度
2020-01-02 攝氏 48 度

設定特定欄位

您可以使用取代來變更一個或多個欄位的設定。覆寫的欄位選項與特定視覺效果中可用的欄位選項完全相同。唯一的區別是您選擇要將其應用於哪些字段。

例如,您可以變更所有數值欄位或欄中顯示的小數位數,方法是變更類型符合「數字」的「小數位數」選項。如需有關選項的詳細資訊,請參閱標準欄位選項,選項適用於所有允許轉換的面板視覺效果,以及表格欄位選項僅套用至表格面板視覺效果。

新增欄位取代

您可以根據需要覆蓋任意數量的字段選項。

加入欄位取代的步驟
  1. 選擇您要編輯的面板,選擇面板標題,然後選擇「編輯」。

  2. 選擇「覆寫」頁標。

  3. 選擇 [新增覆寫]。

  4. 選取您要套用覆寫規則的欄位。

    • 帶有名稱的字段 — 使用該字段從所有可用字段的列表中選擇某個字段。您使用此選取器新增至規則的屬性只會套用至此單一欄位。

    • 具有名稱比對 regex 的欄位 — 使用此選項可指定要使用規則運算式覆寫的欄位。您使用此選取器新增至規則的屬性會套用至欄位名稱與 regex 相符的所有欄位。

    • 具有類型的欄位 — 使用此選項可依類型選取欄位,例如字串、數字等。您使用此選取器新增至規則的性質會套用至符合所選類型的所有欄位。

  5. 選擇 [新增覆寫屬性]。

  6. 選取您要套用的欄位選項。

  7. 透過在欄位中加入值來輸入選項。若要將選項返回預設值,請刪除欄位中的白色文字。

  8. 選擇「加入取代性質」,繼續將取代加入至此欄位,或者您可以選擇「加入取代」並選取要加入取代的其他欄位。

  9. 完成時,選擇儲存

刪除欄位取代

  1. 選擇包含您要刪除之覆寫的「覆寫」頁標。

  2. 選擇覆寫旁邊的垃圾桶圖示。

欄位覆寫範例

假設我們的結果集是由四個字段組成的數據框:時間,高溫,低溫和濕度。

time 高溫 低溫 濕度
2020-01-02 45.0 30.0 67
2020-01-02 47.0 34.0 68
2020-01-02 48.0 31.0 68

讓我們套用來套用欄位選項範例來套用攝氏單位的欄位選項,並擺脫小數位數。這會產生下表。

time 高溫 低溫 濕度
2020-01-02 攝氏 45 度 攝氏 30 度 67 度
2020-01-02 攝氏 47 度 34 度 68 度
2020-01-02 攝氏 48 度 攝氏 31 度 68 度

溫度場看起來不錯,但濕度是無意義的。您可以將欄位選項取代套用至濕度欄位,並將單位變更為雜項 > 百分比 (0-100) 來修正此問題。這導致了一個更有意義的表格。

time 高溫 低溫 濕度
2020-01-02 攝氏 45 度 攝氏 30 度 67%
2020-01-02 攝氏 47 度 34 度 68%
2020-01-02 攝氏 48 度 攝氏 31 度 68%

標準欄位選項

本節說明可用的欄位選項。它們按字母順序列出。

您可以將標準欄位選項套用至大部分的內建 Grafana 工作區面板。某些尚未更新為新面板和資料模型的舊面板和社群面板,將會遺失全部或部分欄位選項。

大多數欄位選項不會影響視覺效果,直到您在編輯的欄位選項方塊之外選擇或按 Enter 鍵。

如需套用這些選項的詳細資訊,請參閱下列各節:

小數

此選項設置渲染值時要包括的小數位數。保留空白,讓 Amazon 受管 Grafana 使用資料來源提供的小數位數。

若要變更此設定,請在欄位中輸入數字。

此選項可控制值或視覺效果連結的 URL。如需詳細資訊和指示,請參閱資料連結

顯示名稱

此選項設置所有字段的顯示標題。您可以在欄位標題中使用變數。如需範本變數和範本變數的詳細資訊,請參閱〈〉模板和變量

顯示多個統計資料、欄位或系列時,此欄位會控制每個統計資料中的標題。您可以使用表示式,例${__field.name}如僅使用系列名稱或標題中的欄位名稱。

給定一個名稱為「溫度」的字段,標籤為 {「LOC」=「PBI」,「傳感器」=「3」}

運算式語法 範例 渲染到 說明
${__field.displayName} 與語法相同 Temp {Loc="PBI", Sensor="3"} 在中顯示欄位名稱和標籤 ({}如果存在)。如果回應中只有一個標籤金鑰,則針對標籤部分,Amazon Managed Grafana 會顯示標籤的值,而不帶括弧。
${__field.name} 與語法相同 Temp 顯示欄位的名稱 (不含標籤)。
${__field.labels} 與語法相同 Loc="PBI", Sensor="3" 顯示不含名稱的標示。
${__field.labels.X} ${__field.labels.Loc} PBI 顯示指定標籤鍵的值。
${__field.labels.__values} 與語法相同 PBI, 3 顯示以逗號分隔的標籤值 (不含標籤鍵)。

如果在轉譯特定欄位的運算式之後,值是空字串,則會使用預設的顯示方法。

最多

此選項可設定百分比臨界值計算中使用的最大值。若要根據所有序列和欄位進行自動計算,請將此設定保留空白。

最少

此選項可設定百分比臨界值計算中使用的最小值。若要根據所有序列和欄位進行自動計算,請將此設定保留空白。

沒有價值

如果欄位值為空或空,請輸入 Amazon 受管 Grafana 應顯示的內容。

單位

此選項指定一個字段應該使用的單位。選擇「單位」欄位,然後向下追溯,直到找到所需的單位為止。您選取的單位會套用至除時間以外的所有欄位。

自訂單位

您也可以使用單位下拉式清單來指定自訂單位、自訂字首或尾碼,以及日期/時間格式。

若要選取自訂單位,請輸入單位,然後在下拉式清單中Custom: xxx選取最後一個選項。

  • suffix:<suffix>對於應該在價值之後的自定義單位。

  • time:<format>用於自訂日期/時間格式;例如,time:YYYY-MM-DD。如需格式語法和選項的資訊,請參閱顯示

  • si:<base scale><unit characters>針對自訂 SI 單位;例如,si: mF。此選項稍微進階一些,因為您可以同時指定單位和來源資料比例。例如,如果您的來源資料表示為毫 (千) 單位,請在單位前面加上 SI 縮放字元。

  • count:<unit>用於自定義計數單位。

  • currency:<unit>用於自訂貨幣單位。

您也可以在單位選擇器中貼上原生表情符號,並將其挑選為自訂單位。

字串單位

Amazon 託管的 Grafana 有時可以解析字符串並將其顯示為數字。若要讓 Amazon 受管 Grafana 顯示原始字串,請建立欄位覆寫並使用該string單位新增單位屬性。

配色方案

欄位色彩選項定義 Amazon 託管 Grafana 系列或欄位的顏色方式。這裡有多種不同的工作模式,其公用程式在很大程度上取決於目前選取的視覺效果。

連續色彩模式會使用相對於最小值和最大值的百分比來內插顏色。

  • 單色-通過使用顏色選擇器設置特定的顏色。這是從覆寫規則中最有用的。

  • 從臨界值 — 衍生自相符臨界值的顏色。這對於量規、統計資料和表格視覺效果非常有用。

顏色按系列

Amazon 託管 Grafana 包括按系列定義顏色的配色方案。例如,這對於圖形和餅圖非常有用。

按價值顯示顏色

Amazon 託管 Grafana 還包括連續(漸變)配色方案。這對於為個別值著色的視覺效果很有用;例如,統計面板和表格面板。

閾值

您可以使用閾值根據值更改字段的顏色。如需詳細資訊和指示,請參閱閾值

值映射

您可以使用此選項來設定將欄位值或值範圍轉換為明確文字的規則。您可以新增多個值對映。

  • 對應類型 — 選擇一個選項。

    • — 輸入值。如果欄位值大於或等於值,則會顯示「文字」。

    • 起始終止 — 輸入範圍。如果欄位值介於或等於範圍內的值,則會顯示「文字」。

  • 本」— 在字段中滿足條件時顯示的文本。此欄位接受變數。