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

# Grafana 第 9 版中的面板和視覺化
<a name="v9-panels"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

 *面板*是 Grafana 中的基本視覺化建置區塊。每個面板都有一個查詢編輯器，專用於面板中選取的資料來源。查詢編輯器可讓您建置查詢，以傳回您要視覺化的資料。

 每個面板有各種樣式和格式選項。面板可以拖曳、捨棄和調整大小，以在儀表板上重新排列。

 新增面板之前，請確定您已設定資料來源。

其他面板類型可以透過將其他[外掛程式](grafana-plugins.md)安裝到您的工作區來使用。
+  如需使用特定資料來源的詳細資訊，請參閱 [連線至資料來源](AMG-data-sources.md)。

**Topics**
+ [面板編輯器概觀](v9-panels-editor-overview.md)
+ [設定面板選項](v9-panels-configure-panel-options.md)
+ [設定標準選項](v9-panels-configure-standard-options.md)
+ [查詢和轉換資料](v9-panels-query-xform.md)
+ [設定閾值](v9-panels-configure-thresholds.md)
+ [設定資料連結](v9-panels-configure-data-links.md)
+ [設定欄位覆寫](v9-panels-configure-overrides.md)
+ [設定值映射](v9-panels-configure-value-mappings.md)
+ [設定圖例](v9-panels-configure-legend.md)
+ [計算類型](v9-panels-calculation-types.md)
+ [註釋視覺效果](v9-panels-annotate-visualizations.md)
+ [面板檢查檢視](v9-panels-panel-inspector.md)
+ [Grafana 第 9 版中可用的視覺化](v9-panels-viz.md)

# 面板編輯器概觀
<a name="v9-panels-editor-overview"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

 本節說明 Grafana 面板編輯器的區域。
+  面板標頭：標頭區段列出顯示面板的儀表板，以及下列控制項：
  +  **儀表板設定 （齒輪） 圖示：**按一下以存取儀表板設定。
  +  **捨棄：**捨棄您自上次儲存儀表板以來對面板所做的變更。
  +  **儲存：**儲存您對面板所做的變更。
  +  **套用：**套用您所做的變更並關閉面板編輯器，讓您返回儀表板。您必須儲存儀表板，才能保留套用的變更。
+  視覺化預覽：視覺化預覽區段包含下列選項：
  +  **資料表檢視：**將任何視覺化轉換為資料表，以便您可以查看資料。資料表檢視有助於故障診斷。此檢視僅包含原始資料。它不包括您可能已套用至資料或[資料表](v9-panels-table.md)視覺化中可用格式選項的轉換。
  +  **填滿：**視覺化預覽會填滿可用空間。如果您變更側邊窗格的寬度或底部窗格的高度，視覺效果會變更以填滿可用空間。
  +  **實際：**視覺化預覽的大小將與儀表板上的大小完全相同。如果沒有足夠的可用空間，視覺效果將縮減以保留長寬比。
  +  **時間範圍控制：****預設**是瀏覽器本機時區，或在較高層級選取的時區。
+  資料區段：資料區段包含標籤，您可以在其中輸入查詢、轉換資料，以及建立提醒規則 （如適用）。
  +  **查詢索引標籤：**選取您的資料來源，然後在此處輸入查詢。
  +  **轉換索引標籤：**套用資料轉換。
  +  **提醒索引標籤：**寫入提醒規則。
+  面板顯示選項：顯示選項區段包含標籤，您可以在其中設定資料視覺化的幾乎每個層面。

## 開啟面板檢查抽屜
<a name="v9-panels-editor-open-panel"></a>

 檢查抽屜可協助您了解面板並進行故障診斷。您可以檢視任何面板的原始資料、將該資料匯出至逗號分隔值 (CSV) 檔案、檢視查詢請求，以及匯出面板和資料 JSON。

 **注意：**並非所有面板類型都包含所有標籤。例如，儀表板清單面板沒有要檢查的原始資料，因此不會顯示統計資料、資料或查詢索引標籤。

 面板檢查器包含下列選項：
+  面板檢查抽屜顯示會在右側開啟抽屜。按一下右上角的箭頭以展開或減少抽屜窗格。
+  **資料索引標籤 -** 顯示套用轉換的查詢傳回的原始資料。預設不會套用覆寫和值映射等欄位選項。
+  **統計資料索引標籤 -** 顯示查詢需要多長時間，以及傳回多少。
+  **JSON 索引標籤 -** 可讓您檢視和複製面板 JSON、面板資料 JSON 和資料框架結構 JSON。如果您佈建或管理 Grafana，這會很有用。
+  **查詢索引標籤 -** 顯示 Grafana 查詢資料來源時傳送至伺服器的請求。
+  **錯誤索引標籤 -** 顯示錯誤。只有在查詢傳回錯誤時才會顯示。

# 設定面板選項
<a name="v9-panels-configure-panel-options"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

 Grafana 面板是您用來定義資料來源查詢的使用者介面，以及轉換和格式化視覺效果中顯示的資料。

 面板編輯器包含查詢建置器和一系列選項，您可以用來轉換資料並將資訊新增至面板。

 本主題說明如何：
+  開啟面板以進行編輯 
+  新增面板標題和描述 
+  檢視面板 JSON 模型 
+  新增重複資料列和面板 

## 編輯面板
<a name="v9-panels-edit-a-panel"></a>

 將面板新增至儀表板後，您可以隨時開啟它以變更或更新查詢、新增資料轉換，以及變更視覺化設定。

1.  開啟包含您要編輯之面板的儀表板。

1.  將滑鼠游標移至面板的任何部分，即可在右上角顯示動作選單。

1.  按一下選單，然後選取**編輯**。

    若要使用鍵盤快速鍵開啟面板，請將滑鼠游標移至面板上，然後按 **e**。

    面板會以編輯模式開啟。

## 將標題和描述新增至面板
<a name="v9-panels-add-title-description"></a>

 將標題和描述新增至面板，以與使用者共用視覺化的任何重要資訊。例如，使用 描述來記錄視覺化的目的。

1.  編輯面板。

1.  在面板顯示選項窗格中，找到**面板選項**區段。

1.  輸入**標題**。

    此欄位中輸入的文字會顯示在面板編輯器和儀表板的面板頂端。

1.  撰寫面板和您要顯示之資料的描述。

    在此欄位中輸入的文字會顯示在面板左上角的工具提示中。

    您可以使用您在**標題**和**描述**欄位中[定義的變數](v9-dash-variables.md)，但不能使用[全域變數](v9-dash-variable-add.md#v9-dash-variable-add-global)。

    

## 檢視面板 JSON 模型
<a name="v9-panels-json-model"></a>

 探索和匯出面板、面板資料和資料框架 JSON 模型。

1.  開啟包含面板的儀表板。

1.  將滑鼠游標移至面板的任何部分，即可在右上角顯示動作選單。

1.  按一下選單，然後選取**檢查 > 面板 JSON**。

1.  在**選取來源**欄位中，選取下列其中一個選項：
   +  **面板 JSON：**顯示代表面板的 JSON 物件。
   +  **面板資料：**顯示代表傳遞至面板之資料的 JSON 物件。
   +  **DataFrame 結構：**顯示套用轉換、欄位組態和覆寫組態的原始結果集。

1.  若要探索 JSON，請按一下 **>** 以展開或摺疊 JSON 模型的部分。

## 設定重複面板
<a name="v9-panels-configure-repeating-panels"></a>

 您可以設定 Grafana 將面板或資料列動態新增至儀表板。動態面板是系統根據變數值建立的面板。變數可動態變更儀表板中所有面板的查詢。

**注意**  
重複面板需要變數來選取一或多個項目；您無法重複面板零次來隱藏它。

 **開始之前：**
+  確定查詢包含多值變數。

 **若要設定重複面板：**

1. 編輯您要重複的面板。

1.  在顯示選項窗格中，按一下**面板選項 > 重複選項**。

1.  選取**方向**。
   +  選擇**水平**以side-by-side排列面板。Grafana 會調整重複面板的寬度。目前，您無法將資料列上的其他面板與重複的面板混合。
   +  選擇**垂直**以排列資料欄中的面板。重複面板的寬度與原始的重複面板相同。

1.  若要將變更傳播到所有面板，請重新載入儀表板。

# 設定標準選項
<a name="v9-panels-configure-standard-options"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

 Grafana 中使用的資料模型是一種單欄式導向資料表結構，可統一時間序列和資料表查詢結果。此結構中的每個資料欄稱為 *欄位*。欄位可以代表單一時間序列或資料表資料欄。

 欄位選項可讓您變更資料在視覺效果中的顯示方式。您套用的選項和覆寫不會變更資料，而是變更 Grafana 顯示資料的方式。當您變更選項時，它會套用至所有欄位，這表示所有序列或資料欄。例如，如果您將單位變更為百分比，則具有數值的所有欄位都會以百分比顯示。

 如需欄位格式化選項的完整清單，請參閱[標準選項定義](#v9-panels-standard-options-definitions)。

**注意**  
 您可以將標準選項套用至大多數內建的 Grafana 面板。有些舊版面板和社群面板尚未更新為新的面板和資料模型，將會缺少所有或部分欄位選項。

1.  開啟儀表板，按一下面板標題，然後按一下**編輯**。

1.  在面板顯示選項窗格中，找到**標準選項**區段。

1.  選取您要套用的標準選項。

1.  若要預覽變更，請按一下您正在編輯的欄位選項方塊外部，或按 **Enter** 鍵。

## 標準選項定義
<a name="v9-panels-standard-options-definitions"></a>

 本節說明所有可用的標準選項。

 您可以將標準選項套用至大多數內建的 Grafana 面板。有些舊版面板和社群面板尚未更新為新的面板和資料模型，將會缺少所有或部分欄位選項。

 在編輯欄位選項方塊外按一下或按下 Enter 鍵之前，大多數欄位選項都不會影響視覺化。

**注意**  
 我們不斷努力為所有視覺效果新增和擴展選項，因此並非所有選項都適用於所有視覺效果。

### 單位
<a name="v9-panels-standard-options-unit"></a>

 可讓您選擇欄位應使用的單位。按一下**單位**欄位中的 ，然後向下切入，直到您找到所需的單位為止。您選擇的單位會套用至時間以外的所有欄位。

#### 自訂單位
<a name="v9-panels-standard-options-custom-units"></a>

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

 若要選取自訂單位，請輸入單位，然後在下拉式清單中選取最後一個**自訂：xxx **選項。
+  **suffix：<suffix>** 代表應該在值之後的自訂單位。
+  **字首：<prefix>** 代表應該在值前面的自訂單位。
+  **time：<format>** 對於自訂日期時間格式類型，例如 **time：YYYY-MM-DD**。請參閱[格式](https://momentjs.com/docs/#/displaying/)語法和選項的格式。
+  **si：<base scale><unit characters>** 表示自訂 SI 單位。例如：**si： mF**。這會更進階，因為您可以同時指定單位和來源資料擴展。因此，如果您的來源資料以毫秒 （數千） 表示，則在單位前面加上該 SI 縮放字元。
+  自訂計數單位的 **count：<unit>**。
+  **currency：<unit>** 用於自訂貨幣單位。

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

#### 字串單位
<a name="v9-panels-standard-options-string-units"></a>

 Grafana 有時在剖析字串並將其顯示為數字時過於積極。若要設定 Grafana 以顯示原始字串值，請建立欄位覆寫，並使用**字串**單位新增單位屬性。

### 最少
<a name="v9-panels-standard-options-min"></a>

 可讓您設定百分比閾值計算中使用的最小值。根據所有序列和欄位，保留空白以進行自動計算。

### 最多
<a name="v9-panels-standard-options-max"></a>

 可讓您設定百分比閾值計算中使用的最大值。根據所有序列和欄位，保留空白以進行自動計算。

### 小數位數
<a name="v9-panels-standard-options-decimals"></a>

 指定 Grafana 在轉譯值中包含的小數位數。如果您將此欄位保留空白，Grafana 會根據值自動截斷小數位數。例如，1.1234 會顯示為 1.12，而 100.456 會顯示為 100。

 若要顯示所有小數，請將單位設定為**字串**。

### 顯示名稱
<a name="v9-panels-standard-options-displayname"></a>

 可讓您設定所有欄位的顯示標題。您可以使用[變數](v9-dash-variables.md)。

 顯示多個統計資料、欄位或序列時，此欄位會控制每個統計資料中的標題。您可以使用 **\$1\$1\$1\$1field.name\$1 等表達式**，只使用序列名稱或標題中的欄位名稱。

 指定名稱為 Temp 的欄位，以及 \$1"Loc"="PBI"、"Sensor"="3"\$1 的標籤 


|  運算式語法  |  範例  |  轉譯至  |  說明  | 
| --- | --- | --- | --- | 
|  \$1\$1\$1\$1field.displayName\$1  |  與語法相同  |  溫度 \$1Loc="PBI"， Sensor="3"\$1  |  顯示欄位名稱，如果標籤存在，則顯示在 \$1\$1 中。如果回應中只有一個標籤索引鍵，則對於標籤部分，Grafana 會顯示不含括住括號的標籤值。 | 
|  \$1\$1\$1\$1field.name\$1  |  與語法相同  |  Temp  |  顯示欄位的名稱 （不含標籤）。 | 
|  \$1\$1\$1\$1field.labels\$1  |  與語法相同  |  Loc="PBI"， Sensor="3" |  顯示不含名稱的標籤。 | 
|  \$1\$1\$1\$1field.labels.X\$1  |  \$1\$1\$1\$1field.labels.Loc\$1  |  PBI  |  顯示指定標籤索引鍵的值。 | 
|  \$1\$1\$1\$1field.labels.\$1\$1values\$1  |  與語法相同  |  PBI，3  |  顯示以逗號分隔的標籤值 （不含標籤索引鍵）。 | 

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

### 顏色方案
<a name="v9-panels-standard-options-color-scheme"></a>

 顏色選項及其對視覺效果的影響取決於您正在使用的視覺效果。有些視覺效果有不同的顏色選項。

 您可以指定單一顏色，或根據值選取連續 （漸層） 顏色方案。連續顏色使用相對於最小值和最大值的值百分比來插補顏色。

 選取下列其中一個調色盤：


|  顏色模式  |  Description  | 
| --- | --- | 
|  單一顏色  |  指定單一顏色，在覆寫規則中很有用  | 
|  從閾值  |  通知 Grafana 從相符閾值取得顏色  | 
|  傳統調色盤  |  Grafana 會透過依序列索引查詢調色盤中的顏色來指派顏色。適用於圖形、圓餅圖和其他分類資料視覺化  | 
|  Green-Yellow-Red （依值）  |  持續顏色方案  | 
|  Blue-Yellow-Red （依值）  |  持續顏色方案  | 
|  藍色 （依值）  |  持續顏色方案 （面板背景到藍色）  | 
|  紅色 （依值）  |  持續顏色方案 （面板背景顏色到藍色）  | 
|  綠色 （依值）  |  持續顏色方案 （面板背景顏色到藍色）  | 
|  紫色 （依值）  |  持續顏色方案 （面板背景顏色到藍色）  | 

### 無值
<a name="v9-panels-standard-options-no-value"></a>

 如果欄位值為空或 null，請輸入 Grafana 應顯示的內容。預設值為連字號 (-)。

# 查詢和轉換資料
<a name="v9-panels-query-xform"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

Grafana 支援許多類型的[資料來源](AMG-data-sources.md)。資料來源*查詢*會傳回 Grafana 可以*轉換*和視覺化的資料。每個資料來源都使用自己的查詢語言，且每個資料來源外掛程式都會實作稱為查詢編輯器的查詢建置使用者介面。

## 關於查詢
<a name="v9-panels-query-xform-about"></a>

Grafana 面板會透過查詢與資料來源通訊，以擷取視覺化資料。查詢是以資料來源使用的查詢語言撰寫的問題。

您可以在面板的資料來源選項中設定查詢頻率和資料收集限制。Grafana 每個面板最多支援 26 個查詢。

您可以在資料來源區段中找到每個[資料來源](AMG-data-sources.md)查詢語言的詳細資訊。

**查詢編輯器**

每個資料來源的*查詢編輯器*都提供自訂的使用者介面，協助您撰寫利用其唯一功能的查詢。

由於查詢語言之間的差異，每個資料來源查詢編輯器的外觀和功能都不同。根據您的資料來源，查詢編輯器可能會提供自動完成功能、指標名稱、變數建議或視覺化查詢建置界面。

如需特定資料來源唯一查詢編輯器功能的詳細資訊，請參閱其文件：
+ 如需 Grafana 隨附的資料來源，請參閱[內建資料來源](AMG-data-sources-builtin.md)。
+ 如需 Grafana Enterprise 編輯隨附的資料來源，請參閱 [連線至企業資料來源](AMG-data-sources-enterprise.md)。

**查詢語法**

資料來源使用不同的查詢語言來請求資料。如需特定資料來源唯一查詢語言的詳細資訊，請參閱其文件。

**PostgreSQL 範例：**

```
SELECT hostname FROM host WHERE region IN($region)
```

**PromQL 範例：**

```
query_result(max_over_time(<metric>[${__range_s}s]) != <state>)
```

**特殊資料來源**

Grafana 也包含三個特殊資料來源：**Grafana**、**Mixed** 和 **Dashboard**。如需詳細資訊，請參閱資料來源

## 導覽查詢索引標籤
<a name="v9-panels-query-xform-navigate"></a>

面板的**查詢**索引標籤包含下列元素：
+ **資料來源選取器** – 選取要查詢的資料來源。
+ **查詢選項：** – 設定最大資料擷取參數和查詢執行時間間隔。
+ **查詢檢查器按鈕：** – 開啟查詢檢查器面板，您可以在其中檢視和最佳化查詢。
+ **查詢編輯器清單：** – 列出您寫入的查詢。
+ **表達式：** – 使用表達式建置器來建立提醒表達式。如需運算式的相關資訊，請參閱[寫入表達式查詢](v9-panels-query-xform-expressions.md)。

## 新增查詢
<a name="v9-panels-query-xform-add"></a>

查詢會傳回 Grafana 在儀表板面板中視覺化的資料。當您建立面板時，Grafana 會自動選取預設資料來源。

**新增查詢**

1. 編輯您要新增查詢的面板。

1. 選擇 **Queries** (查詢) 索引標籤。

1. 選擇**資料來源**下拉式功能表，然後選取資料來源。

1. 選擇**查詢選項**來設定所需的資料點數量上限。如需查詢選項的詳細資訊，請參閱 [查詢選項](#v9-panels-query-xform-options)。

1. 使用查詢編輯器撰寫查詢。

1. 選擇**套用**。

Grafana 會查詢資料來源並視覺化資料。

## 管理查詢
<a name="v9-panels-query-xform-manage"></a>

Grafana 會在可摺疊查詢列中組織查詢。每個查詢列都包含查詢編輯器，並以字母 (A、B、C 等） 識別。

若要管理您的查詢，您可以複製查詢、隱藏查詢、移除查詢、重新排序查詢，以及切換查詢編輯器的說明。

## 查詢選項
<a name="v9-panels-query-xform-options"></a>

選擇資料來源選擇器旁的**查詢選項**，以查看所選資料來源的設定。您在此處所做的變更只會影響在此面板中進行的查詢。

Grafana 會設定以深灰色文字顯示的預設值。變更會以白色文字顯示。若要將欄位傳回預設設定，請從 欄位刪除白色文字。

面板資料來源查詢選項包括：
+ **最大資料點** – 如果資料來源支援，這會設定傳回的每個序列的資料點數目上限。如果查詢傳回的資料點超過最大資料點設定，則資料來源會藉由依平均、最大或其他函數彙總它們來減少傳回的點數。

  您可以限制點數量，以改善查詢效能或平滑視覺化線條。預設值是圖形的寬度 （或像素數），因為您只能將圖形面板有空間可顯示的資料點視覺化。

  使用串流資料時，Grafana 會使用滾動緩衝區的最大資料點值。串流是資料的連續流程，緩衝會將串流分割成區塊。例如，Loki 以即時結尾模式串流資料。
+ **最小間隔** – 設定自動計算間隔的最小限制，通常是最小抓取間隔。如果資料點每 15 秒儲存一次，則不會因為間隔低於此值而受益。您也可以將此設定為高於湊集間隔的最小值，以擷取更粗細且功能良好的查詢。
+ **間隔** – 設定您在依時間彙總或分組資料點時可以使用的時間範圍。

  Grafana 會自動計算適當的間隔，您可以在範本查詢中用作變數。變數的測量單位為秒 (`$__interval`) 或毫秒 ()`$__interval_ms`。

  間隔通常用於彙總函數，例如總和或平均值。例如，這是使用間隔變數 的 Prometheus 查詢`rate(http_requests_total[$__interval])`。

  此自動間隔是根據圖形的寬度計算。當使用者縮小視覺化效果時，間隔會增加，導致更粗細的彙總。同樣地，如果使用者放大，間隔會減少，導致更精細的彙總。

  如需詳細資訊，請參閱[全域變數](v9-dash-variable-add.md#v9-dash-variable-add-global)。
+ **相對時間** – 覆寫個別面板的相對時間範圍，這會導致它們與儀表板右上角儀表板時間選擇器中選取的時間範圍不同。您可以使用此功能在相同的儀表板上顯示不同時段或天數的指標。
**注意**  
當儀表板的時間範圍為絕對時，面板時間覆寫不會有任何影響。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/grafana/latest/userguide/v9-panels-query-xform.html)
+ **時間轉移** – 透過相對於時間挑選器轉移其開始和結束來覆寫個別面板的時間範圍。例如，您可以將面板的時間範圍變更為早於儀表板時間挑選器兩小時。
**注意**  
當儀表板的時間範圍為絕對值時，面板時間覆寫不會有任何影響。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/grafana/latest/userguide/v9-panels-query-xform.html)
+ **快取逾時** – *（只有在資料來源中可用時才可見）* 如果您的時間序列存放區具有查詢快取，則覆寫預設快取逾時。將此值指定為以秒為單位的數值。

# 寫入表達式查詢
<a name="v9-panels-query-xform-expressions"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

伺服器端表達式可讓您使用數學和其他操作來操作查詢傳回的資料。運算式會建立新的資料，而且不會操作資料來源傳回的資料。

## 關於表達式
<a name="v9-panels-query-about"></a>

伺服器端表達式可讓您使用數學和其他操作來操作查詢傳回的資料。表達式會建立新的資料，除了一些次要資料重組之外，也不要操作資料來源傳回的資料，讓表達式的資料可接受輸入。

**使用表達式**

表達式主要由 [Grafana 警示](v9-alerts.md)使用。處理是在伺服器端完成，因此表達式可以在沒有瀏覽器工作階段的情況下操作。不過，表達式也可以與後端資料來源和視覺化搭配使用。

**注意**  
表達式不適用於舊版儀表板提醒。

表達式旨在透過啟用來自不同資料來源的查詢合併，或提供資料來源中無法使用的操作來增強資料來源。

**注意**  
如果可能，您應該在資料來源內進行資料處理。將資料從儲存複製到 Grafana 伺服器進行處理效率低，因此表達式以輕量型資料處理為目標。

運算式適用於傳回時間序列或數字資料的資料來源查詢。它們也會在[多維資料](getting-started-grafanaui.md#time-series-dimensions)上運作。例如，傳回多個序列的查詢，其中每個序列都由標籤或標籤識別。

個別表達式會接受一或多個查詢或其他表達式做為輸入，並將資料新增至結果。每個個別表達式或查詢都由變數表示，該變數是稱為其 RefID 的具名識別符 （例如，預設字母 `A`或 `B`)。

若要參考個別表達式的輸出或另一個表達式中的資料來源查詢，此識別符會用作變數。

**表達式的類型**

運算式適用於兩種類型的資料。
+ 時間序列的集合。
+ 數字集合，其中每個數字都是項目。

每個集合會從單一資料來源查詢或表達式傳回，並以 RefID 表示。每個集合都是一組，其中集合中的每個項目都是由儲存為[標籤](getting-started-grafanaui.md#labels)或鍵值對的維度唯一識別。

**資料來源查詢**

伺服器端表達式僅支援後端資料來源的資料來源查詢。通常假設資料標記為時間序列資料。未來，我們打算新增查詢傳回類型 （數字或時間序列） 資料的聲明，以便表達式可以更好地處理錯誤。

資料來源查詢與表達式搭配使用時，是由表達式引擎執行。這樣做時，它會將資料重組為一個時間序列或每個資料影格一個數字。例如，如果使用在資料表檢視中的一個影格上傳回多個序列的資料來源，您可能會注意到使用表達式執行時看起來不同。

目前，使用資料影格時支援的唯一非時間序列格式 （數字） 是您的資料表回應，會傳回沒有時間的資料影格、字串欄和一個數字欄：


| 本機 | 主機 | Avg\$1CPU | 
| --- | --- | --- | 
|  MIA  |  A  |  1  | 
|  NYC  |  B  |  2  | 

上述範例會產生一個可與表達式搭配使用的數字。字串資料欄會變成標籤，數字資料欄會變成對應的值。例如`{"Loc": "MIA", "Host": "A"}`，值為 1 的 。

**操作**

您可以在表達式中使用下列操作：數學、減少和重新取樣。

**Math**

數學適用於時間序列或數字資料的自由格式數學公式。數學運算需要數字和時間序列做為輸入，並將其變更為不同的數字和時間序列。

來自其他查詢或表達式的資料會參考字首為美元符號的 RefID，例如 `$A`。如果變數的名稱中有空格，則可以使用如 的架構語法`${my variable}`。

數值常數可以是十進位 (`2.24`)、八進位 （前導零，如 `072`) 或十六進位 （前導 0x，如 `0x2A`)。也支援指數和符號 （例如 `-0.8e-2`)。

**運算子**

支援算術 (`+`、二進位和單元 `-`、`*`、`/``%`、、指數 `**`)、關聯式 (`<`、`>`、`==``!=`、`>=`、`<=`) 和邏輯 (`||`、 `&&`和單元 `!`) 運算子。

操作與資料的行為方式取決於它是數字還是時間序列資料。

使用二進位操作，例如 `$A + $B`或 `$A || $B`，會根據資料類型，以下列方式套用運算子：
+ 如果 `$A`和 `$B` 都是數字，則操作會在兩個數字之間執行。
+ 如果一個變數是數字，而另一個變數是時間序列，則會執行時間序列中每個點的值與數字之間的操作。
+ 如果 `$A`和 `$B` 都是時間序列資料，則會針對 `$A`和 中存在的每個時間戳記，執行兩個序列中每個值之間的操作`$B`。`Resample` 操作可用來排列時間戳記。

摘要：
+ 數字 OP 數字 = 數字
+ OP 系列數目 = 系列
+ 系列 OP 系列 = 系列

由於表達式使用由單一變數表示的多個序列或數字，因此二進位操作也會在兩個變數之間執行聯集 （聯結）。這是根據與每個個別序列或數字相關聯的識別標籤來完成的。

因此，如果您的數字具有 `{host=web01}`中的標籤`$A`，而另一個數字`$B`具有相同的標籤，則 操作會在每個變數中的這兩個項目之間執行，結果會共用相同的標籤。此聯集的行為規則如下：
+ 沒有標籤的項目將加入任何項目。
+ 如果 `$A`和 `$B` 都只包含一個項目 （一個序列或一個數字），則它們會聯結。
+ 如果標籤是確切的數學，它們將會聯結。
+ 如果標籤是另一個標籤的子集，例如， 中的項目`$A`會加上標籤，`{host=A,dc=MIA}`而 `$B` 中的項目會加上標籤，`{host=A}`他們會加入。
+ 如果在變數中，例如每個項目`$A`有不同的標籤索引鍵，則聯結行為是未定義的。

關聯式和邏輯運算子傳回 0 表示 false 1 表示 true。

**數學函數**

雖然大多數函數存在於自己的表達式操作中，但數學操作確實有一些類似於數學運算子或符號的函數。當函數可以採用數字或序列時，將會傳回與引數相同的類型。當它是序列時，針對序列中每個點的值執行的 操作。

*abs*

abs 會傳回其引數的絕對值，可以是數字或序列。例如 `abs(-1)` 或 `abs($A)`。

*is\$1inf*

is\$1inf 採用數字或序列，並傳回`Inf`值 `1` （負值或正值） `0` 和其他值。例如 `is_inf($A)`。

**注意**  
如果您需要特別檢查負無限，例如，您可以執行 等比較`$A == infn()`。

*is\$1nan*

is\$1nan 採用數字或序列，並傳回`1``NaN`值 `0` 和其他值 。例如 `is_nan($A)`。此函數存在，因為 `NaN` 不等於 `NaN`。

*is\$1null*

is\$1null 採用數字或序列，並傳回`1``null`值 和其他`0`值 。例如 `is_null($A)`。

*is\$1number*

is\$1number 採用數字或序列，並`1`傳回所有實數值`0`和其他值 （分別為 `null`、`Inf-`、 `Inf+`和 `NaN`)。例如 `is_number($A)`。

*日誌*

Log 會傳回其引數的自然對數，可以是數字或序列。如果值小於 0，`NaN`則會傳回 。例如 `log(-1)` 或 `log($A)`。

*inf、infn、nan 和 null*

inf、infn、nan 和 null 函數都會傳回名稱的單一值。它們主要用於測試。範例：`null()`。

*四捨五入*

Round 傳回四捨五入整數值。例如 `round(3.123)` 或 `round($A)`。

*頭腦*

Ceil 會將數字四捨五入到最接近的整數值。例如，`ceil(3.123)` 傳回 `4`。

*樓層*

下限會將數字四捨五入到最接近的整數值。例如，`floor(3.123`) 會傳回 `3`。

**減少**

減少 需要一個或多個從查詢或表達式傳回的時間序列，並將每個序列轉換為單一數字。時間序列的標籤會保留為每個輸出的減少數字上的標籤。

*欄位：*
+ **函數** – 要使用的縮減函數
+ **輸入** – 要重新取樣的變數 (refID （例如 `A`))
+ **模式** – 當序列包含非數值 (null、NaN、\$1-Inf) 時，允許降低函數的控制行為

**減少函數**

*Count (計數)*

Count 會傳回每個系列中的點數。

*平均值*

平均值會傳回每個序列中所有值的總計，除以該序列中的點數。在 `strict`模式中，如果序列中的任何值為 null 或 nan，或者如果序列為空，則會傳回 NaN。

*最小值和最大值*

最小值和最大值分別傳回序列中的最小或最大值。在 `strict`模式中，如果序列中的任何值為 null 或 nan，或者如果序列為空，則會傳回 NaN。

*Sum (總和)*

總和會傳回序列中所有值的總計。如果序列長度為零，總和將為 0。在 `strict`模式中，如果系列中有任何 NaN 或 Null 值，則會傳回 NaN。

*最後一個*

上次傳回序列中的最後一個數字。如果序列沒有值，則傳回 NaN。

**減少模式**

*嚴格*

在嚴格模式下，輸入序列會照原樣處理。如果序列中的任何值是非數字 (null、NaN 或 \$1-Inf)，則會傳回 NaN。

*捨棄非數值*

在此模式中，輸入序列中的所有非數值 (null、NaN 或 \$1-Inf) 都會在執行縮減函數之前篩選掉。

*取代非數值*

在此模式中，所有非數值都會以預先定義的值取代。

**重新取樣**

重新取樣會將每個時間序列中的時間戳記變更為具有一致的時間間隔。主要使用案例是 ，因此您可以重新取樣不共用相同時間戳記的時間序列，以便在它們之間執行數學。這可以透過重新取樣兩個序列中的每個序列，然後在參考重新取樣變數的數學操作中完成。

*欄位：*
+ **輸入** – 要重新取樣的時間序列資料變數 (refID （例如 `A`))
+ **重新取樣**至 – 重新取樣的持續時間，例如`10s.`，單位可以是`s`秒、`m`分鐘、`h`小時、`d`天、`w`週和`y`年。
+ **Downsample** – 當每個視窗範例有多個資料點時要使用的減少函數。如需行為詳細資訊，請參閱減少操作。
+ **Upsample** – 用來填充沒有資料點之視窗範例的方法。
  + **鍵盤**會填入最後一個已知值
  + 回**填**下一個已知值
  + **fillna** 以 NaNs填滿空的範例時段

## 撰寫表達式
<a name="v9-panels-query-write"></a>

如果您的資料來源支援，則 Grafana 會顯示**表達式**按鈕，並在查詢編輯器清單中顯示任何現有的表達式。

**撰寫表達式**

1. 開啟面板。

1. 在查詢下方，選擇**表達式**。

1. 在**操作**欄位中，選取您要寫入的表達式類型。

1. 撰寫表達式。

1. 選擇**套用**。

## 特殊案例
<a name="v9-panels-query-special"></a>

當任何查詢的資料來源未傳回任何序列或數字時，表達式引擎會傳回 `NoData`。例如，如果請求包含兩個由 表達式合併的資料來源查詢，如果由至少一個資料來源查詢`NoData`傳回，則整個查詢傳回的結果為 `NoData`。如需 Grafana 警示如何處理`NoData`結果的詳細資訊，請參閱 [不處理任何資料或錯誤案例](v9-alerting-managerules-grafana.md#v9-alerting-rule-no-data-error)。

# 與其他面板共用查詢結果
<a name="v9-panels-query-share"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

Grafana 可讓您針對儀表板中的任何其他面板，使用某個面板的查詢結果。跨面板共用查詢結果可減少對資料來源提出的查詢數量，這可以改善儀表板的效能。

儀表板資料來源可讓您選取儀表板中的面板，其中包含您要共用結果的查詢。Grafana 不會為每個面板傳送個別的查詢，而是傳送一個查詢，而其他面板會使用查詢結果來建構視覺化效果。

例如，當您有數個面板視覺化相同的資料時，此策略可以大幅減少要進行的查詢數量。

**共用查詢結果**

1. [建立儀表板](v9-dash-creating.md)。

1. 將標題變更為 `Source panel`。您將使用此面板作為其他面板的來源。

1. 定義您要共用的查詢。

   如果您沒有可用的資料來源，請使用 **TestData** 資料來源，這會傳回您可以用於測試的隨機時間序列。

1. 新增第二個面板，然後在查詢編輯器中選取**儀表板**資料來源。

1. 在**從面板使用結果清單中**，選取您建立的第一個面板。

來源面板中定義的所有查詢現在可供新面板使用。在來源面板中進行的查詢可以與多個面板共用。

您可以按一下任何查詢，前往定義查詢的面板。

# 轉換資料
<a name="v9-panels-xform"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

在系統套用視覺化效果之前，轉換是操作查詢所傳回資料的強大方式。使用轉換，您可以：
+ 重新命名欄位
+ 聯結時間序列資料
+ 跨查詢執行數學操作
+ 使用一個轉換的輸出做為另一個轉換的輸入

對於依賴相同資料集的多個檢視的使用者，轉換提供了建立和維護許多儀表板的有效方法。

您也可以使用一個轉換的輸出做為另一個轉換的輸入，這會導致效能提升。

**注意**  
有時系統無法繪製轉換的資料圖形。發生這種情況時，請按一下視覺化上方的**資料表檢視**切換，以切換至資料的資料表檢視。這可協助您了解轉換的最終結果。

## 轉換類型
<a name="v9-panels-xform-types"></a>

Grafana 提供多種轉換資料的方式。以下是轉換函數的完整清單。

## 轉換順序
<a name="v9-panels-xform-order"></a>

有多個轉換時，Grafana 會依列出的順序套用轉換。每個轉換都會建立結果集，然後傳遞至處理管道中的下一個轉換。

Grafana 套用轉換的順序會直接影響結果。例如，如果您使用減少轉換將一欄的所有結果精簡為單一值，則您只能將轉換套用至該單一值。

## 將轉換函數新增至資料
<a name="v9-panels-xform-add"></a>

下列步驟會引導您將轉換新增至資料。

**將轉換新增至面板**

1. 導覽至您要新增一或多個轉換的面板。

1. 選擇面板標題，然後按一下**編輯**。

1. 選擇**轉換**索引標籤。

1. 選擇轉換。隨即出現轉換列，供您設定轉換選項。

1. 若要套用另一個轉換，請選擇**新增轉換**。此轉換作用於先前轉換傳回的結果集。

## 偵錯轉換
<a name="v9-panels-xform-debug"></a>

若要查看轉換的輸入和輸出結果集，請選擇轉換列右側的錯誤圖示。

輸入和輸出結果集可協助您偵錯轉換。

## 刪除轉換
<a name="v9-panels-xform-delete"></a>

我們建議您移除不需要的轉換。當您刪除轉換時，會從視覺化中移除資料。

事前準備：

識別依賴轉換的所有儀表板，並通知受影響的儀表板使用者。

**刪除轉換**

1. 開啟面板進行編輯。

1. 選擇**轉換**索引標籤。

1. 選擇您要刪除之轉換旁的垃圾桶圖示。

## 轉換函數
<a name="v9-panels-xform-functions"></a>

您可以對資料執行下列轉換。

**從計算新增欄位**

使用此轉換來新增從其他兩個欄位計算的新欄位。每個轉換都可讓您新增一個新欄位。
+ **模式** - 選取模式：
  + **減少資料列 – **個別將選取的計算套用至所選欄位的每一列。
  + **二進位選項** – 將基本數學操作 （總和、乘以等） 套用至來自兩個所選欄位的單一資料列中的值。
+ **欄位名稱** – 選取您要在新欄位的計算中使用的欄位名稱。
+ **計算**：如果您選取**減少資料列**模式，則**計算**欄位會顯示。按一下 欄位以查看可用來建立新欄位的計算選項清單。如需可用計算的資訊，請參閱[計算類型](v9-panels-calculation-types.md)。
+ **操作** – 如果您選取**二進位選項**模式，則會顯示**操作**欄位。這些欄位可讓您對來自兩個所選欄位的單一資料列中的值執行基本數學操作。您也可以使用二進位操作的數值。
+ **別名** – （選用） 輸入新欄位的名稱。如果您將此保留空白，則會命名 欄位以符合計算。
+ **取代所有欄位** – （選用） 如果您想要隱藏所有其他欄位，並僅在視覺化中顯示計算欄位，請選取此選項。

**串連欄位**

此轉換會將所有影格的所有欄位合併為一個結果。請考慮這兩個查詢。

查詢 A：


| 暫存 | 執行時間 | 
| --- | --- | 
|  15.4  |  1230233  | 

查詢 B：


| AQI | 錯誤 | 
| --- | --- | 
|  3.2  |  5  | 

串連欄位之後，資料框架會是：


| 暫存 | 執行時間 | AQI | 錯誤 | 
| --- | --- | --- | --- | 
|  15.4  |  1230233  |  3.2  |  5  | 

**查詢結果中的組態**

此轉換可讓您選取一個查詢，並從中擷取標準選項，例如 **Min**、**Max**、**Unit** 和 **Thresholds**，並將其套用至其他查詢結果。這會啟用動態查詢驅動的視覺化組態。

如果您想要擷取組態查詢結果中每一列的唯一組態，請嘗試資料列到欄位轉換。

**選項**
+ **組態查詢** – 選取傳回您要用作組態之資料的查詢。
+ **套用到** – 選取要套用組態的欄位或序列。
+ **套用至選項** – 通常是欄位類型或欄位名稱 regex，取決於您在**套用至**中選取的選項。

**轉換欄位類型**

此轉換會變更指定欄位的欄位類型。
+ **欄位** – 從可用欄位中選取
+ **as** – 選取要轉換為的 FieldType 
  + **數值** – 嘗試將值設為數字
  + **字串** – 將使值字串
  + **時間** – 嘗試將值剖析為時間
    + 會顯示一個選項，以指定 DateFormat 做為 yyyy-mm-dd 或 DD MM YYYY hh：mm：ss 等字串的輸入
  + **布林值** – 將使值成為布林值

例如，以下查詢可以透過選取時間欄位、時間格式和日期格式為 YYYY 來修改。


| 時間 | 標記 | Value | 
| --- | --- | --- | 
|  7/1/2017  |  上方  |  25  | 
|  8/2/2018  |  下方  |  22  | 
|  9/2/2019  |  下方  |  29  | 
|  10/4/2020  |  上方  |  22  | 

結果：


| 時間 | 標記 | Value | 
| --- | --- | --- | 
|  1/1/2017  |  上方  |  25  | 
|  1/1/2018  |  下方  |  22  | 
|  1/1/2019  |  下方  |  29  | 
|  1/1/2020  |  上方  |  22  | 

**依名稱篩選資料**

使用此轉換移除部分查詢結果。

Grafana 會顯示**識別符**欄位，後面接著查詢傳回的欄位。

您可以透過下列兩種方式之一套用篩選條件：
+ 輸入 regex 表達式。
+ 選擇欄位以切換該欄位的篩選。篩選的欄位會以深灰色文字顯示，未篩選的欄位則以白色文字顯示。

**依查詢篩選資料**

如果您想要隱藏一或多個查詢，請在具有多個查詢的面板中使用此轉換。

Grafana 會以深灰色文字顯示查詢識別字母。按一下查詢識別符以切換篩選。如果查詢字母為白色，則會顯示結果。如果查詢字母為深色，則會隱藏結果。

**注意**  
此轉換不適用於 Graphite，因為此資料來源不支援將傳回的資料與查詢關聯。

**依值篩選資料**

此轉換可讓您直接在 Grafana 中篩選資料，並從查詢結果中移除一些資料點。您可以選擇包含或排除符合您定義的一或多個條件的資料。這些條件會套用至選取的欄位。

如果您的資料來源不原生依值篩選，則此轉換很有用。如果您使用共用查詢，也可以使用此值來縮小顯示範圍。

所有欄位的可用條件如下：
+ **Regex** – 比對 regex 表達式
+ **為 Null** – 如果值為 Null 則相符
+ **Is Not Null** – 如果值不是 Null，則相符
+ **等於** – 如果值等於指定的值，則相符
+ **不同** – 如果值與指定的值不同，則相符

數字欄位的可用條件為：
+ **較大** – 如果值大於指定的值，則相符
+ **較低** – 如果值低於指定值，則相符
+ **大於或等於** – 如果值大於或等於，則相符
+ **小於或等於** – 如果值小於或等於，則相符
+ **範圍** – 符合指定最小值與最大值、最小值與最大值之間的範圍

請考慮下列資料集：


| 時間 | 溫度 | 高度 | 
| --- | --- | --- | 
|  7/7/2020 上午 11：34：23  |  32  |  101  | 
|  7/7/2020 上午 11：34：22  |  28  |  125  | 
|  7/7/2020 上午 11：34：21  |  26  |  110  | 
|  7/7/2020 上午 11：34：20  |  23  |  98  | 
|  7/7/2020 上午 10：32：24  |  31  |  95  | 
|  7/7/2020 上午 10：31：22  |  20  |  85  | 
|  7/7/2020 上午 9：30：57  |  19  |  101  | 

如果您**包含**溫度低於 30°C 的資料點，則組態會如下所示：
+ **篩選條件類型** – `Include`
+ **條件** – `Temperature`符合的列 `Lower Than 30`

此外，您會收到以下結果，其中只會包含低於 30°C 的溫度：


| 時間 | 溫度 | 高度 | 
| --- | --- | --- | 
|  7/7/2020 上午 11：34：22  |  28  |  125  | 
|  7/7/2020 上午 11：34：21  |  26  |  110  | 
|  7/7/2020 上午 11：34：20  |  23  |  98  | 
|  7/7/2020 上午 10：31：22  |  20  |  85  | 
|  7/7/2020 上午 9：30：57  |  19  |  101  | 

您可以將多個條件新增至篩選條件。例如，您可能只想在海拔高度大於 100 時包含資料。若要這麼做，請將該條件新增至下列組態：
+ 篩選條件類型 – `Match All`條件的資料`Include`列
+ 條件 1 – `Temperature``Lower`符合 的資料列 `30`
+ 條件 2 – `Altitude``Greater`符合 的資料列 `100`

當您有多個條件時，您可以選擇是否要將動作 （包括/排除） 套用至**符合所有**條件或**符合**任何您新增條件的資料列。

在上述範例中，我們選擇**全部相符**，因為我們想要包含溫度低於 30 且高度高於 100 的資料列。如果我們希望包含溫度低於 30 或高度高於 100 的資料列，則我們會選取**符合任何**資料列。這將包含原始資料中的第一列，其溫度為 32°C （不符合第一個條件），但高度為 101 （符合第二個條件），因此包含在內。

系統會忽略無效或設定不完整的條件。

**分組依據**

此轉換會依指定的欄位 （資料欄） 值將資料分組，並處理每個群組的計算。按一下以查看計算選項的清單。

以下是原始資料的範例。


| 時間 | 伺服器 ID | CPU 溫度 | 伺服器狀態 | 
| --- | --- | --- | --- | 
|  7/7/2020 上午 11：34：20  |  伺服器 1  |  80  |  Shutdown  | 
|  7/7/2020 上午 11：34：20  |  伺服器 3  |  62  |  OK  | 
|  7/7/2020 上午 10：32：20  |  伺服器 2  |  90  |  過載  | 
|  7/7/2020 上午 10：31：22  |  伺服器 3  |  55  |  OK  | 
|  7/7/2020 上午 9：30：57  |  伺服器 3  |  62  |  Rebooting (重新開機中)  | 
|  7/7/2020 上午 9：30：05  |  伺服器 2  |  88  |  OK  | 
|  7/7/2020 上午 9：28：06  |  伺服器 1  |  80  |  OK  | 
|  7/7/2020 上午 9：25：05  |  伺服器 2  |  88  |  OK  | 
|  7/7/2020 上午 9：23：07  |  伺服器 1  |  86  |  OK  | 

此轉換分為兩個步驟。首先，指定一或多個欄位來分組資料。這會將這些欄位的所有相同值分組在一起，就像您排序它們一樣。例如，如果我們依伺服器 ID 欄位分組，則會以下列方式將資料分組：


| 時間 | 伺服器 ID | CPU 溫度 | 伺服器狀態 | 
| --- | --- | --- | --- | 
|  7/7/2020 上午 11：34：20  |  伺服器 1  |  80  |  Shutdown  | 
|  7/7/2020 上午 9：28：06  |  伺服器 1  |  80  |  OK  | 
|  7/7/2020 上午 9：23：07  |  伺服器 1  |  86  |  OK  | 
|  7/7/2020 上午 10：32：20  |  伺服器 2  |  90  |  過載  | 
|  7/7/2020 上午 9：30：05  |  伺服器 2  |  88  |  OK  | 
|  7/7/2020 上午 9：25：05  |  伺服器 2  |  88  |  OK  | 
|  7/7/2020 上午 11：34：20  |  伺服器 3  |  62  |  OK  | 
|  7/7/2020 上午 10：31：22  |  伺服器 3  |  55  |  OK  | 
|  7/7/2020 上午 9：30：57  |  伺服器 3  |  62  |  Rebooting (重新開機中)  | 

具有相同伺服器 ID 值的所有資料列都會分組在一起。

在選擇要將資料分組的欄位之後，您可以在其他欄位上新增各種計算，並將計算套用至每個資料列群組。例如，我們可以計算每個伺服器的平均 CPU 溫度。因此，我們可以新增套用至 CPU 溫度欄位*的平均*計算，以取得下列項目：


| 伺服器 ID | CPU 溫度 （平均值） | 
| --- | --- | 
|  伺服器 1  |  82  | 
|  伺服器 2  |  88.6  | 
|  伺服器 3  |  59.6  | 

而且我們可以新增多個計算。例如：
+ 對於欄位時間，我們可以計算*最後一個*值，以了解何時收到每個伺服器的最後一個資料點
+ 對於欄位伺服器狀態，我們可以計算*最後一個*值，以了解每個伺服器的最後一個狀態值
+ 對於欄位溫度，我們也可以計算*最後一個*值，以了解每個伺服器的最新監控溫度

然後，我們會取得：


| 伺服器 ID | CPU 溫度 （平均值） | CPU 溫度 （最後一個） | 時間 （上次） | 伺服器狀態 （最後一個） | 
| --- | --- | --- | --- | --- | 
|  伺服器 1  |  82  |  80  |  7/7/2020 上午 11：34：20  |  Shutdown  | 
|  伺服器 2  |  88.6  |  90  |  7/7/2020 上午 10：32：20  |  過載  | 
|  伺服器 3  |  59.6  |  62  |  7/7/2020 上午 11：34：20  |  OK  | 

此轉換可讓您從時間序列中擷取金鑰資訊，並以方便的方式顯示。

**依欄位聯結**

使用此轉換將多個結果加入單一資料表。這對於將多個時間序列結果轉換為具有共用時間欄位的單一寬資料表特別有用。

*內部聯結*

內部聯結會合併來自多個資料表的資料，其中所有資料表都會從所選欄位共用相同的值。這種類型的聯結會排除值不符合每個結果的資料。

使用此轉換將多個查詢 （在傳遞的聯結欄位或第一個資料欄上結合） 的結果合併為一個結果，並捨棄無法成功聯結的資料列。

在下列範例中，兩個查詢會傳回資料表資料。在套用內部聯結轉換之前，它會視覺化為兩個不同的資料表。

查詢 A：


| 時間 | 任務 | 執行時間 | 
| --- | --- | --- | 
|  7/7/2020 上午 11：34：20  |  節點  |  25260122  | 
|  7/7/2020 上午 11：24：20  |  postgre  |  123001233  | 
|  7/7/2020 上午 11：14：20  |  postgre  |  345001233  | 

查詢 B：


| 時間 | Server | 錯誤 | 
| --- | --- | --- | 
|  7/7/2020 上午 11：34：20  |  伺服器 1  |  15  | 
|  7/7/2020 上午 11：24：20  |  伺服器 2  |  5  | 
|  7/7/2020 上午 11：04：20  |  伺服器 3  |  10  | 

套用內部聯結轉換後的結果如下所示：


| 時間 | 任務 | 執行時間 | Server | 錯誤 | 
| --- | --- | --- | --- | --- | 
|  7/7/2020 上午 11：34：20  |  節點  |  25260122  |  伺服器 1  |  15  | 
|  7/7/2020 上午 11：24：20  |  postgre  |  123001233  |  伺服器 2  |  5  | 

*外部聯結*

外部聯結包含來自內部聯結的所有資料，以及值在每個輸入中不相符的資料列。當內部聯結在時間欄位上聯結查詢 A 和查詢 B 時，外部聯結會包含時間欄位上不相符的所有列。

在下列範例中，兩個查詢會傳回資料表資料。在套用外部聯結轉換之前，它會視覺化為兩個資料表。

查詢 A：


| 時間 | 任務 | 執行時間 | 
| --- | --- | --- | 
|  7/7/2020 上午 11：34：20  |  節點  |  25260122  | 
|  7/7/2020 上午 11：24：20  |  postgre  |  123001233  | 
|  7/7/2020 上午 11：14：20  |  postgre  |  345001233  | 

查詢 B：


| 時間 | Server | 錯誤 | 
| --- | --- | --- | 
|  7/7/2020 上午 11：34：20  |  伺服器 1  |  15  | 
|  7/7/2020 上午 11：24：20  |  伺服器 2  |  5  | 
|  7/7/2020 上午 11：04：20  |  伺服器 3  |  10  | 

套用外部聯結轉換後的結果如下所示：


| 時間 | 任務 | 執行時間 | Server | 錯誤 | 
| --- | --- | --- | --- | --- | 
|  7/7/2020 上午 11：04：20  |    |    |  伺服器 3  |  10  | 
|  7/7/2020 上午 11：14：20  |  postgre  |  345001233  |    |    | 
|  7/7/2020 上午 11：34：20  |  節點  |  25260122  |  伺服器 1  |  15  | 
|  7/7/2020 上午 11：24：20  |  postgre  |  123001233  |  伺服器 2  |  5  | 

**欄位的標籤**

此轉換會將包含標籤或標籤的時間序列結果變更為資料表，其中每個標籤索引鍵和值都會包含在資料表結果中。標籤可以顯示為資料欄或資料列值。

假設查詢結果有兩個時間序列：
+ 系列 1 – 標籤 Server=Server A， Datacenter=EU
+ 系列 2 – 標籤 Server=Server B， Datacenter=EU

在**資料欄**模式中，結果如下所示：


| 時間 | Server | Datacenter | Value | 
| --- | --- | --- | --- | 
|  7/7/2020 上午 11：34：20  |  伺服器 A  |  歐盟  |  1  | 
|  7/7/2020 上午 11：34：20  |  伺服器 B  |  歐盟  |  2  | 

在「資料列」模式中，結果具有每個序列的資料表，並顯示如下所示的每個標籤值：


| label | value | 
| --- | --- | 
|  Server  |  伺服器 A  | 
|  Datacenter  |  歐盟  | 


| label | value | 
| --- | --- | 
|  Server  |  伺服器 B  | 
|  Datacenter  |  歐盟  | 

*值欄位名稱*

如果您選取伺服器做為**值欄位名稱**，則伺服器標籤的每個值都會有一個欄位。


| 時間 | Datacenter | 伺服器 A | 伺服器 B | 
| --- | --- | --- | --- | 
|  7/7/2020 上午 11：34：20  |  歐盟  |  1  |  2  | 

*合併行為*

欄位轉換器的標籤在內部是兩個單獨的轉換。第一個作用於單一序列，並將標籤擷取至欄位。第二個是合併轉換，將所有結果聯結至單一資料表。合併轉換會嘗試在所有相符欄位上加入。此合併步驟為必要步驟，無法關閉。

**注意**  
*合併*轉換可以單獨使用，如下所述。

為了說明這一點，以下範例有兩個查詢會傳回沒有重疊標籤的時間序列。
+ 系列 1 – 標籤 Server=ServerA
+ 系列 2 – 標籤 Datacenter=EU

這首先會產生這兩個資料表：


| 時間 | Server | Value | 
| --- | --- | --- | 
|  7/7/2020 上午 11：34：20  |  ServerA  |  10  | 


| 時間 | Datacenter | Value | 
| --- | --- | --- | 
|  7/7/2020 上午 11：34：20  |  歐盟  |  20  | 

合併後：


| 時間 | Server | Value | Datacenter | 
| --- | --- | --- | --- | 
|  7/7/2020 上午 11：34：20  |  ServerA  |  10  |    | 
|  7/7/2020 上午 11：34：20  |    |  20  |  歐盟  | 

**合併**

使用此轉換將多個查詢的結果合併為單一結果。這在使用資料表面板視覺化時很有用。可合併的值會合併為相同的資料列。如果共用欄位包含相同的資料，則值可合併。

在下面的範例中，有兩個查詢會傳回資料表資料。在套用轉換之前，它會視覺化為兩個不同的資料表。

查詢 A：


| 時間 | 任務 | 執行時間 | 
| --- | --- | --- | 
|  7/7/2020 上午 11：34：20  |  節點  |  25260122  | 
|  7/7/2020 上午 11：24：20  |  postgre  |  123001233  | 

查詢 B：


| 時間 | 任務 | 錯誤 | 
| --- | --- | --- | 
|  7/7/2020 上午 11：34：20  |  節點  |  15  | 
|  7/7/2020 上午 11：24：20  |  postgre  |  5  | 

以下是套用合併轉換後的結果：


| 時間 | 任務 | 錯誤 | 執行時間 | 
| --- | --- | --- | --- | 
|  7/7/2020 上午 11：34：20  |  節點  |  15  |  25260122  | 
|  7/7/2020 上午 11：24：20  |  postgre  |  5  |  123001233  | 

**組織欄位**

使用此轉換來重新命名、重新排序或隱藏查詢傳回的欄位。

**注意**  
此轉換僅適用於具有單一查詢的面板。如果您的面板有多個查詢，則必須套用外部聯結轉換或移除額外的查詢。

Grafana 會顯示查詢傳回的欄位清單。您可以：
+ 將游標暫留在欄位上，以變更欄位順序。游標會變成手，然後您可以將欄位拖曳到新的位置。
+ 按一下欄位名稱旁的眼睛圖示來隱藏或顯示欄位。
+ 在重新命名方塊中輸入新名稱來重新命名欄位。

**依值分割**

當繪製多個序列時，此轉換有助於消除對具有不同`WHERE`子句的相同資料來源進行多個查詢的需求。考慮具有下列資料的指標 SQL 資料表：


| 時間 | 區域 | Value | 
| --- | --- | --- | 
|  10/20/2022 下午 12：00：00  |  美國  |  1520  | 
|  10/20/2022 下午 12：00：00  |  歐盟  |  2936  | 
|  10/20/2022 上午 1：00：00  |  美國  |  1327  | 
|  10/20/2022 上午 1：00：00  |  歐盟  |  912  | 

在 v9.3 之前，如果您想要在相同的 TimeSeries 面板中繪製美國的紅色趨勢線和歐洲的藍色趨勢線，您可能必須將其分割為兩個查詢：

```
SELECT Time, Value FROM metrics WHERE Time > '2022-10-20' AND Region='US'
SELECT Time, Value FROM metrics WHERE Time > '2022-10-20' AND Region='EU'
```

這還需要您事先知道指標資料表中實際存在的區域。

使用*依值分割*轉換器，您現在可以發出單一查詢，並將結果分割為您選擇的一或多個資料欄 (`fields`) 中的唯一值。以下範例使用 `Region`。

```
SELECT Time, Region, Value FROM metrics WHERE Time > '2022-10-20'
```


| 時間 | 區域 | Value | 
| --- | --- | --- | 
|  10/20/2022 下午 12：00：00  |  美國  |  1520  | 
|  10/20/2022 上午 1：00：00  |  美國  |  1327  | 


| 時間 | 區域 | Value | 
| --- | --- | --- | 
|  10/20/2022 下午 12：00：00  |  歐盟  |  2936  | 
|  10/20/2022 上午 1：00：00  |  歐盟  |  912  | 

**減少**

*減少*轉換會將計算套用至影格中的每個欄位，並傳回單一值。套用此轉換時會移除時間欄位。

考慮輸入：

查詢 A：


| 時間 | 暫存 | 執行時間 | 
| --- | --- | --- | 
|  7/7/2020 上午 11：34：20  |  12.3  |  256122  | 
|  7/7/2020 上午 11：24：20  |  15.4  |  1230233  | 

查詢 B：


| 時間 | AQI | 錯誤 | 
| --- | --- | --- | 
|  7/7/2020 上午 11：34：20  |  6.5  |  15  | 
|  7/7/2020 上午 11：24：20  |  3.2  |  5  | 

還原轉換器有兩種模式：
+ **序列到資料列** - 為每個欄位建立資料列，為每個計算建立資料欄。
+ **減少欄位** - 保留現有的影格結構，但會將每個欄位摺疊成單一值。

例如，如果您使用**第一個**和**最後一個**計算搭配**序列進行資料列**轉換，則結果為：


| 欄位 | First | Last | 
| --- | --- | --- | 
|  暫存  |  12.3  |  15.4  | 
|  執行時間  |  256122  |  1230233  | 
|  AQI  |  6.5  |  3.2  | 
|  錯誤  |  15  |  5  | 

使用上次計算減少欄位會產生兩個影格，每個影格各一個資料列：

查詢 A：


| 暫存 | 執行時間 | 
| --- | --- | 
|  15.4  |  1230233  | 

查詢 B：


| AQI | 錯誤 | 
| --- | --- | 
|  3.2  |  5  | 

**依 regex 重新命名**

使用此轉換來使用規則表達式和取代模式重新命名部分查詢結果。

您可以指定僅套用至相符項目的規則表達式，以及支援回溯參考的替代模式。例如，假設您正在視覺化每個主機的 CPU 用量，並想要移除網域名稱。您可以將 regex 設定為 ，`([^\.]+)\..+`而取代模式設定為 `$1`， `web-01.example.com` 會變成 `web-01`。

**欄位的資料列**

資料列轉換為欄位轉換會將資料列轉換為不同的欄位。這非常有用，因為欄位可以個別進行樣式和設定。它也可以使用其他欄位做為動態欄位組態的來源，或將其對應至欄位標籤。然後，可以使用其他標籤為產生的欄位定義更好的顯示名稱。

此轉換包含欄位資料表，其中列出組態查詢傳回的資料中的所有欄位。此表格可讓您控制哪些欄位應映射至每個組態屬性 (\$1Use as\$1\$1 選項）。如果傳回的資料中有多個資料列，您也可以選擇要選取的值。

此轉換需要：
+ 一個欄位，用來做為欄位名稱的來源。

  根據預設，轉換會使用第一個字串欄位做為來源。您可以覆寫此預設設定，方法是為您要使用**的欄位選取使用做為資料欄的欄位名稱**。 ****
+ 一個要用作值來源的欄位。

  根據預設，轉換會使用第一個數字欄位做為來源。但是，您可以在要改用**的欄位的「使用為」欄中選取欄位值**，以覆寫此預設設定。 ****

在 中視覺化資料時很有用：
+ 量測計
+ Stat
+ 圓餅圖

*將額外的欄位映射至標籤*

如果欄位未映射到組態屬性，Grafana 會自動將其用作輸出欄位上標籤的來源 -

範例：


| 名稱 | DataCenter | Value | 
| --- | --- | --- | 
|  ServerA  |  美國  |  100  | 
|  ServerB  |  歐盟  |  200  | 

輸出：


| ServerA （標籤：DataCenter：美國） | ServerB （標籤：DataCenter：EU) | 
| --- | --- | 
|  10  |  20  | 

額外的標籤現在可用於欄位顯示名稱，提供更完整的欄位名稱。

如果您想要從一個查詢擷取組態並將其套用至另一個查詢，則應使用查詢結果轉換中的組態。

*範例*

輸入:


| 名稱 | 值 | 最多 | 
| --- | --- | --- | 
|  ServerA  |  10  |  100  | 
|  ServerB  |  20  |  200  | 
|  ServerC  |  30  |  300  | 

輸出：


| ServerA （組態：max=100) | ServerB （組態：max=200) | ServerC （組態：max=300) | 
| --- | --- | --- | 
|  10  |  20  |  30  | 

您可以看到來源資料中的每一列都會變成個別欄位。每個欄位現在也具有最大組態選項集。Min、Max、Unit 和 Thresholds 等選項都是欄位組態的一部分，如果像這樣設定，則會由視覺化使用，而不是在面板編輯器選項窗格中手動設定的任何選項。

**準備時間序列**

當資料來源以您想要使用的面板不支援的格式傳回時間序列資料時，準備時間序列轉換很有用。

此轉換透過將時間序列資料從寬格式轉換為長格式或其他方式，協助您解決此問題。

選取**多影格時間序列**選項，將時間序列資料影格從寬格式轉換為長格式。

選取**廣角時間序列**選項，將時間序列資料影格從長格式轉換為廣角格式。

**序列到資料列**

使用此轉換將多個時間序列資料查詢的結果合併為單一結果。這在使用資料表面板視覺化時很有用。

此轉換的結果將包含三個資料欄：時間、指標和值。系統會新增指標欄，讓您可以輕鬆查看指標源自哪個查詢。透過在來源查詢上定義標籤來自訂此值。

在下面的範例中，有兩個查詢會傳回時間序列資料。在套用轉換之前，它會視覺化為兩個不同的資料表。

查詢 A：


| 時間 | 溫度 | 
| --- | --- | 
|  7/7/2020 上午 11：34：20  |  25  | 
|  7/7/2020 上午 10：31：22  |  22  | 
|  7/7/2020 上午 9：30：05  |  19  | 

查詢 B：


| 時間 | 濕度 | 
| --- | --- | 
|  7/7/2020 上午 11：34：20  |  24  | 
|  7/7/2020 上午 10：32：20  |  29  | 
|  7/7/2020 上午 9：30：57  |  33  | 

以下是將 系列套用至資料列轉換後的結果。


| 時間 | 指標 | Value | 
| --- | --- | --- | 
|  7/7/2020 上午 11：34：20  |  溫度  |  25  | 
|  7/7/2020 上午 11：34：20  |  濕度  |  22  | 
|  7/7/2020 上午 10：32：20  |  濕度  |  29  | 
|  7/7/2020 上午 10：31：22  |  溫度  |  22  | 
|  7/7/2020 上午 9：30：57  |  濕度  |  33  | 
|  7/7/2020 上午 9：30：05  |  溫度  |  19  | 

**依 排序**

此轉換會依設定的欄位排序每個影格，當核取`reverse`時，值會以相反的順序傳回。

**限制**

使用此轉換來限制顯示的列數。

在下面的範例中，我們從資料來源收到以下回應：


| 時間 | 指標 | Value | 
| --- | --- | --- | 
|  7/7/2020 上午 11：34：20  |  溫度  |  25  | 
|  7/7/2020 上午 11：34：20  |  濕度  |  22  | 
|  7/7/2020 上午 10：32：20  |  濕度  |  29  | 
|  7/7/2020 上午 10：31：22  |  溫度  |  22  | 
|  7/7/2020 上午 9：30：57  |  濕度  |  33  | 
|  7/7/2020 上午 9：30：05  |  溫度  |  19  | 

以下是新增值為「3」的限制轉換之後的結果：


| 時間 | 指標 | Value | 
| --- | --- | --- | 
|  7/7/2020 上午 11：34：20  |  溫度  |  25  | 
|  7/7/2020 上午 11：34：20  |  濕度  |  22  | 
|  7/7/2020 上午 10：32：20  |  濕度  |  29  | 

# 對查詢進行故障診斷
<a name="v9-panels-query-troubleshoot"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

此頁面提供解決常見儀表板問題的資訊。

**當我重新排列函數時，會取得不同的結果**

函數順序非常重要。如同數學，您放置函數的順序可能會影響結果。

**檢查您的查詢請求和回應**

最常見的問題與資料來源的查詢和回應有關。即使看起來像是 Grafana 中的錯誤或視覺化問題，幾乎總是資料來源查詢或資料來源回應的問題。首先檢查您的面板查詢和回應。

如需詳細資訊，請參閱[檢查請求和回應資料](v9-panels-panel-inspector.md)。

**我的查詢很慢**

您的查詢傳回多少資料點？ 傳回大量資料點的查詢將會很慢。請嘗試：
+ 在**查詢選項**中，限制傳回**的最大資料點**。
+ 在**查詢選項**中，增加**最小間隔**時間。
+ 在您的查詢中，使用 `group by`函數。

# 設定閾值
<a name="v9-panels-configure-thresholds"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

 本節包含有關在視覺效果中使用閾值的資訊。您將了解閾值及其預設值、如何新增或刪除閾值，以及將閾值新增至舊版面板。

## 關於閾值
<a name="v9-panels-thresholds-about"></a>

 閾值是您為指標指定的值，該指標會在達到或超過閾值時以視覺化方式反映在儀表板中。

 閾值提供一種方法，讓您根據查詢結果，有條件地為視覺化設計樣式和顏色。您可以將閾值套用至大多數，但並非所有的視覺化效果。如需視覺化的詳細資訊，請參閱[視覺化面板](v9-panels.md)。

 您可以使用閾值來：
+  顏色網格線或網格是[時間序列視覺化](v9-panels-time-series.md)中的區域 
+  [時間序列視覺化](v9-panels-time-series.md)中的顏色行 
+  在 [Stat 視覺化](v9-panels-stat.md)中為背景或值文字上色 
+  在量計[視覺化中為量計](v9-panels-gauge.md)和閾值標記上色 
+  [Geomap 視覺化](v9-panels-geomap.md)中的顏色標記 
+  [資料表視覺化](v9-panels-table.md)中的色彩儲存格文字或背景 
+  在[狀態時間軸視覺化](v9-panels-state-timeline.md)中定義區域和區域顏色 

 閾值有兩種類型：
+  **絕對**閾值由數字定義。例如，在 1 到 150 的範圍內為 80。
+  **百分比**閾值是相對於最小值或最大值定義。例如，80%。

### 預設閾值
<a name="v9-panels-thresholds-default"></a>

 在支援它的視覺化效果上，Grafana 會設定下列的預設閾值：
+  80 = 紅色 
+  Base = 綠色 
+  模式 = 絕對值 

 **基準**值代表減去無限大。它通常是「好的」顏色。

## 新增或刪除閾值
<a name="v9-panels-thresholds-add-delete"></a>

 您可以將任意數量的閾值新增至面板。Grafana 會自動從最高到最低排序閾值。

 當閾值不再與您的業務營運相關時，請刪除閾值。當您刪除閾值時，系統會從包含閾值的所有視覺效果中移除閾值。

1.  若要新增閾值：

   1.  編輯您要新增閾值的面板。

   1.  在選項側邊窗格中，找到**閾值**區段，然後按一下 **\$1 新增閾值**。

   1.  選取閾值顏色、數字和模式。閾值模式適用於此面板上的所有閾值。

   1.  對於時間序列面板，選取**顯示閾值**選項。

1.  若要刪除閾值，請導覽至包含閾值的面板，然後按一下您要移除的閾值旁邊的垃圾桶圖示。

## 將閾值新增至舊版圖形面板
<a name="v9-panels-thresholds-legacy-graph"></a>

 在圖形面板視覺化中，閾值可讓您將線條或區段新增至圖形，以便在圖形超過閾值時更容易辨識。

1.  導覽至您要新增閾值的圖形面板。

1.  在**面板**索引標籤上，按一下**閾值**。

1.  按一下**新增閾值**。

1.  完成下列欄位：
   +  **T1 -** 顯示閾值需要這兩個值。
     +  **lt** 或 **gt** - 選取 **lt** 表示小於 ，或選取 **lt** 表示套用閾值。
     +  **值 -** 輸入閾值。Grafana 會沿著 Y 軸在該值繪製閾值線。
   +  **顏色 -** 選擇與顏色對應的條件，或定義您自己的顏色。
     +  **自訂 -** 您可以定義填充顏色和線條顏色。
     +  **關鍵 -** 填滿和線條顏色為紅色。
     +  **警告 -** 填滿且行顏色為黃色。
     +  **ok -** 填滿且線條顏色為綠色。
   +  **Fill -** 控制是否顯示閾值填充。
   +  **行 -** 控制是否顯示閾值行。
   +  **Y 軸 -** 選擇**左側**或**右側**。

1.  按一下**儲存**以儲存儀表板中的變更。

# 設定資料連結
<a name="v9-panels-configure-data-links"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

 您可以使用資料連結變數或資料連結，在面板之間建立連結。

## 資料連結變數
<a name="v9-panels-data-link-variables"></a>

 您可以在資料連結中使用變數來參考序列欄位、標籤和值。如需資料連結的詳細資訊，請參閱 [資料連結](#v9-panels-data-links)。

 若要查看可用變數的清單，請在資料連結 **URL** 欄位中輸入 **\$1**，以查看您可以使用的變數清單。

**注意**  
 這些變數在 6.4 版中變更，因此如果您有較舊版本的 Grafana，請使用版本選擇器為較舊版本的 Grafana 選取文件。

 您也可以在資料連結 URLs中使用範本變數，請參閱 [新增和管理儀表板變數](v9-dash-variables.md)。

## 時間範圍面板變數
<a name="v9-panels-time-range-panel-variables"></a>

 這些變數可讓您在資料連結 URL 中包含目前的時間範圍。
+  **\$1\$1url\$1time\$1range** - 目前儀表板的時間範圍 （即 **？from=now-6h&to=now**) 
+  **\$1\$1\$1from 和 \$1\$1\$1to** - 如需詳細資訊，請參閱 [全域變數](v9-dash-variable-add.md#v9-dash-variable-add-global)。

## 系列變數
<a name="v9-panels-series-variables"></a>

 系列特定變數可在 **\$1\$1 系列**命名空間下取得：
+  **\$1\$1series.name** - URL 的序列名稱 

## 欄位變數
<a name="v9-panels-field-variables"></a>

 欄位特定變數可在 **\$1\$1 欄位**命名空間下取得：
+  **\$1\$1field.name** - 欄位的名稱 
+  **\$1\$1field.labels.<LABEL>** - 標籤的 URL 值。如果您的標籤包含點，請使用 **\$1\$1field.labels【"<LABEL>"】** 語法。

## 值變數
<a name="v9-panels-value-variables"></a>

 值特定的變數可在 **\$1\$1value** 命名空間下使用：
+  **\$1\$1value.time** - 值對 URL 的時間戳記 (Unix ms epoch) （即 **？time=1560268814105**) 
+  **\$1\$1value.raw** - 原始值 
+  **\$1\$1value.numeric** - 數值的數值表示法 
+  **\$1\$1value.text** - 值的文字表示 
+  **\$1\$1value.calc** - 如果值是計算的結果，則為計算名稱 

## 範本變數
<a name="v9-panels-template-variables"></a>

 連結至使用範本變數的另一個儀表板時，請為按一下連結的人員選取變數值。

 **\$1\$1var-myvar：queryparam\$1** - 其中 **var-myvar** 是範本變數的名稱，與您要使用的目前儀表板中的變數相符。


|  變數狀態  |  產生建立的 URL  | 
| --- | --- | 
|  已選取一個值  |  var-myvar=value1  | 
|  已選取多個值  |  var-myvar=value1&var-myvar=value2  | 
|  已選取全部  |  var-myvar=All  | 

 如果您想要將所有目前儀表板的變數新增至 URL，請使用 **\$1\$1\$1\$1all\$1variables\$1**。

## 資料連結
<a name="v9-panels-data-links"></a>

 資料連結可讓您為連結提供更精細的內容。您可以建立包含系列名稱或甚至是游標下值的連結。例如，如果您的視覺化顯示四部伺服器，您可以將資料連結新增至其中一或兩部伺服器。

 連結本身可透過不同方式存取，視視覺化效果而定。對於圖形，您需要按一下資料點或線，對於 Stat、Gauge 或 Bar Gauge 等面板，您可以按一下視覺化上的任意位置來開啟內容功能表。

 您可以在資料連結中使用變數，將人員傳送至具有保留資料篩選條件的詳細儀表板。例如，您可以使用變數來指定時間範圍、序列和變數選擇。如需詳細資訊，請參閱[資料連結變數](#v9-panels-data-link-variables)。

### Typeahead 建議
<a name="v9-panels-typeahead-suggestions"></a>

 建立或更新資料連結時，請按鍵盤上的 Cmd\$1Space 或 Ctrl\$1Space 開啟預先輸入建議，以更輕鬆地將變數新增至 URL。

### 新增資料連結
<a name="v9-panels-add-a-datalink"></a>

1.  將游標暫留在您要新增連結的面板上，然後按 **e**。或者，按一下面板標題旁的下拉箭頭，然後按一下**編輯**。

1.  在欄位索引標籤上，向下捲動至資料連結區段。

1.  展開資料連結，然後按一下**新增連結**。

1.  輸入**標題**。**標題**是顯示在 UI 中連結的人類可讀標籤。

1.  輸入您要連結的 **URL**。

    您甚至可以新增儀表板中定義的其中一個範本變數。按一下 **URL** 欄位，然後輸入 **\$1** 或按 Ctrl\$1Space 或 Cmd\$1Space 以查看可用變數的清單。透過將範本變數新增至面板連結，連結會將使用者傳送至正確的內容，並已設定相關變數。如需詳細資訊，請參閱[資料連結變數](#v9-panels-data-link-variables)。

1.  如果您想要在新索引標籤中開啟連結，請選取**在新索引標籤中開啟**。

1.  按一下**儲存**以儲存變更並關閉視窗。

1.  按一下右上角的**儲存**，將變更儲存至儀表板。

### 更新資料連結
<a name="v9-panels-update-a-datalink"></a>

1.  在欄位索引標籤上，尋找您要進行變更的連結。

1.  按一下編輯 （鉛筆） 圖示以開啟編輯連結視窗。

1.  進行任何必要變更。

1.  按一下**儲存**以儲存變更並關閉視窗。

1.  按一下右上角的**儲存**，將變更儲存至儀表板。

### 刪除資料連結
<a name="v9-panels-delete-a-datalink"></a>

1.  在欄位索引標籤上，尋找您要刪除的連結。

1.  按一下您要刪除之連結旁的 **X** 圖示。

1.  按一下右上角的**儲存**，將變更儲存至儀表板。

# 設定欄位覆寫
<a name="v9-panels-configure-overrides"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

 覆寫可讓您自訂特定欄位或序列的視覺化設定。這是透過新增覆寫規則來實現的，該規則以一組特定的欄位為目標，並且可以各自定義多個選項。

 例如，您可以為包含文字 "bytes" 的所有欄位設定單位，方法是使用**名稱符合 regex** 比對程式的欄位新增覆寫，然後將單位選項新增至覆寫規則。

## 範例 1：格式化溫度
<a name="v9-panels-overrides-format-temperature"></a>

 假設結果集是由兩個欄位組成的資料框架：時間和溫度。


|  time  |  溫度  | 
| --- | --- | 
|  2020-01-02 03：04：00  |  45.0  | 
|  2020-01-02 03：05：00  |  47.0  | 
|  2020-01-02 03：06：00  |  48.0  | 

 此結構的每個欄位 （資料欄） 都可以套用變更其值顯示方式的欄位選項。例如，這表示您可以將單位設定為溫度 > 攝氏，導致下表：


|  time  |  溫度  | 
| --- | --- | 
|  2020-01-02 03：04：00  |  45.0°C  | 
|  2020-01-02 03：05：00  |  47.0°C  | 
|  2020-01-02 03：06：00  |  48.0°C  | 

 此外，不需要小數位數，因此我們可以將其移除。您可以將小數從**自動**變更為零 (**0**)，產生下表：


|  time  |  溫度  | 
| --- | --- | 
|  2020-01-02 03：04：00  |  45°C  | 
|  2020-01-02 03：05：00  |  47°C  | 
|  2020-01-02 03：06：00  |  48°C  | 

## 範例 2：格式化溫度和濕度
<a name="v9-panels-overrides-format-humidity"></a>

 假設結果集是由四個欄位組成的資料框架：時間、高溫度、低溫度和濕度。


|  time  |  溫度過高  |  低溫度  |  濕度  | 
| --- | --- | --- | --- | 
|  2020-01-02 03：04：00  |  45.0  |  30.0  |  67  | 
|  2020-01-02 03：05：00  |  47.0  |  34.0  |  68  | 
|  2020-01-02 03：06：00  |  48.0  |  31.0  |  68  | 

 讓我們新增攝氏單位並刪除小數位數。這會導致下表：


|  time  |  溫度過高  |  低溫度  |  濕度  | 
| --- | --- | --- | --- | 
|  2020-01-02 03：04：00  |  45°C  |  30°C  |  67°C  | 
|  2020-01-02 03：05：00  |  47°C  |  34°C  |  68°C  | 
|  2020-01-02 03：06：00  |  48°C  |  31°C  |  68°C  | 

 溫度欄位看起來不錯，但現在必須變更濕度。我們可以透過將欄位選項覆寫套用至濕度欄位，並將單位變更為雜項 > 百分比 (0-100) 來修正此問題。


|  time  |  溫度過高  |  低溫度  |  濕度  | 
| --- | --- | --- | --- | 
|  2020-01-02 03：04：00  |  45°C  |  30°C  |  67%  | 
|  2020-01-02 03：05：00  |  47°C  |  34°C  |  68%  | 
|  2020-01-02 03：06：00  |  48°C  |  31°C  |  68%  | 

## 新增欄位覆寫
<a name="v9-panels-overrides-add-a-field"></a>

 欄位覆寫規則可以自訂特定欄位或系列的視覺化設定。

1.  編輯您要新增覆寫的面板。

1.  在面板選項側邊窗格中，按一下窗格底部的**新增欄位覆寫**。

1.  選取要套用覆寫規則的欄位：
   +  **名稱為 的欄位：**從所有可用欄位清單中選取欄位。您使用此選取器新增至規則的屬性只會套用至此單一欄位。
   +  **名稱符合 regex 的欄位：**指定要以規則表達式覆寫的欄位。您使用此選取器新增至規則的屬性會套用至欄位名稱符合 regex 的所有欄位。
   +  **類型為：**依類型選取欄位，例如字串、數字等。您使用此選取器新增至規則的屬性會套用至符合所選類型的所有欄位。
   +  **查詢傳回的欄位：**選取特定查詢傳回的所有欄位，例如 A、B 或 C。使用此選取器新增至規則的屬性會套用至所選查詢傳回的所有欄位。

1.  按一下**新增覆寫屬性**。

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

1.  透過在 欄位中新增值來輸入選項。若要將選項傳回預設值，請刪除欄位中的白色文字。

1.  繼續按一下**新增覆寫屬性**，將覆寫新增至此欄位，或者您可以按一下**新增覆寫**，然後選取不同的欄位來新增覆寫。

1.  完成後，按一下**儲存**將所有面板編輯儲存至儀表板。

## 刪除欄位覆寫
<a name="v9-panels-overrides-delete-a-field"></a>

 當您不再需要欄位覆寫時，請將其刪除。當您刪除覆寫時，值的外觀會預設為原始格式。此變更會影響依賴受影響面板的儀表板和儀表板使用者。

1.  編輯包含您要刪除之覆寫的面板。

1.  在面板選項側邊窗格中，向下捲動，直到您看到覆寫為止。

1.  按一下您要刪除的覆寫，然後按一下相關聯的垃圾桶圖示。

## 檢視欄位覆寫
<a name="v9-panels-overrides-view"></a>

 您可以在面板顯示選項中檢視欄位覆寫。

1.  編輯包含您要檢視之覆寫的面板。

1.  在面板選項側邊窗格中，向下捲動，直到您看到覆寫為止。

 **所有**索引標籤上顯示的覆寫設定與**覆寫**索引標籤上顯示的設定相同。

## 編輯欄位覆寫
<a name="v9-panels-overrides-edit-a-field"></a>

 當您想要變更覆寫設定時，請編輯欄位覆寫。您所做的變更會立即生效。

1.  編輯包含您要編輯之覆寫的面板。

1.  在面板選項側邊窗格中，向下捲動，直到您看到覆寫為止。

1.  找到您要變更的覆寫。

1.  執行下列任何一項：
   +  編輯現有覆寫或欄位選取參數的設定。
   +  按一下屬性旁的 **X**，以刪除現有的覆寫屬性。
   +  按一下新增覆寫屬性來**新增覆寫屬性**。

# 設定值映射
<a name="v9-panels-configure-value-mappings"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

 除了欄位覆寫之外，值映射是一種可用來變更視覺效果中資料視覺化處理的技術。

 透過值映射映射的值會略過單位格式。這表示映射到數值的文字值不是使用設定的單位進行格式化。

 如果面板中存在值映射，則 Grafana 會在面板編輯器的側邊窗格中顯示摘要。

**注意**  
 新值映射與一些視覺效果不相容，例如圖形 （舊）、文字和熱度圖。

## 值映射的類型
<a name="v9-panels-value-mappings-types"></a>

 Grafana 支援下列值映射：
+  **值：**將文字值映射至顏色或不同的顯示文字。例如，您可以設定值映射，讓值 **10** 的所有執行個體顯示為 **Perfection！**，而不是數字。
+  **範圍：**將數值範圍映射至顯示文字和顏色。例如，如果值在特定範圍內，您可以設定範圍值映射以顯示**低**或**高**，而不是數字。
+  **Regex：**將規則表達式映射至替代文字和顏色。例如，如果值是 **www.example.com**，您可以設定 regex 值映射，讓 Grafana 顯示 **www** 並截斷網域。
+  **特殊**映射特殊值，例如 **Null**、**NaN** （非數字） 和布林值，例如 **true** 和 **false**，以顯示文字和顏色。例如，您可以設定特殊值映射，讓 **null** 值顯示為 **N/A**。

 您也可以使用左側的點來拖曳和重新排序清單中的值映射。

## 映射值
<a name="v9-panels-value-mappings-map-a-value"></a>

 當您想要格式化單一值時，請映射一個值。

1.  開啟您要映射其值的面板。

1.  在面板顯示選項中，找到**值映射**區段，然後按一下**新增值映射**。

1.  按一下**新增映射**，然後選取**值**。

1.  輸入要比對的 Grafana 值。

1.  （選用） 輸入顯示文字。

1.  （選用） 設定顏色。

1.  按一下**更新**以儲存值映射。

## 映射範圍
<a name="v9-panels-value-mappings-map-a-range"></a>

 當您想要格式化多個連續值時，請映射一系列的值。

1.  編輯您要映射其值範圍的面板。

1.  在面板顯示選項中，在**值映射**區段中，按一下**新增值映射**。

1.  按一下**新增映射**，然後選取**範圍**。

1.  輸入 Grafana 相符範圍內的開始和結束值。

1.  （選用） 輸入顯示文字。

1.  （選用） 設定顏色。

1.  按一下**更新**以儲存值映射。

## 映射規則表達式
<a name="v9-panels-value-mappings-map-a-regex"></a>

 當您想要格式化規則表達式值的文字和顏色時，請映射規則表達式。

1.  編輯您要映射規則表達式的面板。

1.  在面板顯示選項**的值映射**區段中，按一下**新增值映射**。

1.  按一下**新增映射**，然後選取 **Regex**。

1.  輸入要比對的 Grafana 規則表達式模式。

1.  （選用） 輸入顯示文字。

1.  （選用） 設定顏色。

1.  按一下**更新**以儲存值映射。

## 映射特殊值
<a name="v9-panels-value-mappings-map-a-special-value"></a>

 當您想要格式化不常見、布林值或空值時，請映射特殊值。

1.  編輯您要為其映射特殊值的面板。

1.  在面板顯示選項中，找到**值映射**區段，然後按一下**新增值映射**。

1.  按一下**新增映射**，然後選取**特殊**。

1.  選取要比對的 Grafana 特殊值。

1.  （選用） 輸入顯示文字。

1.  （選用） 設定顏色。

1.  按一下**更新**以儲存值映射。

## 編輯值映射
<a name="v9-panels-value-mappings-edit-a-value"></a>

 您可以隨時變更值映射。

1.  編輯包含您要編輯之值映射的面板。

1.  在面板顯示選項中，在**值映射**區段中，按一下**編輯值映射**。

1.  進行變更，然後按一下**更新**。

# 設定圖例
<a name="v9-panels-configure-legend"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

面板包含圖例，可用來解譯視覺效果中顯示的資料。每個圖例選項都會為視覺化中說明的資料新增內容和清晰度。

## 在視覺化中隔離序列資料
<a name="v9-panels-legend-isolate"></a>

視覺化通常很複雜，並包含許多資料序列。您可以從視覺化中移除序列資料來簡化檢視，這會隔離您想要查看的資料。Grafana 會在覆寫索引標籤中自動建立新的**覆寫**。

當您套用變更時，視覺化變更會顯示在面板的所有使用者。

**在視覺化中隔離序列資料**

1. 開啟面板。

1. 在圖例中，選取您要隔離的序列標籤。

   系統會從檢視所有其他序列資料中移除 。

1. 若要將序列資料累加至隔離序列，請按 **Ctrl** 或 **Command** 鍵，然後選取您要新增的序列標籤。

1. 若要還原至包含所有資料的預設檢視，請按一下任何序列標籤兩次。

1. 若要儲存您的變更，使其出現在面板的所有檢視器中，請選取**套用**。

本主題目前適用於下列視覺化效果：
+ [長條圖](v9-panels-bar-chart.md)
+ [直方圖](v9-panels-histogram.md)
+ [圓餅圖](v9-panels-piechart.md)
+ [狀態時間軸](v9-panels-state-timeline.md)
+ [狀態歷史記錄](v9-panels-status-history.md)
+ [時間序列](v9-panels-time-series.md)

## 將值新增至圖例
<a name="v9-panels-legend-add-values"></a>

若要將更多內容新增至視覺化，您可以將序列資料值新增至圖例。您可以視需要新增任意數量的值；套用變更後，您可以水平捲動圖例以查看所有值。

**將值新增至圖例**

1. 編輯面板。

1. 在面板顯示選項窗格中，找到**圖例**區段。

1. 在**圖例值**欄位中，選取您要顯示在圖例中的值。

1. 選擇**套用**以儲存您的變更會導覽回儀表板。

## 變更系列顏色
<a name="v9-panels-legend-change-color"></a>

根據預設，Grafana 會指定您可以變更的序列資料顏色。

**變更系列顏色**

1. 編輯面板。

1. 在圖例中，選取與序列相關聯的顏色列。

1. 從調色盤中選取預設顏色或自訂顏色。

1. 選擇**套用**以儲存您的變更會導覽回儀表板。

## 排序序列
<a name="v9-panels-legend-sort"></a>

您可以將圖例模式變更為**資料表**，然後選擇[計算類型](v9-panels-calculation-types.md)顯示在圖例中。選取圖例資料表中的計算名稱標頭，以遞增或遞減順序排序資料表中的值。

排序順序會影響長條圖面板中長條的位置，以及時間序列和長條圖面板中堆疊序列的順序。

**注意**  
此功能僅支援這些面板：長條圖、直方圖、時間序列、XY 圖。

# 計算類型
<a name="v9-panels-calculation-types"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

 下表包含您可以在 Grafana 中執行的計算清單。您可以在**轉換**索引標籤和長條圖、量測計和狀態視覺化中找到這些計算。


|  計算  |  Description  | 
| --- | --- | 
|  所有 null  |  當所有值皆為 Null 時為 True  | 
|  所有零  |  當所有值都是 0 時為 true  | 
|  變更計數  |  欄位值變更的次數  | 
|  計數  |  欄位中的值數目  | 
|  Delta  |  值的累積變更，僅計數增量  | 
|  差異  |  欄位第一個值和最後一個值之間的差異  | 
|  差異百分比  |  欄位第一個和最後一個值之間的百分比變更  | 
|  不同計數  |  欄位中唯一值的數量  | 
|  第一個 （非 null)  |  首先，不是欄位中的 null 值  | 
|  最多  |  欄位的最大值  | 
|  Mean  |  欄位中所有值的平均值  | 
|  變異數  |  欄位中所有值的差異  | 
|  StdDev  |  欄位中所有值的標準差  | 
|  最少  |  欄位的最小值  | 
|  最小值 （零以上）  |  欄位的最小值、正值  | 
|  範圍  |  欄位的最大值與最小值之間的差異  | 
|  步驟  |  欄位值之間的最小間隔  | 
|  總計  |  欄位中所有值的總和  | 

# 註釋視覺效果
<a name="v9-panels-annotate-visualizations"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

註釋提供使用豐富事件在圖形上標記點的方法。當您將滑鼠暫留在註釋上時，您可以取得事件描述和事件標籤。文字欄位可以包含其他系統的連結，其中包含更多詳細資訊。

**原生註釋**

Grafana 隨附原生註釋存放區，以及直接從圖形面板或透過 HTTP API 新增註釋事件的功能。

**新增註釋**

1. 在儀表板中，按一下**時間序列**面板。隨即顯示內容功能表。

1. 在內容功能表中，按一下**新增註釋**。

1. 新增註釋描述，以及選擇性的標籤。

1. 按一下 **Save (儲存)**。

或者，若要新增註釋，`Ctrl+Click`或在**時間序列**面板`Cmd+Click`上，則會顯示**新增註釋**快顯視窗。

**新增區域註釋**

1. 在儀表板中，`Ctrl+Click`或在**時間序列**面板`Cmd+Click`上。

1. 在內容功能表中，按一下**新增註釋**。

1. 新增註釋描述，以及選擇性的標籤。

1. 按一下 **Save (儲存)**。

**編輯註釋**

1. 在儀表板中，將滑鼠暫留在**時間序列**面板上的註釋指標上。

1. 按一下註釋工具提示中的編輯 （鉛筆） 圖示。

1. 修改描述，以及選擇性的標籤。

1. 按一下 **Save (儲存)**。

**刪除註釋**

1. 在儀表板中，將滑鼠游標暫留在**時間序列**面板上的註釋指標上。

1. 按一下註釋工具提示中的垃圾桶圖示。

**內建查詢**

新增註釋之後，它們仍然可見。這是因為存在於所有儀表板上的內建註釋查詢。此註釋查詢將擷取來自目前儀表板的所有註釋事件，並在建立它們的面板上顯示它們。這包括提醒狀態歷史記錄註釋。您可以開啟註釋設定 （透過儀表板齒輪功能表） 並修改名為 的查詢，以停止擷取和繪製**註釋**`Annotations & Alerts (Built-in)`。

當您使用**另存新檔**功能複製儀表板時，它會取得新的儀表板 ID，因此在來源儀表板上建立的註釋不會再出現在副本上。如果您新增**註釋查詢**並依標籤篩選，仍然可以顯示它們。只有在來源儀表板上的註釋具有要篩選的標籤時，此功能才有效。

**依標籤查詢**

您可以建立新的查詢，透過`-- Grafana --`資料來源從原生註釋存放區擷取註釋，方法是將**篩選條件**設定為 `Tags`。

Grafana v8.1 和更新版本也支援預先輸入現有標籤，提供至少一個標籤。

例如，建立註釋查詢名稱`outages`並指定標籤 `outage`。此查詢會顯示具有中斷標籤的所有註釋 （來自任何儀表板或透過 API)。如果在註釋查詢中定義多個標籤，則 Grafana 只會顯示符合所有標籤的註釋。若要修改行為，請啟用 `Match any`，Grafana 會顯示包含您提供之任何標籤的註釋。

在 Grafana v5.3\$1 中，可以在標籤查詢中使用範本變數。因此，如果您有一個儀表板顯示不同服務的統計資料，以及指定要顯示哪些服務的範本變數，您現在可以在註釋查詢中使用相同的範本變數，只顯示這些服務的註釋。

**查詢其他資料來源**

註釋事件會透過註釋查詢擷取。若要將新的註釋查詢新增至儀表板，請開啟儀表板設定選單，然後選取**註釋**。這會開啟儀表板註釋設定檢視。若要建立新的註釋查詢，請按一下**新增**按鈕。

指定註釋查詢的名稱。此名稱會提供給切換 （核取方塊），可讓您啟用或停用顯示來自此查詢的註釋事件。例如，您可能有兩個名為 `Deploys`和 的註釋查詢`Outages`。切換可讓您決定要顯示哪些註釋。

**註釋查詢詳細資訊**

每個資料來源的註釋查詢選項都不同。如需特定資料來源中註釋的相關資訊，請參閱特定[資料來源](AMG-data-sources.md)主題。

# 面板檢查檢視
<a name="v9-panels-panel-inspector"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

 面板檢查檢視可透過面板選單開啟，可協助您了解面板並進行疑難排解。您可以檢查任何 Grafana 面板的原始資料、將該資料匯出至逗號分隔值 (CSV) 檔案、檢視查詢請求，以及匯出面板和資料 JSON。

**注意**  
 並非所有面板類型都包含所有標籤。例如，儀表板清單面板沒有要檢查的原始資料，因此不會顯示統計資料、資料或查詢索引標籤。

 面板檢查器包含下列選項：

1.  面板檢查器會在窗格頂端顯示**檢查：【NameOfPanelBeingInspected】**。按一下右上角的箭頭以展開或縮小窗格。

1.  **資料索引標籤 -** 顯示套用轉換之查詢傳回的原始資料。預設不會套用覆寫和值映射等欄位選項。

1.  **統計資料索引標籤 -** 顯示查詢需要多長時間，以及傳回多少。

1.  **JSON 索引標籤 -** 可讓您檢視和複製面板 JSON、面板資料 JSON 和資料框架結構 JSON。如果您佈建或管理 Grafana，這會很有用。

1.  **查詢索引標籤 -** 顯示 Grafana 查詢資料來源時傳送至伺服器的請求。

1.  **錯誤索引標籤 -** 顯示錯誤。只有在查詢傳回錯誤時才會顯示。

## 下載原始查詢結果
<a name="v9-panels-raw-query-results"></a>

 Grafana 會產生 CSV 檔案，其中包含您的資料，包括該資料的任何轉換。您可以選擇在面板套用欄位選項或欄位選項覆寫之前或之後檢視資料。

1.  編輯包含您要下載之查詢資料的面板。

1.  在查詢編輯器中，按一下**查詢檢查器**。

1.  按一下**資料**。

    如果您的面板包含多個查詢或多個節點，則您還有其他選項。
   +  **選取結果**：選擇要檢視的結果集資料。
   +  **轉換資料** 
   +  **依時間聯結**：一次檢視所有查詢的原始資料，每欄一個結果集。按一下欄標題以重新排序資料。

1.  若要在系統套用欄位覆寫之前查看資料，請按一下**格式化資料**切換。

1.  若要下載專為 Excel 格式化的 CSV 檔案，請按一下 **Download for Excel** 切換 。

1.  按一下**下載 CSV**。

## 檢查查詢效能
<a name="v9-panels-query-performance"></a>

 **統計資料**索引標籤會顯示統計資料，告訴您查詢需要多長時間、傳送多少查詢，以及傳回的資料列數。此資訊可協助您對查詢進行疑難排解，尤其是在任何數字意外過高或過低時。

1.  編輯包含查詢的面板，其中包含您要檢查的效能。

1.  在查詢編輯器中，按一下**查詢檢查器**。

1.  按一下**統計資料**。

 統計資料會以唯讀格式顯示。

## 檢查查詢請求和回應
<a name="v9-panels-query-request-response"></a>

 當您想要對傳回非預期結果或無法傳回預期結果的查詢進行疑難排解時，請檢查查詢請求和回應資料。

1.  編輯包含您要匯出之查詢的面板。

1.  在查詢編輯器中，按一下**查詢檢查器**。

1.  按一下**重新整理**。

    面板會填入回應資料。

1.  視需要進行調整，並重新執行查詢。

1.  若要下載查詢請求和回應資料，請按一下**複製到剪貼簿**圖示，然後將結果貼到另一個應用程式。

# Grafana 第 9 版中可用的視覺化
<a name="v9-panels-viz"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

Grafana 提供各種視覺效果，以支援不同的使用案例。文件的本節重點介紹內建面板、其選項和典型用量。

面板是開始使用的常見[時間序列面板](v9-panels-time-series.md)面板，以及了解使用面板的基本知識。

**Topics**
+ [警示清單面板](v9-panels-alert-list.md)
+ [註釋面板](v9-panels-annotations.md)
+ [長條圖面板](v9-panels-bar-chart.md)
+ [長條規](v9-panels-bar-gauge.md)
+ [Candlestick 面板](v9-panels-candlestick.md)
+ [Canvas 面板](v9-panels-canvas.md)
+ [時鐘面板](v9-panels-clock.md)
+ [儀表板清單](v9-panels-dashboard-list.md)
+ [量測計面板](v9-panels-gauge.md)
+ [Geomap 面板](v9-panels-geomap.md)
+ [圖形面板](v9-panels-graph.md)
+ [熱度圖面板](v9-panels-heatmap.md)
+ [直方圖面板](v9-panels-histogram.md)
+ [日誌面板](v9-panels-logs.md)
+ [新聞面板](v9-panels-news.md)
+ [節點圖形面板](v9-panels-node-graph.md)
+ [圓餅圖面板](v9-panels-piechart.md)
+ [Plotly 面板](v9-panels-plotly.md)
+ [Sankey 面板](v9-panels-sankey.md)
+ [散佈面板](v9-panels-scatter.md)
+ [Stat 面板](v9-panels-stat.md)
+ [狀態時間軸面板](v9-panels-state-timeline.md)
+ [狀態歷史記錄面板](v9-panels-status-history.md)
+ [資料表面板](v9-panels-table.md)
+ [文字面板](v9-panels-text.md)
+ [時間序列面板](v9-panels-time-series.md)
+ [追蹤面板 (Beta 版）](v9-panels-traces.md)
+ [WindRose](v9-panels-windrose.md)

# 警示清單面板
<a name="v9-panels-alert-list"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

警示清單面板會顯示您的儀表板警示。您可以設定清單以顯示目前狀態或最近狀態變更。如需警示的詳細資訊，請參閱 [Grafana 第 9 版中的提醒](v9-alerts.md)。

使用這些設定來精簡您的視覺化效果。

## 選項
<a name="v9-panels-alert-list-options"></a>
+  **群組模式** – 選擇**預設分組**以顯示依提醒規則分組的提醒執行個體，或**選擇自訂分組**，依一組自訂標籤分組提醒執行個體。
+  **項目上限** – 設定要列出的提醒數目上限。
+  **排序順序** – 選取如何排序顯示的提醒。
  +  **按字母順序 (asc)** – 按字母順序排列
  +  **字母 (desc)** – 反向字母順序
  +  **重要性** – 根據下列值，其中 1 為最高：
    + `alerting` 或 `firing`：1
    + `no_data`: 2
    + `pending`：3
    + `ok`：4
    + `paused` 或 `inactive`：5
+  **此儀表板的提醒** – 僅顯示來自儀表板的提醒，提醒清單位於其中。

## 篩選條件
<a name="v9-panels-alert-filter"></a>

使用下列選項來篩選警示，以符合您選擇的查詢、資料夾或標籤：
+  **警示名稱** – 輸入警示名稱查詢。
+  **警示執行個體標籤** – 使用標籤查詢篩選警示執行個體。例如 `{severity="critical", instance=~"cluster-us-.+"}`。
+  **資料夾** – 選取資料夾。只會顯示所選資料夾中儀表板的提醒。
+  **資料來源** – 從選取的資料來源篩選提醒。

## 狀態篩選條件
<a name="v9-panels-alert-state-filter"></a>

選擇要在此面板中顯示的提醒狀態。
+ 警示/觸發
+ 待定
+ 無資料
+ 正常
+ 錯誤

# 註釋面板
<a name="v9-panels-annotations"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

註釋面板會顯示可用於檢視註釋資料的註釋清單。有多種選項可根據標籤和目前儀表板來篩選清單。

## 註釋查詢
<a name="v9-panels-annotations-query"></a>

下列選項控制註釋清單的來源查詢。

**查詢篩選條件**

使用查詢篩選條件，從組織中的所有儀表板或此面板所在的目前儀表板建立註釋清單。它有下列選項：
+ 所有儀表板 - 列出目前組織中所有儀表板的註釋。
+ 此儀表板 - 將清單限制為目前儀表板上的註釋。

**時間範圍**

使用時間範圍選項指定清單是否應限制為目前的時間範圍。它有下列選項：
+ 無 - 註釋查詢沒有時間範圍限制。
+ 此儀表板 - 將清單限制為可使用註釋清單面板的儀表板時間範圍。

**Tags** (標籤)

使用標籤選項依標籤篩選註釋。您可以新增多個標籤，以精簡清單。

**注意**  
或者，選擇作為面板本身結果一部分列出的標籤，讓標籤清單保持空白並即時篩選。

*限制*

使用限制選項來限制傳回的結果數量。

## 顯示
<a name="v9-panels-annotations-display"></a>

這些選項控制註釋面板顯示中包含的其他中繼資料。

**顯示使用者**

使用此選項可顯示或隱藏建立註釋的使用者。

**顯示時間**

使用此選項可顯示或隱藏註釋建立時間的時間。

**顯示標籤**

使用此選項可顯示或隱藏與註釋相關聯的標籤。注意**：您可以使用標籤來即時篩選面板本身的註釋清單。

## 連結行為
<a name="v9-panels-annotations-links"></a>

**連結目標**

使用此選項來選擇如何檢視標註的資料。它有下列選項。
+ 面板 - 此選項會將您直接帶入面板的全螢幕檢視，其中包含對應的註釋
+ 儀表板 - 此選項會將註釋聚焦在完整儀表板的內容中

**之前的時間**

使用此選項可設定註釋之前的時間範圍。使用持續時間字串值，例如「1h」 = 1 小時、「10m」 = 10 分鐘等。

**之後的時間**

使用此選項可設定註釋之後的時間範圍。

# 長條圖面板
<a name="v9-panels-bar-chart"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

此面板視覺化可讓您繪製分類資料圖形。

## 支援的資料格式
<a name="v9-panels-bar-chart-formats"></a>

僅支援一個資料影格，且至少需要一個字串欄位做為 X 或 Y 軸的類別，以及一或多個數值欄位。以下是資料格式的範例：


|  瀏覽器  |  市場份額  | 
| --- | --- | 
|  Chrome  |  50  | 
|  Internet Explorer  |  17.5  | 

如果您有多個數值欄位，面板會顯示分組長條。

### 視覺化時間序列或多個結果集
<a name="v9-panels-bar-chart-visualization"></a>

如果您有多個時間序列或資料表，您首先需要使用聯結來聯結它們，或減少轉換。例如，如果您有多個時間序列，並且想要比較其最後一個和最大值，請新增**減少**轉換，並在**計算**下指定**最大值**和**最後一個**作為選項。

## 長條圖選項
<a name="v9-panels-bar-chart-options"></a>

使用這些選項來精簡您的視覺化效果：

**Orientation (方向)**
+  **自動 ** – Grafana 會根據面板維度決定長條方向。
+  **水平** – 使 X 軸成為類別軸。
+  **垂直** – 將 Y 軸設為類別軸。

**X 軸刻度標籤長度上限**會設定長條圖標籤的長度上限。超過長度上限的標籤會被截斷 （使用省略符號）。

**長條標籤的最小間距**會設定長條標籤之間的最小間距。

**顯示值**

控制值是否顯示在長條的頂端或左側。
+  **自動 ** – 如果有空格，則會顯示值。
+  **一律** – 一律顯示值。
+  **從**不 – 從不顯示值。

**堆疊**

控制長條圖堆疊。
+  **關閉** – 不會堆疊長條。
+  **正常** – 橫條會彼此堆疊。
+  **百分比** – 長條會彼此堆疊，而每個長條的高度是堆疊總高度的百分比 （所有長條堆疊都將是相同的高度，相加高達 100%)。

**群組寬度**控制群組的寬度。0 = 最小和 1 = 最大寬度。

**長條寬度**控制長條的寬度。0 = 最小和 1 = 最大寬度。

**長條半徑**控制長條的半徑，0 = 最小，0.5 = 最大半徑。

**將游標暫留在長條上時，如果反白長條的周圍區域，則反白暫留控制項上的完整**區域。

**線條寬度**控制長條的線條寬度。

**填充不透明度**控制長條的填充不透明度。

**漸層模式**會設定漸層填充的模式。填充漸層是以線條顏色為基礎。若要變更顏色，請使用標準顏色方案欄位選項。漸層外觀會受到**填滿不透明度**設定的影響。
+  **無 ** – 無漸層填充，這是預設設定。
+  **不透明度** – 漸層的透明度是根據 y 軸上的值計算。填充的不透明度隨著 Y 軸上的值而增加。
+  **Hue** – 根據線條顏色的色調產生漸層顏色。

**工具提示模式** – 當您將游標停留在視覺化效果上時，Grafana 可以顯示工具提示。選擇工具提示的行為方式。
+  **單一 ** – 暫留工具提示僅顯示單一序列，即您要暫留在視覺化效果上的序列。
+  **全部** – 暫留工具提示會顯示視覺化中的所有序列。Grafana 會反白顯示您在工具提示的序列清單中以粗體暫留的序列。
+  **隱藏** – 當您與視覺化互動時，請勿顯示工具提示。

**注意**  
您可以使用覆寫來隱藏工具提示中的個別序列。

**圖例模式** – 使用這些設定來精簡圖例在視覺化中的顯示方式。如需詳細資訊，請參閱[設定圖例](v9-panels-configure-legend.md)。
+  **清單 ** – 將圖例顯示為清單。這是圖例的預設顯示模式。
+  **資料表** – 將圖例顯示為資料表。
+  **隱藏** – 隱藏圖例。

**圖例放置** – 選擇放置圖例的位置。
+  **底部 ** – 圖表下方。
+  **右側** – 圖形右側。

**圖例計算** – 選擇要在圖例中顯示的標準計算。您可以有多個 。

**文字大小** – 輸入值以變更長條圖上的文字大小。

**軸** – 使用下列欄位設定來精簡軸的顯示方式。在編輯的欄位選項方塊外按一下或按下 Enter 鍵之前，某些欄位選項不會影響視覺化效果。
+  **置放 ** – 設定 Y 軸的置放。
+  **自動** – Grafana 會自動將 Y 軸指派給序列。當有兩個或更多具有不同單位的序列時，Grafana 會將左軸指派給第一個單位，並將右軸指派給下列單位。
+  **左側** – 在左側顯示所有 Y 軸。
+  **右側** – 在右側顯示所有 Y 軸。
+  **隱藏** – 隱藏所有 Y 軸。
+  **標籤** – 設定 Y 軸文字標籤。如果您有多個 Y 軸，則可以使用覆寫來指派不同的標籤。
+  **寬度** – 設定軸的固定寬度。根據預設，Grafana 會動態計算軸的寬度。

  透過設定軸的寬度，具有不同軸類型的資料可以共用相同的顯示比例。這可讓您更輕鬆地比較多個圖形的資料值，因為軸不會在視覺上彼此接近的範圍內移動或延伸。
+  **軟性最小值和軟性最大值** – 設定軟性最小值和軟性最大值選項，以更好地控制 Y 軸限制。根據預設，Grafana 會根據資料集自動設定 Y 軸的範圍。

  當資料大多是平坦時，軟性最小值和軟性最大值設定可以防止彎折進入山區，而從標準最小和最大欄位選項衍生的硬性最小值或最大值可以防止間歇性峰值透過將峰值剪輯超過定義的點來扁平化有用的細節。

  您可以設定標準最小/最大選項來定義 Y 軸的硬性限制。

# 長條規
<a name="v9-panels-bar-gauge"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

長條圖會將每個欄位減少為單一值，以簡化您的資料。您可以選擇 Grafana 計算縮減的方式。

此面板可以顯示一或多個長條圖，取決於查詢傳回的序列、資料列或資料欄數量。

## 值選項
<a name="v9-panels-bar-gauge-value"></a>

使用下列選項來精簡視覺化顯示值的方式：

**顯示** – 選擇 Grafana 顯示資料的方式。

**計算** – 根據所有資料列顯示計算值。
+ **計算** – 選取 Grafana 將用於將許多欄位減少為單一值的縮減器函數。如需可用計算的清單，請參閱計算類型。
+ **欄位** – 選取面板中顯示的欄位。

**所有值** – 顯示每一列的個別統計資料。如果選取此選項，您也可以限制要顯示的列數。
+ **限制** – 要顯示的列數上限。預設為 5，000。
+ **欄位** – 選取面板中顯示的欄位。

## 長條規選項
<a name="v9-panels-bar-gauge-options"></a>

調整長條圖的顯示方式。

**方向** – 選擇堆疊方向。
+ **自動** – Grafana 會選取其認為的最佳方向。
+ **水平** – 橫條水平延伸，從左到右。
+ **垂直** – 橫條從下到上垂直延伸。

**顯示模式** – 選擇顯示模式。
+ **漸層** – 閾值層級定義漸層。
+ **舊式 LCD** – 量測計會分割成點亮或未點亮的小儲存格。
+ **基本** – 根據相符閾值的單一顏色。

**顯示未填充區域** – 如果您想要將長條的未填充區域轉譯為深灰色，請選取此選項。不適用於舊版 LCD 顯示器模式。

**最小寬度**

以垂直方向限制長條欄的最小寬度。

有大量資料時，自動顯示 x 軸捲軸。

**最小高度**

以水平方向限制長條列的最小高度。

有大量資料時，自動顯示 y 軸捲軸。

# Candlestick 面板
<a name="v9-panels-candlestick"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

Candlestick 面板可讓您將資料視覺化，其中包含許多專注於價格移動的一致維度。Candlestick 面板包含 Open-High-Low-Close (OHLC) 模式，以及根據時間序列資料支援其他維度。

Candlestick 面板以 為基礎，[時間序列面板](v9-panels-time-series.md)並包含許多常見的組態設定。

**Mode (模式)**

模式選項可讓您切換要用於視覺化的維度。
+ **蠟燭**會將面板維度限制為蠟燭視覺效果所使用的開啟、高、低和關閉維度。
+ **磁碟**區會將面板維度限制為磁碟區維度。
+ **兩者**都是蠟燭面板的預設行為。它包含蠟燭和磁碟區視覺化效果。

**蠟燭樣式**
+ **蠟燭**是預設的顯示樣式，可在開啟和關閉維度之間建立蠟燭樣式的視覺效果。
+ **OHLC 列**會顯示四個核心維度開放、高、低和關閉值。

**顏色策略**
+ **由於 Open** 是預設行為。如果期間內價格變動為正值，此模式將利用*上升*顏色 （下方）。換句話說，如果關閉時的值大於或等於開啟時的值，則會使用*上升*顏色。
+ **由於先前關閉**是一種替代顯示方法，其中蠟燭的顏色是根據期間間價格變動或價值變更而定。換言之，如果開啟時的值大於關閉時先前的值，則會使用*上升*顏色。如果開啟時的值低於關閉時先前的值，則會使用*向下*顏色。*此選項也會觸發空心蠟燭視覺化模式*。空心手杖表示期間內移動是正值 （值在接近開啟時高於值），填充的手杖表示期間內變更是負值 （值在接近開啟時低於值）。若要進一步了解，請參閱[差異的說明](https://thetradingbible.com/how-to-read-hollow-candlesticks)。

**上色和下色**

**上調顏色**和**下調顏色**選項會選取價格移動上調或下調時要使用的顏色。上述*顏色策略*將決定使用期間內或期間間價格移動來選取蠟燭或 OHLC 長條顏色。

**開啟、高、低、關閉**

蠟燭面板會嘗試將欄位映射至適當的維度。**開啟**、**高**、**低**和**關閉**選項可讓您在面板無法執行此操作時，將資料映射到這些維度。

**注意**  
這些值會從圖例中隱藏。
+ **Open** 對應至指定期間的起始值。
+ **高**對應至指定期間的最高值。
+ **低**對應至指定期間的最低值。
+ **關閉**對應至指定期間的最終 （結束） 值。
+ **磁碟區**對應至指定期間內的範例計數。（例如交易數量）

**其他欄位**

蠟燭面板是以時間序列面板為基礎。它可以視覺化開啟、高、低、關閉和磁碟區以外的其他資料維度 **包含**和**忽略**選項允許面板視覺化其他包含的資料，例如簡單的移動平均值、布林格帶等，使用 中可用的相同樣式和組態[時間序列面板](v9-panels-time-series.md)。

# Canvas 面板
<a name="v9-panels-canvas"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

Canvas 是一種新面板，結合了 Grafana 的強大功能與自訂元素的彈性。Canvas 視覺化是可擴展的表單建置面板，可讓您在靜態和動態配置中明確放置元素。這可讓您以無法使用標準 Grafana 面板的方式設計自訂視覺效果和浮水印資料，全部都在 Grafana 的 UI 內。如果您已使用熱門的 UI 和 Web 設計工具，設計 Canvas 面板將會非常熟悉。

## 元素
<a name="v9-panels-canvas-elements"></a>

**指標值**

指標值元素可讓您輕鬆選取要在畫布上顯示的資料。此元素具有唯一的「編輯」模式，可透過內容功能表「編輯」選項或按兩下來觸發。在編輯模式中，您可以選擇要顯示的欄位資料。

**Text (文字)**

文字元素可讓您輕鬆地將文字新增至畫布。元素也支援編輯模式，透過按兩下或內容選單中的編輯選單選項觸發。

**矩形**

矩形元素可讓您將基本矩形新增至畫布。矩形元素支援顯示文字 （固定和欄位資料），也可以根據資料閾值變更背景顏色。

**圖示**

圖示元素可讓您將支援的圖示新增至畫布。圖示可以根據閾值或值映射來設定顏色。

## Canvas 編輯
<a name="v9-panels-canvas-editing"></a>

**內嵌編輯器**

Canvas 推出新的編輯體驗。您現在可以在儀表板模式中編輯畫布面板內嵌。

**內容功能表**

內容選單可讓您存取常見任務。支援的功能包括開啟和關閉內嵌編輯器、複製 元素、刪除 元素等。

內容功能表是由面板上的右鍵動作或指定的畫布元素觸發。右鍵按一下面板時，您可以設定背景影像，並輕鬆將元素新增至畫布。

右鍵按一下 元素時，您可以編輯、刪除和複製元素，或修改元素的圖層定位。

## Canvas 選項
<a name="v9-panels-canvas-options"></a>

**內嵌編輯**

內嵌編輯切換可讓您鎖定或解除鎖定畫布面板。關閉畫布面板時，會*鎖定*並凍結元素，防止意外修改。

# 時鐘面板
<a name="v9-panels-clock"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

時鐘面板會顯示目前時間或倒數計時。它會每秒更新一次。
+ **模式** – 預設為**時間**。如果您選擇**倒數計時**，請將**倒數計時截止日期**設定為開始倒數計時。
+ **12 或 24 小時** – 顯示時間的選項為 12 小時格式和 24 小時格式。
+ **時區** – 時區由時刻時區程式庫提供。預設為電腦上的時區。
+ **倒數截止日期** – 如果您已將**模式**設定為**倒數**，請指定要倒數的時間和日期。
+ **倒數結束文字** – 指定倒數結束時要顯示的文字。
+ **日期/時間格式選項** – 自訂字型大小、權重和日期/時間格式。如果您顯示倒數計時，但不想看到秒刻度，請將 24 小時制的時間格式變更為 `hh:mm` ，而`h:mm A`將 12 小時制的時間格式變更為 。如需選項的完整清單，請參閱[顯示](https://momentjs.com/docs/#/displaying/)。
+ **Bg 顏色** – 選取時鐘的背景顏色。

# 儀表板清單
<a name="v9-panels-dashboard-list"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

儀表板清單視覺化可讓您顯示其他儀表板的動態連結。清單可以設定為使用星號儀表板、最近檢視的儀表板、搜尋查詢和儀表板標籤。

在每次儀表板載入時，此面板會查詢儀表板清單，並一律提供up-to-date結果。

**選項**

使用這些選項來精簡您的視覺化效果。
+ **星號** – 依字母順序顯示星號儀表板。
+ **最近檢視** – 依字母順序顯示最近檢視的儀表板。
+ **搜尋** – 依搜尋查詢或標籤顯示儀表板。您必須在**查詢**或**標籤**中至少輸入一個值。對於**查詢**和**標籤**欄位，支援變數插補，例如 `$my_var`或 `${my_var}`。
+ **顯示標題** – 所選清單選擇 （星星、最近檢視、搜尋） 會顯示為標題。
+ **項目上限** – 設定每個區段要列出的項目數量上限。例如，如果您將此值保留為預設值 10，並顯示 Starred 和最近檢視的儀表板，則面板最多會顯示 20 個儀表板，每個區段最多 10 個。

**搜尋**

這些選項只有在選取**搜尋**選項時才適用。
+ **查詢** – 輸入您要搜尋的查詢。查詢不區分大小寫，並接受部分值。
+ **資料夾** – 選取您要顯示的儀表板資料夾。
+ **標籤** – 以下是您要搜尋的標籤。現有的標籤不會顯示為您輸入，而且*區分*大小寫。

**注意**  
出現多個標籤和字串時，儀表板清單會顯示符合*所有*條件的標籤和字串。

# 量測計面板
<a name="v9-panels-gauge"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

計量是一種單一值視覺化，可以為每個序列、資料欄或資料列重複計量。

**值選項**

使用下列選項來精簡視覺化顯示值的方式：

**Show (顯示)**

選擇 Grafana 顯示資料的方式。

**計算**

顯示以所有資料列為基礎的計算值。
+ **計算** – 選取 Grafana 將用於將許多欄位減少為單一值的縮減器函數。如需可用計算的清單，請參閱 [計算類型](v9-panels-calculation-types.md)。
+ **欄位** – 選取要在面板中顯示的欄位。

**所有值**

顯示每一列的個別統計資料。如果選取此選項，您也可以限制要顯示的列數。
+ **限制** – 要顯示的列數上限。預設為 5，000。
+ **欄位** – 選取要在面板中顯示的欄位。

**量測計**

調整計量的顯示方式。
+ **顯示閾值標籤** – 控制是否顯示閾值。
+ **顯示閾值標記** – 控制閾值範圍是否顯示在內部指標值範圍之外。

**文字大小**

調整量測計文字的大小。
+ **標題** – 輸入計量標題大小的數值。
+ **值** – 輸入計量值大小的數值。

# Geomap 面板
<a name="v9-panels-geomap"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

Geomap 面板視覺化可讓您使用地理空間資料來檢視和自訂世界地圖。您可以設定各種浮水印樣式和地圖檢視設定，以輕鬆專注於資料的重要位置型特性。

## 地圖檢視
<a name="v9-panels-geomap-view"></a>

當儀表板載入時，地圖檢視會控制地圖的初始檢視。

**初始檢視**

初始檢視會設定第一次載入面板時 GeoMap 面板轉譯的方式。
+ **檢視**會在面板第一次載入時設定地圖的中心。
  + **適合資料** 根據映射層的資料範圍來調整映射檢視，並在資料變更時更新。
    + **資料**選項允許根據「所有圖層」、單一「圖層」或「最後一個值」從所選圖層的資料來選擇範圍。
    + 如果從圖**層**的單一「圖層」或「最後一個值」擬合資料，則可以選取圖層。
    + **填補**設定了超出資料範圍的相對百分比填補 （僅在查看「最後一個值」時不可用）。
    + **最大縮放**會在調整資料時設定最大縮放層級。
  + **座標**會根據下列項目設定地圖檢視：
    + **緯度**
    + **經度**
  + 預設檢視也可供使用，包括：
    + **(0°、0°)**
    + **北美洲**
    + **南美洲**
    + **歐洲**
    + **非洲**
    + **西亞**
    + **南亞**
    + **東南亞**
    + **東亞**
    + **澳洲**
    + **大洋洲**
+ **縮放**會設定初始縮放層級。

## 地圖層
<a name="v9-panels-geomap-layers"></a>

Geomap 視覺化支援顯示多個圖層。每個圖層都會決定如何在基礎地圖上方視覺化地理空間資料。

**類型**

在 Geomap 視覺化中，有三種地圖層類型可供選擇。
+ [標記圖層](#v9-panels-geomap-markers) 在每個資料點轉譯標記。
+ [熱度圖層](#v9-panels-geomap-heatmap) 視覺化資料的熱度圖。
+ [GeoJSON 層](#v9-panels-geomap-geojson) 會從 GeoJSON 檔案轉譯靜態資料。

目前還有五種層類型採用 Alpha。
+ [夜間/日間圖層 (Alpha)](#v9-panels-geomap-nightday) 會轉譯夜間或日間區域。
+ **最後一個點的圖示 (alpha)** 會在最後一個資料點轉譯圖示。
+ **動態 GeoJSON (alpha)** 會根據查詢結果來樣式 GeoJSON 檔案。
+ **Route (alpha)** 轉譯資料點做為路由。
+ [相片層 (Alpha)](#v9-panels-geomap-photos) 會在每個資料點轉譯相片。

**Layer 控制項**

圖層控制項可讓您建立圖層、變更其名稱、重新排序和刪除圖層。
+ **新增圖層**會為 Geomap 視覺化建立額外的可設定資料圖層。當您新增圖層時，系統會提示您選取圖層類型。您可以在面板組態期間隨時變更圖層類型。如需每個**圖層類型**的詳細資訊，請參閱上方的圖層類型一節。
+ 圖層控制項可讓您重新命名、刪除和重新排序面板的圖層。
  + **編輯圖層名稱** （鉛筆圖示） 會重新命名圖層。
  + **垃圾桶**會刪除 layer。
  + **重新排序** （六個點/抓取控點） 可讓您變更圖層順序。較高層上的資料會顯示在較低層上的資料上方。面板會在您拖放時更新圖層順序，以協助簡化選擇圖層順序。

您可以將多層資料新增至單一 Geomap 面板，以建立豐富且詳細的視覺化效果。

**位置**

Geomap 面板需要地理資料來源。此資料來自資料庫查詢，您的資料有四個映射選項。
+ **自動**搜尋位置資料。當您的查詢是以下列其中一個資料欄位名稱為基礎時，請使用此選項。
  + geohash：「geohash」
  + 緯度：「緯度」、「緯度」
  + 經度：「經度」、「lng」、「lon」
  + 查詢：「查詢」
+ **Coords** 指定您的查詢保留座標資料。系統會提示您從資料庫查詢中選取緯度和經度的數值資料欄位。
+ **Geohash** 指定您的查詢保留地理雜湊資料。系統會提示您從資料庫查詢中選取地理雜湊的字串資料欄位。
+ **查詢**指定您的查詢會保留需要對應至值的位置名稱資料。系統會提示您從資料庫查詢和 gazetteer 選取查詢欄位。Gazetteer 是用來將查詢資料映射至地理點的目錄。

## 標記圖層
<a name="v9-panels-geomap-markers"></a>

標記層可讓您將資料點顯示為不同的標記形狀，例如圓圈、方形、三角形、星星等。

標記有許多自訂選項。
+ **Marker Color** 會設定標記的顏色。預設值會將所有點`Single color`保留為單一顏色。根據資料點值和`Thresholds`區段中設定的閾值，有一個替代選項可以有多種顏色。
+ **Marker Size** 會設定標記的大小。預設值為 `Fixed size`，無論資料點為何，所有標記大小都相同。不過，也有選項可將圓圈擴展到對應的資料點。 `Min`和 `Max`標記大小必須設定，以便標記層可以在此範圍內擴展。
+ **Marker Shape** 可讓您選擇形狀、圖示或圖形，以協助為資料提供額外的視覺化內容。從 Grafana 隨附的資產中選擇，例如簡單形狀或 Unicon 程式庫。您也可以指定包含映像資產的 URL。影像必須是可擴展的向量圖形 (SVG)。
+ **填補不透明度**會設定每個標記的透明度。

## 熱度圖層
<a name="v9-panels-geomap-heatmap"></a>

熱度圖層叢集會建立各種資料點，以視覺化具有不同密度的位置。若要新增熱度圖層：

按一下 Data Layer 下的下拉式選單，然後選擇 `Heatmap`。

與 類似`Markers`，系統會提示您使用選項來決定要視覺化哪些資料點，以及如何視覺化這些資料點。
+ **權重值**會設定熱度圖叢集的強度。 會在所有資料點`Fixed value`中保持固定權重值。此值應介於 0\$11 的範圍內。與標記類似，下拉式清單中有一個替代選項，可根據資料值自動擴展權重值。
+ **Radius** 會設定熱度圖叢集的大小。
+ **Blur** 會設定每個叢集上的模糊程度。

## GeoJSON 層
<a name="v9-panels-geomap-geojson"></a>

GeoJSON layer 可讓您從檔案系統選取和載入靜態 GeoJSON 檔案。
+ **GeoJSON URL** 提供隨附於 Grafana 的 GeoJSON 檔案選擇。
+ **預設樣式**控制當以上規則不相符時要套用的樣式。
  + **顏色**設定預設樣式的顏色
  + **不透明度**設定預設不透明度
+ **樣式規則**會根據特徵屬性套用樣式
  + **規則**可讓您從 GeoJSON 檔案選取*功能*、*條件*和*值*，以定義規則。垃圾桶圖示可用來刪除目前的規則。
  + **顏色** 設定目前規則樣式的顏色
  + **不透明度**會設定目前規則的透明度層級
+ **新增樣式規則**會建立其他樣式規則。

## CARTO 層
<a name="v9-panels-geomap-carto"></a>

CARTO 層來自 [CARTO](https://carto.com/about-us/) Raster 基礎貼圖。

**選項**
+ **佈景主題**

   選擇**淺色**佈景主題、**深色**佈景主題或**自動**佈景主題。
+ **顯示標籤**會在地圖上方顯示國家/地區詳細資訊。
+ 從 0 （透明） 到 1 （不透明） 的**不透明度** 

## XYZ 並排圖層
<a name="v9-panels-geomap-xyz"></a>

XYZ 並排圖層是一般並排圖層的映射。

**注意**  
如需一般並排圖層的詳細資訊，請參閱[並排 Web Maps](https://en.wikipedia.org/wiki/Tiled_web_map) 和 [Open Street Map Tile Servers 的清單](https://wiki.openstreetmap.org/wiki/Tile_servers)。

**選項**
+ **URL 範本**
**注意**  
設定有效的並排伺服器 URL，例如 \$1z\$1/\$1x\$1/\$1y\$1：`https://tile.openstreetmap.org/{z}/{x}/{y}.png`。
+ 如果顯示在[地圖控制項](#v9-panels-geomap-controls)中，**屬性**會設定 layer 的參考字串
+ 從 0 （透明） 到 1 （不透明） 的**不透明度** 

## Open Street Map layer
<a name="v9-panels-geomap-osm"></a>

來自 [Open Street Map](https://www.openstreetmap.org/about) 的地圖，這是協作、免費的地理世界資料庫。

**選項**
+ 從 0 （透明） 到 1 （不透明） 的**不透明度** 

## ArcGIS 層
<a name="v9-panels-geomap-arcgis"></a>

[ArcGIS](https://services.arcgisonline.com/arcgis/rest/services) 層是來自 [ESRI](https://www.esri.com/en-us/about/about-esri/overview) ArcGIS MapServer 的層。

**選項**
+ 要從下列映射類型中選取的**伺服器執行個體**。
  + World Street 地圖
  + 世界影像
  + 世界實體
  + 地形
  + 美國地形
  + 世界海洋
  + 自訂 MapServer （請參閱 [XYZ](#v9-panels-geomap-xyz) 進行格式化）
    + URL 範本
    + 歸因
+ 從 0 （透明） 到 1 （不透明） 的**不透明度** 

## 夜間/日間圖層 (Alpha)
<a name="v9-panels-geomap-nightday"></a>

夜間/日間圖層會根據目前時間範圍顯示夜間和日間區域。

**注意**  
如需詳細資訊，請參閱[ OpenLayers - DayNight 的擴充](https://viglino.github.io/ol-ext/examples/layer/map.daynight.html)功能。

**選項**
+ **顯示**從面板時間範圍切換時間來源
+ **夜間區域顏色**會挑選夜間區域的顏色
+ **顯示太陽**切換太陽圖示
+ 從 0 （透明） 到 1 （不透明） 的**不透明度** 

## 相片層 (Alpha)
<a name="v9-panels-geomap-photos"></a>

Photos layer 會在每個資料點轉譯相片。

**注意**  
如需詳細資訊，請參閱 [ OpenLayers 的延伸模組 - 影像相片樣式](http://viglino.github.io/ol-ext/examples/style/map.style.photo.html)。

**選項**
+ **影像來源欄位**

  選取包含下列任一格式的影像資料的字串欄位：
  + **影像 URLs**
  + **Base64 編碼**影像二進位 (`data:image/png;base64,…`)
+ **類型**

   選取影像周圍的影格樣式
  + **平方**
  + **Circle (圓形)**
  + **錨定**
  + **Folio**
+ **裁剪**切換影像是否裁剪以符合
+ **Shadow** 切換影像後方的方塊陰影
+ **邊界**設定影像周圍的邊界大小
+ **邊界顏色**設定影像周圍的邊界顏色
+ **Radius** 設定影像的整體大小，以像素為單位

## 地圖控制項
<a name="v9-panels-geomap-controls"></a>

地圖控制界面包含下列地圖資訊和工具浮水印的選項。

**Zoom**

本節說明每個縮放控制項。

*顯示縮放控制*

在左上角顯示縮放控制項。

*滑鼠滾輪縮放*

使用滑鼠滾輪開啟或關閉以放大或縮小。

**顯示屬性**

在地圖上顯示基礎貼圖層的屬性。

**顯示擴展**

在左下角顯示比例資訊。

**注意**  
以 【m】/【km】 顯示單位。

**顯示度量工具**

在右上角顯示度量工具。只有當此控制項開啟時，才會顯示測量。
+ **按一下**以開始測量
+ **繼續按一下**以繼續測量
+ **按兩下**以結束測量

**注意**  
當您變更測量類型或單位時，先前的測量會從映射中移除。  
如果控制項已關閉，然後重新開啟，則會顯示最新的測量結果。  
您可以透過按一下並拖曳來修改測量。

*長度*

取得幾何的球形長度。此長度是座標之間大圓距離的總和。對於分段幾何，長度是每個部分的長度總和。幾何假設為「EPSG：3857」。

您可以選擇下列單位進行長度測量：
+ **指標 (m/km)**
+ **英尺 （英尺）**
+ **英里 （英里）**
+ **海事英里 (nmi)**

*Area*

取得幾何的球形區域。假設多邊形邊緣是球體上大圓的區段，則會計算此區域。幾何假設為「EPSG：3857」。

您可以選擇下列單位進行區域測量：
+ **平方公尺 (m2)**
+ **平方公里 (km2)**
+ **平方英呎 (ft2)**
+ **平方英里 (mi2)**
+ **英數 （英數）**
+ **公頃 (ha)**

**顯示除錯**

在地圖的右上角顯示偵錯資訊。這對於偵錯或驗證資料來源非常有用。
+ **縮放**會顯示地圖目前的縮放層級。
+ **中心**會顯示地圖中心的目前**經度**和**緯度**。

**Tooltip (工具提示)**
+ 只有在按一下資料點時，**才會**顯示工具提示。
+ 當指標停留在資料點上時，**詳細資訊**會顯示工具提示。

# 圖形面板
<a name="v9-panels-graph"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

圖形面板可以轉譯為線條、點路徑或一系列長條。這種圖形的多樣性足以顯示幾乎任何時間序列資料。

## 資料和欄位選項
<a name="v9-panels-graph-data-and-field-options"></a>

使用圖形視覺化時，您可以套用下列選項：
+  [轉換資料](v9-panels-xform.md) 
+ 提醒。這是唯一可讓您設定提醒的視覺化類型。如需詳細資訊，請參閱[Grafana 第 9 版中的提醒](v9-alerts.md)。
+  [設定閾值](v9-panels-configure-thresholds.md) 

## 顯示選項
<a name="v9-panels-graph-display-options"></a>

若要精簡視覺化效果，請使用下列設定：
+  **長條**圖 – 將值顯示為長條圖。
+  **行** – 將值顯示為折線圖。
+  **線條寬度** – 指定序列的線條寬度。預設為 1。
+  **樓梯** – 繪製相鄰點做為樓梯。
+  **區域填充** – 指定序列的顏色填充量。預設值為 1；0 為無。
+  **填充漸層** – 指定區域填充的漸層程度。預設值為 0，這不是漸層；10 是陡峭漸層。
+  **點** – 顯示值的點。
+  **點半徑** – 控制點的大小。
+  **警示閾值** – 在面板上顯示警示閾值和區域。

### 堆疊和 null 值
<a name="v9-panels-graph-stacking-and-null-value"></a>
+  **堆疊** – 每個序列都會堆疊在另一個序列上。
+  **百分比** – 每個序列繪製為所有序列總數的百分比。選取 **Stack** 時可使用此選項。
+  **Null 值** – 指定 Null 值的顯示方式。*這是重要的設定。*請參閱以下備註。
  +  **已連線** – 如果序列中有間隙，表示一或多個 null 值，則該行會略過間隙並連接到下一個非 Null 值。
  +  **Null** 如果序列中有間隙，表示 Null 值，則圖形中的線條會中斷並顯示間隙。這是預設設定。
  +  **Null 為零** – 如果序列中有間隙，表示 Null 值，則會在圖形面板中顯示為零值。

**重要**  
如果您正在監控伺服器的 CPU 負載，且負載達到 100%，伺服器將鎖定，且代理程式傳送統計資料將無法收集負載統計資料。這會導致指標出現差距，而使用預設*的 null* 設定表示 Amazon Managed Grafana 會顯示差距，並指出有問題。如果將此設定為*已連線*，則很容易錯過此訊號。

### 暫留工具提示
<a name="v9-panels-graph-hover-tooltip"></a>

使用這些設定來變更當您暫停圖形視覺化時出現的工具提示外觀。
+  **模式** – 決定暫留工具提示顯示的序列數量。
  +  **所有序列** – 暫留工具提示會顯示圖形中的所有序列。在工具提示的序列清單中，Grafana 工作區會以粗體反白顯示您要暫停的序列。
  +  **單一** – 暫留工具提示僅顯示單一序列，即您在圖形中暫停的序列。
+  **排序順序** – 如果您已選取**所有序列模式，則會排序暫留工具提示中的序列**順序。當您暫停圖形時，Amazon Managed Grafana 會顯示與線條相關聯的值。一般而言，使用者對最高或最低的值最感興趣。排序這些值可讓您輕鬆找到所需的資料。
  +  **無** – 工具提示中的序列順序取決於查詢中的排序順序。例如，您可以依序列名稱字母順序排序序列。
  +  **增加** – 暫留工具提示中的序列會依值和增加的順序排序，並將最低值放在清單頂端。
  +  **減少** – 暫留工具提示中的序列會依值排序，並依遞減順序排序，最高值位於清單頂端。

## 系列覆寫
<a name="v9-panels-graph-series-overrides"></a>

系列覆寫允許圖形面板中的序列與其他序列不同。您可以根據每個系列或使用 regex 規則來自訂顯示選項。例如，一個序列可以具有更粗的線條寬度，使其突出或移動到右側 Y 軸。

您可以新增多個序列覆寫。

**新增序列覆寫**

1. 選擇**新增系列覆寫**。

1. 在**別名或規則運算式**中，輸入或選取序列。選擇 欄位以查看可用序列的清單。

   例如， `/Network.*/` 會比對兩個名為 `Network out`和 的序列`Network in`。

1. 選擇 **\$1**，然後選擇要套用至序列的樣式。您可以為每個項目新增多個樣式。
+  **長條**圖 – 將序列顯示為長條圖。
+  **行** – 將序列顯示為折線圖。
+  **線條填充** – 顯示包含區域填充的線條圖。
+  **填充梯度** – 指定區域填充梯度量。
+  **線條寬度** – 設定線條寬度。
+  **Null 點模式** – 使用此選項可忽略 null 值，或將其取代為零。如果您想要忽略資料中的差距，這很重要。
+  **在下方填入 -** 填入兩個序列之間的區域。
+  **階梯線** – 將序列顯示為階梯線。
+  **破折號** – 顯示帶有破折號的行。
+  **隱藏序列** – 隱藏序列。
+  **Dash Length** – 設定行中的破折號長度。
+  **Dash Space** – 設定行中破折號之間的空間長度。
+  **點** – 將序列顯示為個別點。
+  **點半徑** – 設定點轉譯的半徑。
+  **堆疊** – 設定系列的堆疊群組。
+  **顏色** – 設定系列顏色。
+  **Y 軸** – 設定序列 y 軸。
+  **Z-index** – 設定序列 z-index （轉譯順序）。當您疊加不同的樣式時，此選項很重要，例如長條圖和區域圖。
+  轉換 – 將值轉換為負值，以在 y 軸下方轉譯。
+  **圖例** – 控制序列是否顯示在圖例中。
+  **隱藏工具提示** – 控制是否在圖形工具提示中顯示序列。

## Axes (軸)
<a name="v9-panels-graph-axes"></a>

使用這些選項來控制視覺化中軸的顯示。

### 左 Y/右 Y
<a name="v9-panels-graph-left-yright-y"></a>

兩個 y 軸的選項相同。
+  **顯示** – 選擇顯示或隱藏軸。
+  **單位** – 選擇 y 值的顯示單位。
+  **縮放** – 選擇要用於 y 值的縮放：**線性**或**對數**。預設值為**線性**。
+  **Y-Min** – 最小 y 值。預設值為**自動**。
+  **Y-Max** – Y 值上限。預設值為**自動**。
+  **小數** – 定義 y 值顯示多少小數。預設值為**自動**。
+  **Label** – 指定 y 軸標籤。預設值為「」，

### Y 軸
<a name="v9-panels-graph-y-axes"></a>
+  **對齊** – 依值對齊左右 y 軸。預設值為 unchecked/false。
+  **關**卡 – 輸入要用於對齊左右 y 軸的值，從 Y=0 開始。預設值為 0。選取 **Align** 時可使用此選項。

### X 軸
<a name="v9-panels-graph-x-axis"></a>
+  **顯示** – 選擇顯示或隱藏軸。
+  **模式** – 顯示模式會完全變更圖形面板的視覺化效果。它就像三個面板合而為一。主要模式是時間序列模式與 x 軸上的時間。其他兩種模式是基本長條圖模式，其中系列位於 x 軸上，而不是時間和長條圖模式。
  +  **時間** （預設） – x 軸代表時間，資料會依時間 （例如，依小時或分鐘） 分組。
  +  **系列** – 資料依系列分組，而非依時間分組。y 軸仍然代表 值。
    +  **值** – 這是用於值的彙總類型。預設值為**總計** （將值加總）。
  +  **直方圖** – 此選項會將圖形轉換為直方圖。長條圖是一種長條圖，可將數字分組到範圍內，通常稱為儲存貯體或儲存貯體。Taller 長條顯示有更多資料落在該範圍內。

    如需長條圖的詳細資訊，請參閱 [直方圖和熱度圖簡介](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps)。
    +  **儲存貯**體 – 設定值分組依據的儲存貯體數量。如果保留空白，Amazon Managed Grafana 會嘗試計算適當的儲存貯體數量。
    +  **X-Min** – 從小於此下限的長條圖篩選出值。
    +  **X-Max** – 篩選出大於此上限的值。

## 圖例
<a name="v9-panels-graph-legend"></a>

使用這些設定來精簡圖例在視覺化中的顯示方式。

### 選項
<a name="v9-panels-graph-legends-options"></a>
+  **顯示** – 清除以隱藏圖例。已選取預設值 (true)。
+  **做為資料表** – 選取 以在資料表中顯示圖例。已檢查預設值 (true)。
+  **右側** – 選取 以在右側顯示圖例。
+  寬度 – 輸入以像素為單位的圖例最小寬度。選取**向右**時可使用此選項。

### 值
<a name="v9-panels-graph-values"></a>

其他值可以與圖例名稱一起顯示。
+  **最小值** – 從指標查詢傳回的最小值。
+  **Max** – 從指標查詢傳回的最大值。
+  **Avg** – 從指標查詢傳回的平均值。
+  **目前** – 從指標查詢傳回的最後一個值。
+  **總計** – 從指標查詢傳回的所有值總和。
+  **小數位數** – 圖例值和圖形暫留工具提示會顯示多少小數位數。

Amazon Managed Grafana 會計算用戶端的圖例值。這些圖例值取決於指標查詢正在使用的彙總或點合併類型。上述所有圖例值不能同時正確。

例如，如果您繪製此類請求的速率/秒，這可能是使用平均值做為彙總工具，則圖例中的總計不會代表請求的總數。這只是 Amazon Managed Grafana 收到的所有資料點的總和。

### 隱藏系列
<a name="v9-panels-graph-hide-series"></a>

當指標查詢中序列的所有值都是特定值時，隱藏序列。
+  **只有 null –** Value=null （預設未勾選）
+  **只有零** – Value=zero （預設未勾選）

### 時間區域
<a name="v9-panels-graph-time-regions"></a>

您可以在圖表上反白特定時區，以便更輕鬆地查看，例如週末、上班時間和下班時間。所有設定的時區都是指 UTC 時間。

# 熱度圖面板
<a name="v9-panels-heatmap"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

Heatmap 面板視覺化可讓您檢視一段時間內的長條圖。如需長條圖的詳細資訊，請參閱 [直方圖和熱度圖簡介](getting-started-grafanaui.md#introduction-to-histograms-and-heatmaps)。

## 從資料計算
<a name="v9-panels-heatmap-calculate"></a>

此設定會判斷資料是否已是計算的熱度圖 （來自資料來源/轉換器），還是應該在面板中計算的熱度圖。

**X 儲存貯體**

此設定決定 X 軸如何分割為儲存貯體。您可以在**大小**輸入中指定時間間隔。例如， 的時間範圍`1h`會使 X 軸上的儲存格變寬 1 小時。

**Y 儲存貯體**

此設定決定如何將 Y 軸分割為儲存貯體。

**Y 儲存貯體擴展**

選取下列其中一個 Y 軸值比例：
+ **線性** – 線性擴展。
+ **log （基礎 2)** – 使用基礎 2 進行對數擴展。
+ **log (base 10)** – 以 base 10 進行對數擴展。

## Y 軸
<a name="v9-panels-heatmap-y-axes"></a>

定義 Y 軸的顯示方式

 **配置**
+ **左側** – 在左側
+ **右側** – 在右側
+ **隱藏** – 隱藏

**單位**

單位組態

**小數位數**

此設定會決定十進位組態。

**最小值/最大值**

此設定會設定軸範圍。

**反向**

選取時，軸會以相反順序顯示。

## 顏色
<a name="v9-panels-heatmap-colors"></a>

顏色光譜控制值計數 （在每個儲存貯體中） 與指派給每個儲存貯體的顏色之間的映射。光譜上最左邊的顏色代表最小計數，而右邊的顏色代表最大計數。某些顏色方案在使用光線佈景主題時會自動反轉。

您也可以將顏色模式變更為不透明度。在此情況下，顏色不會變更，但不透明度量會隨著儲存貯體計數而變更
+ **Mode (模式)**
  + **結構描述** – 由儲存格顏色表示的儲存貯體值。
    + **結構描述** – 如果模式是**結構描述**，則選取顏色結構描述。
  + **不透明度** – 由儲存格不透明度表示的儲存貯體值。不透明儲存格表示最大值。
    + **顏色** – 儲存格基底顏色。
    + **縮放** – 將儲存貯體值映射至不透明度的縮放。
      + **線性** – 線性縮放。儲存貯體值會線性映射至不透明度。
      + **sqrt** – 功率擴展。儲存格不透明度計算為 `value ^ k`，其中 `k`是設定的**指數**值。如果指數小於 `1`，您會收到對數縮放。如果指數大於 `1`，您會收到指數擴展。如果是 `1`，擴展將與線性相同。
    + **指數** – 指數的值，大於 `0`。

**從值開始/結束顏色**

根據預設，Grafana 會根據最小和最大儲存貯體值來計算儲存格顏色。使用 Min 和 Max，您可以覆寫這些值。將儲存貯體值分別視為 Z 軸，將最小值和最大值分別視為 Z-Min 和 Z-Max。
+ **Start** – 使用 計算儲存格顏色的最小值。如果儲存貯體值小於最小值，則會映射到「最小值」顏色。系列最小值是預設值。
+ **結束** – 使用 計算儲存格顏色的最大值。如果儲存貯體值大於最大值，則會映射到「最大值」顏色。系列最大值是預設值。

## 儲存格顯示
<a name="v9-panels-heatmap-cell"></a>

使用儲存格顯示設定來精簡熱度圖中儲存格的視覺化效果。

## 其他顯示選項
<a name="v9-panels-heatmap-options"></a>

**Tooltip (工具提示)**
+ **顯示工具提示** – 顯示熱度圖工具提示。
+ **顯示直方圖** – 在工具提示上顯示 Y 軸直方圖。直方圖代表特定時間戳記的儲存貯體值分佈。

**圖例**

選擇是否要在視覺效果上顯示熱度圖圖例。

**範例**

設定用來顯示範例資料的顏色。

# 直方圖面板
<a name="v9-panels-histogram"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

長條圖視覺化會計算值的分佈，並將其呈現為長條圖。Y 軸和每個長條的高度代表落在每個括號中的值計數，而 X 軸代表值範圍。

直方圖視覺化支援具有一或多個數值欄位的時間序列和任何資料表結果。

## 支援的格式
<a name="v9-panels-histogram-formats"></a>

直方圖視覺化支援具有一或多個數值欄位的時間序列和任何資料表結果。

## 顯示選項
<a name="v9-panels-histogram-options"></a>

使用這些選項來精簡您的視覺化效果：

**儲存貯體大小**

儲存貯體的大小。對於自動調整儲存貯體大小 （約完整範圍的 10%)，請保留此空白。

**儲存貯體位移**

如果第一個儲存貯體不應從零開始。非零位移會轉移彙總視窗。例如，大小為 0–5、5–10、10–15 且預設偏移量為 0 的 5 個儲存貯體會變成 2–7、7–12、12–17，偏移量為 2；在此情況下，偏移量為 0、5 或 10 實際上不會執行任何動作。一般而言，此選項會與明確定義的儲存貯體大小搭配使用，而不是自動。若要讓此設定生效，偏移量應大於 0 且小於儲存貯體大小；超出此範圍的值將與此範圍內的值具有相同的效果。

**合併序列**

這會將所有序列和欄位合併為合併的長條圖。

**線條寬度**控制長條的線條寬度。

**填充不透明度**控制長條的填充不透明度。

**漸層模式**會設定漸層填充的模式。填充漸層是根據線條顏色。若要變更顏色，請使用標準顏色方案欄位選項。漸層外觀會受到填滿不透明度設定的影響。
+  **無 ** – 無漸層填充，這是預設設定。
+  **不透明度** – 漸層的透明度是根據 Y 軸上的值計算。填充的不透明度隨著 Y 軸上的值而增加。
+  **Hue** – 根據線條顏色的色調產生漸層顏色。

**工具提示模式** 當您將游標暫留在圖形上時，Grafana 可以顯示工具提示。選擇工具提示的行為方式：
+  **單一** – 暫留工具提示只會顯示您要暫留的序列。
+  **全部** – 暫留工具提示會顯示視覺效果中的所有序列。Grafana 會反白顯示您在工具提示的序列清單中以粗體暫留的序列。
+  **隱藏** – 請勿顯示工具提示。

**注意**  
使用覆寫從工具提示中隱藏個別序列。

## 圖例選項
<a name="v9-panels-histogram-legend"></a>

啟用圖例選項時，可以顯示值映射或閾值括號。若要在圖例中顯示值映射，請務必將標準選項下的色彩配置選項設定為單一顏色或傳統調色盤。若要查看圖例中的閾值括號，請將顏色方案設定為從閾值。

**圖例模式** 使用這些設定來精簡圖例在視覺化中的顯示方式。
+  **清單 ** – 將圖例顯示為清單。這是圖例的預設顯示模式。
+  **資料表** – 將圖例顯示為資料表。
+  **隱藏** – 隱藏圖例。

**圖例放置** 選擇放置圖例的位置。
+  **底部 ** – 圖表下方。
+  **右側** – 圖形右側。

**圖例值**

選擇要在圖例中顯示的標準計算。您可以有多個 。如需詳細資訊，請參閱[計算類型](v9-panels-calculation-types.md)。

**圖例計算**

選擇要在圖例中顯示的計算。您可以選取多個。

# 日誌面板
<a name="v9-panels-logs"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

日誌面板視覺化顯示來自支援日誌之資料來源的日誌行，例如 Elastic、Influx 和 Loki。一般而言，您會在圖形面板旁使用此面板來顯示相關程序的日誌輸出。

日誌面板會顯示在查詢索引標籤上輸入的**查詢**結果。多個查詢的結果會合併並依時間排序。如果資料來源傳回的行數超過可顯示的行數，您可以在面板內捲動。

若要限制轉譯的行數，您可以使用**查詢選項**中的**最大資料點**設定。如果未設定，資料來源通常會強制執行預設限制。

## 日誌層級
<a name="v9-panels-logs-level"></a>

對於指定**關**卡標籤的日誌，我們使用標籤的值來確定日誌關卡並相應地更新顏色。如果日誌未指定關卡標籤，我們會嘗試查明其內容是否符合任何支援的表達式 （如需詳細資訊，請參閱下方）。日誌層級一律由第一個相符項目決定。如果 Grafana 無法判斷日誌層級，則會使用**未知**的日誌層級將其視覺化。如需詳細資訊，請參閱[記錄視覺化](v9-explore-logs.md#v9-explore-logs-viz)。

## 日誌詳細資訊
<a name="v9-panels-logs-details"></a>

每個日誌列都有一個可擴展的區域，其中包含其標籤和偵測到的欄位，以進行更強大的互動。每個欄位或標籤都有一個統計資料圖示，可顯示與所有顯示日誌相關的統計資料。

**資料連結**

透過使用資料連結，您可以將日誌訊息的任何部分轉換為內部或外部連結。建立的連結會在**日誌詳細資訊**檢視內的**連結**區段中顯示為按鈕。

**顯示選項**

使用下列設定來精簡您的視覺化效果：
+  **時間** – 顯示或隱藏時間欄。這是從資料來源回報的與日誌行相關聯的時間戳記。
+  **唯一標籤** – 顯示或隱藏唯一標籤欄，只顯示非常見標籤。
+ **一般標籤** – 顯示或隱藏一般標籤
+  **包裝線** – 切換包裝線。
+ **Prettify JSON** – 將此設為 `true`可列印所有 JSON 日誌。此設定不會影響 JSON 以外的任何格式日誌。
+ **啟用日誌詳細資訊** – 切換選項以查看每個日誌資料列的日誌詳細資訊檢視。預設設定為 `true`。
+  **順序** – 以遞減或遞增時間順序顯示結果。預設值為**遞減**，首先顯示最新的日誌。設定為**遞增**以先顯示最舊的日誌行。

# 新聞面板
<a name="v9-panels-news"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

此面板會顯示 RSS 摘要。根據預設，它會顯示來自 Grafana 實驗室部落格的文章。

在**顯示**區段中輸入 RSS 的 URL。此面板類型不接受任何其他查詢。

**注意**  
RSS 摘要由 Grafana 前端載入，無需代理。因此，只會載入使用適當 [CORS 標頭設定的 ](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS)RSS 摘要。如果您嘗試顯示的 RSS 摘要無法載入，請考慮重新託管 RSS 摘要或建立您自己的代理。

# 節點圖形面板
<a name="v9-panels-node-graph"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

節點圖形面板會將導向圖形或網路視覺化。它使用導向力配置來有效地定位節點，以便協助顯示複雜的基礎設施地圖、階層或執行圖表。

## 資料要求
<a name="v9-panels-node-graph-requirements"></a>

節點圖形面板需要特定形狀的資料，才能顯示其節點和邊緣。並非所有資料來源或查詢都可以在此面板中視覺化。

節點圖形視覺化包含*節點*和*邊緣*。
+ *節點*會顯示為圓圈。從應用程式角度來看，節點可能代表應用程式、服務或任何其他相關項目。
+ *邊緣*顯示為連接兩個節點的行。連線可能是請求、 操作或兩個節點之間的一些其他關係。

節點和邊緣都可以有相關聯的中繼資料或統計資料。資料來源定義顯示哪些資訊和值，因此不同的資料來源可以顯示不同類型的值或不顯示某些值。

## 節點
<a name="v9-panels-node-graph-nodes"></a>

通常，節點會在節點內顯示兩個統計值，並在節點正下方顯示兩個識別符，通常是名稱和類型。節點也可以將另一組值顯示為節點周圍的顏色圓圈，不同顏色的區段代表應增加到 1 的不同值。例如，您可以擁有由圓圈紅色部分表示的錯誤百分比。

其他詳細資訊可以顯示在內容選單中，當您選擇節點時會顯示。內容功能表中也可以有其他連結，可以鎖定 Grafana 工作區的其他部分或任何外部連結。

**注意**  
節點圖形只能顯示 1，500 個節點。如果超過此限制，則會在右上角顯示警告，而且某些節點將會隱藏。您可以按一下圖形中的**隱藏節點**標記來展開圖形的隱藏部分。

## Edges (邊)
<a name="v9-panels-node-graph-edges"></a>

當您將游標暫留在邊緣上時，邊緣也可以顯示統計資料。與節點類似，您可以透過選擇邊緣來開啟內容選單，其中包含其他詳細資訊和連結。

支援此視覺化的第一個資料來源是其服務映射功能的 AWS X-Ray 資料來源。如需詳細資訊，請參閱[連線至 AWS X-Ray 資料來源](x-ray-data-source.md)。

## 導覽節點圖形
<a name="v9-panels-node-graph-navigation"></a>

您可以在任何節點或邊緣之外選擇並拖曳指標，以在節點圖形內平移。

您可以使用節點圖形左上角的按鈕來縮放。

**隱藏節點**

在特定時間顯示的節點數量受到限制，以維持合理的效能。超出此限制的節點會隱藏在可點選標記後方，顯示連線到該邊緣的隱藏節點的大致數量。您可以選擇標記來展開該節點周圍的圖形。

**網格檢視**

您可以切換到網格檢視，以更清楚地了解圖形中最有趣的節點。網格檢視會顯示網格中沒有邊緣的節點，並可依節點內顯示的統計資料或節點彩色邊界表示的統計資料進行排序。

若要排序節點，請選擇圖例中的統計資料。統計資料名稱旁的標記會顯示目前用於排序和排序方向的統計資料。

選擇節點，然後選擇**在圖形中顯示配置**選項，以切換回聚焦於所選節點的圖形配置，以在完整圖形的內容中顯示。

## Data API (資料 API)
<a name="v9-panels-node-graph-data-api"></a>

此視覺化需要從資料來源傳回特定形狀的資料，才能正確顯示資料。

Node Graph 至少需要描述圖形邊緣的資料框架。根據預設，節點圖形會根據此資料框架計算節點和任何統計資料。或者，如果需要顯示更多節點特定的中繼資料，則可以傳送描述節點的第二個資料框架。您必須同時在資料影格`frame.meta.preferredVisualisationType = 'nodeGraph'`上設定資料影格或為其命名`nodes`，並`edges`分別設定它們，節點圖形才能轉譯。

**來自結構的邊緣資料**

必要欄位：


| 欄位名稱 | Type | 說明 | 
| --- | --- | --- | 
|  id  |  string  |  邊緣的唯一識別符。  | 
|  source  |  string  |  來源節點的 ID。  | 
|  目標  |  string  |  目標的 ID。  | 

選用欄位：


| 欄位名稱 | Type | 說明 | 
| --- | --- | --- | 
|  mainstat  |  string/number  |  將游標暫留在邊緣上時，浮水印中顯示的第一個統計資料。它可以是顯示值為原狀的字串，也可以是數字。如果是數字，也會顯示與該欄位相關聯的任何單位  | 
|  secondarystat  |  string/number  |  與 mainStat 相同，但會顯示在其下方。  | 
|  detail\$1\$1\$1  |  string/number  |  按一下邊緣時，任何字首為 的欄位`detail__`都會顯示在內容選單的標頭中。`config.displayName` 用於更人類可讀的標籤。  | 

**來自結構的節點資料**

必要欄位：


| 欄位名稱 | Type | 說明 | 
| --- | --- | --- | 
|  id  |  string  |  節點的唯一識別符。此 ID 由來源和目標欄位中的邊緣參考。  | 

選用欄位：


| 欄位名稱 | Type | 說明 | 
| --- | --- | --- | 
|  標題  |  string  |  在節點下方可見的節點名稱。  | 
|  字幕  |  string  |  標題下顯示的其他、名稱、類型或其他識別符。  | 
|  mainstat  |  string/number  |  第一個顯示在節點本身內的統計資料。它可以是顯示原狀值的字串或數字。如果是數字，也會顯示與該欄位相關聯的任何單位。  | 
|  secondarystat  |  string/number  |  與 mainStat 相同，但會顯示在節點內。  | 
|  arc\$1\$1\$1  |  number  |  任何字首為 的欄位`arc__`都會用來在節點周圍建立顏色圓圈。這些欄位中的所有值最多應加 1。您可以使用 指定顏色`config.color.fixedColor`。  | 
|  detail\$1\$1\$1  |  string/number  |  按一下節點時，任何字首為 的欄位`detail__`都會顯示在內容選單的標頭中。`config.displayName` 用於更多人類可讀的標籤。  | 

# 圓餅圖面板
<a name="v9-panels-piechart"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

圓餅圖會以圓餅的配量形式顯示一個或多個查詢中減少的序列或值，因為它們彼此相關。配量的電弧長度、區域和中央角度都與配量值成正比，因為它與所有值的總和相關。當您想要以美術取捨的形式快速比較一小組值時，最適合使用此類型的圖表。

## 值選項
<a name="v9-panels-piechart-value"></a>

使用下列選項來精簡視覺化中的值。

**Show (顯示)**

選擇要顯示多少資訊。
+ **計算** – 將每個值減少為每個序列的單一值。
+ **所有值** – 顯示單一系列中的每個值。

**計算**

選取計算，以在選取計算時減少每個序列。如需可用計算的資訊，請參閱[計算類型](v9-panels-calculation-types.md)。

**限制**

顯示單一系列中的每個值時，這會限制顯示的值數目。

**欄位**

選取要在視覺效果中顯示的欄位。清單中有每個欄位名稱，您也可以選取下列其中一個選項：
+ **數值欄位** – 具有數值的所有欄位。
+ **所有欄位** – 轉換未移除的所有欄位。
+ **時間** – 具有時間值的所有欄位。

## 圓餅圖選項
<a name="v9-panels-piechart-options"></a>

使用這些選項來精簡視覺化的外觀。

**圓餅圖類型**

選取圓餅圖顯示樣式。可以是：
+ **圓餅**圖 – 標準圓餅圖
+ **Donut** – 在中間有一個洞的圓餅圖

**標籤**

選取要顯示在圓餅圖上的標籤。您可以選取多個。
+ **名稱** – 系列或欄位名稱。
+ **百分比** – 整體的百分比。
+ **值** – 原始數值。

根據預設，標籤會以白色顯示在圖表內文上。您可以選取較深的圖表顏色，讓它們更可見。可能會裁剪長名稱或數字。

**工具提示模式**

當您將游標暫留在視覺化效果上時，Grafana 可以顯示工具提示。選擇工具提示的行為方式。
+ **單一** – 暫留工具提示只會顯示單一序列，也就是您要暫留在視覺化效果上的序列。
+ **全部** – 暫留工具提示會顯示視覺化中的所有序列。Grafana 會反白您在工具提示的序列清單中以粗體懸停的序列。
+ **隱藏** – 當您與視覺化互動時，請勿顯示工具提示。

使用覆寫來隱藏工具提示中的個別序列。

**圖例模式**

使用這些設定來定義圖例在視覺效果中的顯示方式。如需圖例的詳細資訊，請參閱[設定圖例](v9-panels-configure-legend.md)。
+ **清單** – 將圖例顯示為清單。這是圖例的預設顯示模式。
+ **資料表** – 將圖例顯示為資料表。
+ **隱藏** – 隱藏圖例。

**圖例置放**

選擇要顯示圖例的位置。
+ **底部** – 圖表下方。
+ **右側** – 圖形右側。

**圖例值**

選擇要在圖例中顯示的標準[計算](v9-panels-calculation-types.md)。您可以有多個 。

選取要在圖例中顯示的值。您可以選取多個。
+ **百分比** – 整體的百分比。
+ **值** – 原始數值。

如需圖例的詳細資訊，請參閱[設定圖例](v9-panels-configure-legend.md)。

# Plotly 面板
<a name="v9-panels-plotly"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

Plotly 面板使用 [Plotly 轉譯圖表，Plotly](https://plotly.com/javascript/) 是一種開放原始碼 Javascript 圖形庫。

**資料**、**配置**和**組態**欄位符合 [Plotly 文件](https://plotly.com/javascript/plotlyjs-function-reference/)中所述的常見參數。它們必須是 JSON 格式。

資料來源提供的資料可以透過使用者定義的指令碼進行轉換，之後才能注入圖表中。指令碼包含 2 個引數。
+ `data` – 資料來源傳回的資料。
+ `variables` – 在目前儀表板中包含 [Grafana 變數](templates-and-variables.md)的物件 （使用者變數和以下幾個全域變數：`__from`、`__interval`、 `__to`和 `__interval_ms`)。

指令碼必須傳回具有下列一或多個屬性的物件：`data`、 `layout``config`和 `frames`。下列是 範例。

```
let x  = data.series[0].fields[0].values.buffer
let y  = data.series[0].fields[1].values.buffer
let serie = {
    x : x,
    y : y,
    name : variables.project //where project is the name of a Grafana’s variable
}

return {
    data : [serie],
    config : {
    displayModeBar: false
    }
}
```

由指令碼傳回的物件和*資料*、*配置*和*組態*欄位中提供的 JSON 將會合併 （深度合併）。

如果未提供指令碼，面板只會使用*資料*、*配置*和*組態*欄位。

# Sankey 面板
<a name="v9-panels-sankey"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

Sankey 面板顯示桑基圖，這有利於視覺化流程資料，流程的寬度與選取的指標成比例。下圖顯示具有兩組來源和目的地的桑基圖。

![\[Sankey diagram showing flow between source organizations, science disciplines, and projects.\]](http://docs.aws.amazon.com/zh_tw/grafana/latest/userguide/images/sankey-panel.png)


**運作方式**

sankey 面板需要至少 2 欄的資料，即流程的來源和目的地。您的查詢應將您的資料分組為至少兩個群組。面板會依查詢順序，從資料點的第一欄繪製到最後一欄的連結。連結的厚度將與查詢中指標指派的值成正比。

**自訂**
+ **連結** – 連結顏色目前有兩種選項：多重或單一。預設為彩色。若要為連結選擇單一顏色，請切換**僅單一連結顏色**選項，然後從 Grafana 的顏色挑選器中選擇您的顏色。
+ **節點** – 您可以透過變更節點顏色選項來變更矩形節點**的顏色** 
+ **Node Width** – 可以使用 **Node Width** 滑桿調整節點的寬度，或在輸入方塊中輸入數字。此數字必須是整數。
+ **Node Padding** – 可以使用 **Node Padding** 滑桿或在輸入方塊中輸入數字來調整節點之間的垂直填補。此數字必須是整數。如果您的連結太薄，請嘗試調整此數字
+ **標頭** – 您可以使用編輯器面板中的**顯示名稱**覆寫來變更欄標頭。它們將與您為**文字**顏色選擇的顏色相同
+ **Sankey 配置** – 可使用配置**反覆運算滑桿稍微調整 Sankey 連結的配置**。此數字必須是整數，並且是用來產生配置的弛緩反覆運算數量。

# 散佈面板
<a name="v9-panels-scatter"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

散佈面板顯示資料表資料的 X/Y 散佈圖，其界面比其他圖形面板更簡單。與圖形面板不同，散佈面板不需要資料處於時間序列中。散佈面板需要資料表格式的資料集，其中包含兩個或多個數值資料欄。

其中一個可以指派給 X 軸。一個或多個 可以指派給一系列的 Y 軸值，並將產生的資料繪製為一系列的點。每個序列也可以選擇使用多種統計最佳擬合的其中一個來顯示迴歸線。

**建立散佈面板**

下列程序說明如何使用散佈面板建立散佈圖。在此範例中，我們將假設有資料，如下表所示`HEIGHT`，包含三個數值資料欄 `Age`、 `Boys`和 `Girls`，顯示依年齡區分的男生和女生平均高度。


| 年齡 | Boy 的高度 | 女生的高度 | 
| --- | --- | --- | 
|  5  |  109.7  |  109.5  | 
|  6  |  115.6  |  115.4  | 
|  7  |  121.1  |  120.8  | 
|  8  |  126.3  |  126  | 
|  9  |  131.3  |  131.3  | 
|  10  |  136.2  |  137.1  | 
|  11  |  141.2  |  143.2  | 
|  12  |  147  |  148.7  | 
|  13  |  153.6  |  152.6  | 
|  14  |  159.9  |  155.1  | 
|  15  |  164.4  |  156.7  | 
|  16  |  167.3  |  157.6  | 
|  17  |  169  |  158  | 
|  18  |  170  |  158.3  | 
|  19  |  170.8  |  158.6  | 

**使用散佈面板建立散佈圖**

1. 在 Grafana 儀表板中，選擇**新增面板**。

1. 針對查詢，撰寫將傳回所需資料的查詢。在這種情況下，您會使用 之類的查詢`SELECT * FROM HEIGHT`。

1. 選取**散佈**視覺效果。

這會建立散佈圖，使用第一欄做為 X 軸，其他數值欄則做為 Y 軸。

**組態選項**

散佈面板提供下列四個自訂組態選項。
+ **X 軸** – 您可以選擇要使用哪個欄位做為 X 軸，以及軸的範圍、標題和顯示資訊。
+ **Y 軸** – 您可以選擇要在 Y 軸上顯示的欄位，包括每個欄位的顯示選項，以及軸的範圍和標題資訊。您也可以選擇顯示每個欄位的迴歸線。如需迴歸線組態的詳細資訊，請參閱下列資訊。
+ **圖例** – 您可以開啟或關閉面板的圖例，以及選擇圖例中文字的大小。
+ **顯示** – 您可以設定圖表的其他選項，包括網格顏色和邊界樣式。

**迴歸線組態**

除了個別點之外，每個 Y 軸資料集還可以顯示一條線。行類型有五個選項。
+ **無** – 請勿顯示迴歸線。
+ **簡單** – 顯示連接資料集點的迴歸線。
+ **線性** – 使用最小平方的最佳擬合方法顯示直線。
+ **指數** – 顯示指數最佳擬合迴歸線。
+ **功率** – 顯示功率最佳擬合迴歸線。

# Stat 面板
<a name="v9-panels-stat"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

Stat 面板視覺化會顯示一個大型 stat 值，以及選用的圖形閃爍線。您可以使用閾值控制背景或值顏色。

根據預設，Stat 面板會顯示下列其中一項：
+ 只是單一序列或欄位的值。
+ 多個序列或欄位的值和名稱。

您可以使用**文字模式**來控制文字是否顯示。

## 自動配置調整
<a name="v9-panels-stat-automatic-adjust"></a>

面板會根據儀表板中可用的寬度和高度自動調整配置。如果面板變得太小，它會自動隱藏圖形 （閃爍）。

## 值選項
<a name="v9-panels-stat-value"></a>

使用下列選項來精簡視覺化顯示值的方式：

**Show (顯示)**

選擇 Grafana 顯示資料的方式。

**計算**

顯示以所有資料列為基礎的計算值。
+ **計算** – 選取 Grafana 將用於將許多欄位減少為單一值的減少程式函數。如需可用計算的清單，請參閱[標準計算](v9-panels-calculation-types.md)。
+ **欄位** – 選取面板中顯示的欄位。

**所有值**

顯示每一列的個別統計資料。如果選取此選項，您也可以限制要顯示的列數。
+ **限制** – 要顯示的列數上限。預設為 5，000。
+ **欄位** – 選取面板中顯示的欄位。

## Stat 樣式
<a name="v9-panels-stat-styles"></a>

調整視覺化效果的樣式。

**Orientation (方向)**

選擇堆疊方向。
+ **自動** – Grafana 會選取其認為的最佳方向。
+ **水平** – 橫條水平延伸，從左到右。
+ **垂直** – 橫條從上到下垂直延伸。

**文字模式**

您可以使用文字模式選項來控制面板轉譯的文字。如果值不重要，只有名稱和顏色是 ，則將**文字模式**變更為**名稱**。該值仍會用於判斷顏色，並顯示在工具提示中。
+ **自動** – 如果資料包含多個序列或欄位，則同時顯示名稱和值。
+ **值** – 僅顯示值，絕不顯示名稱。名稱改為顯示在暫留工具提示中。
+ **值和名稱** – 一律顯示值和名稱。
+ **名稱** – 顯示名稱而非值。值會顯示在暫留工具提示中。
+ **無** – 不顯示任何內容 （空白）。名稱和值會顯示在暫留工具提示中。

**顏色模式**

選取顏色模式。
+ **值** – 僅將值和圖形區域著色。
+ **背景** – 也為背景上色。

**圖形模式**

選取圖形和火花模式。
+ **無** – 隱藏圖形，且僅顯示 值。
+ **區域** – 顯示低於值的區域圖表。這需要您的查詢傳回時間欄。

**文字對齊**

選擇對齊模式。
+ **自動** – 如果只顯示單一值 （不重複），則值會置中。如果顯示多個序列或資料列，則值會向左對齊。
+ **中心** – Stat 值以中心為中心。

文字大小

調整量測計文字的大小。
+ **標題** – 輸入計量標題大小的數值。
+ **值** – 輸入計量值大小的數值。

# 狀態時間軸面板
<a name="v9-panels-state-timeline"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

狀態時間軸面板視覺化顯示一段時間內的分散狀態變更。每個欄位或序列都會轉譯為其唯一的水平頻帶。狀態區域可以使用或不使用值來轉譯。此面板適用於字串或布林值狀態，但也可以與時間序列搭配使用。與時間序列搭配使用時，閾值會用來將數值轉換為離散狀態區域。

## 狀態時間軸選項
<a name="v9-panels-state-timeline-options"></a>

使用這些選項來精簡您的視覺化效果：

**合併相等的連續值**

控制 Grafana 是否在彼此相鄰時合併相同的值。

**顯示值**

控制是否在狀態區域內轉譯值。如果有足夠的空間，Auto 會轉譯值。

**對齊值**

控制狀態區域內的值對齊。

**資料列高度**

控制資料列之間的空間。1 = 無空間 = 0.5 = 50% 空間。

**線條寬度**

控制狀態區域的線條寬度。

**填補不透明度**

控制狀態區域的不透明度。

## 值映射
<a name="v9-panels-state-timeline-valuemap"></a>

若要將顏色指派給布林值或字串值，請使用 [設定值映射](v9-panels-configure-value-mappings.md)。

## 具有閾值的時間序列資料
<a name="v9-panels-state-timeline-threshold"></a>

面板也可以與時間序列資料搭配使用。在這種情況下，閾值用於將時間序列轉換為離散的彩色狀態區域。

## 圖例選項
<a name="v9-panels-state-timeline-legend"></a>

啟用圖例選項時，可以顯示值映射或閾值括號。若要在圖例中顯示值映射，請務必將標準選項下的色彩配置選項設定為單一顏色或傳統調色盤。若要查看圖例中的閾值括號，請將顏色方案設定為從閾值。

**圖例模式** 使用這些設定來精簡圖例在視覺化中的顯示方式。
+  **清單 ** – 將圖例顯示為清單。這是圖例的預設顯示模式。
+  **資料表** – 將圖例顯示為資料表。
+  **隱藏** – 隱藏圖例。

**圖例放置** 選擇放置圖例的位置。
+  **底部 ** – 圖表下方。
+  **右側** – 圖形右側。

**圖例值**

選擇要在圖例中顯示的標準[計算](v9-panels-calculation-types.md)。您可以有多個 。

# 狀態歷史記錄面板
<a name="v9-panels-status-history"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

狀態歷史記錄視覺化顯示一段時間內的週期性狀態。每個欄位或序列都會轉譯為水平資料列。方塊會轉譯，並以每個值為中心。

狀態歷史記錄視覺化適用於字串、布林值和數值欄位或時間序列。時間欄位為必要欄位。您可以使用值映射來著色字串，或將文字值指派給數值範圍。

## 顯示選項
<a name="v9-panels-status-history-timeline-options"></a>

使用這些選項來精簡您的視覺化效果：

**顯示值**

控制是否在值方塊中轉譯值。如果有足夠的空間，Auto 會轉譯值。

**欄寬度**控制方塊的寬度。1 = 最大和 0 = 最小寬度。

**線條寬度**控制狀態區域的線條寬度。

**填充不透明度**控制狀態區域的填充不透明度。

## 值映射
<a name="v9-panels-status-history-valuemap"></a>

若要將顏色指派給布林值或字串值，請使用 [設定值映射](v9-panels-configure-value-mappings.md)。

## 具有閾值的時間序列資料
<a name="v9-panels-status-history-threshold"></a>

面板也可以與時間序列資料搭配使用。在此情況下，閾值會用來為方塊上色。您也可以使用漸層顏色方案來顏色值。

## 圖例選項
<a name="v9-panels-status-history-legend"></a>

啟用圖例選項時，可以顯示值映射或閾值括號。若要在圖例中顯示值映射，請務必將標準選項下的色彩配置選項設定為單一顏色或傳統調色盤。若要查看圖例中的閾值括號，請將顏色方案設定為從閾值。

**圖例模式** 使用這些設定來精簡圖例在視覺化中的顯示方式。
+  **清單 ** – 將圖例顯示為清單。這是圖例的預設顯示模式。
+  **資料表** – 將圖例顯示為資料表。
+  **隱藏** – 隱藏圖例。

**圖例放置** 選擇放置圖例的位置。
+  **底部 ** – 圖表下方。
+  **右側** – 圖形右側。

**圖例值**

選擇要在圖例中顯示的標準[計算](v9-panels-calculation-types.md)。您可以有多個 。

# 資料表面板
<a name="v9-panels-table"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

資料表面板視覺化非常靈活，支援多個模式，用於時間序列和資料表、註釋和原始 JSON 資料。此面板也提供日期格式、值格式和著色選項。

## 排序資料欄
<a name="v9-panels-table-sort"></a>

按一下欄標題，將排序順序從預設變更為遞減至遞增。每次按一下時，排序順序都會變更為週期中的下一個選項。您一次只能依據一欄來排序。

## 資料表選項
<a name="v9-panels-table-options"></a>

**顯示標頭**

顯示或隱藏從資料來源匯入的資料欄名稱。

## 資料欄寬度
<a name="v9-panels-table-width"></a>

根據預設，Grafana 會根據資料表大小和最小資料欄寬度自動計算資料欄寬度。此欄位選項可以覆寫設定，並以像素定義所有資料欄的寬度。

例如，如果您`100`在 欄位中輸入 ，則當您在 欄位外按一下 時，所有欄都會設為 100 像素寬。

## 欄寬度下限
<a name="v9-panels-table-min"></a>

根據預設，資料表資料欄的最小寬度為 150 像素。此欄位選項可以覆寫該預設值，並以像素定義資料表面板的新最小欄寬。

例如，如果您`75`在 欄位中輸入 ，則當您在 欄位外按一下 時，所有欄都會縮放至不小於 75 像素寬。

對於智慧型手機或平板電腦等小型螢幕裝置，請將預設`150`像素值減少為 `50`，以允許資料表型面板在儀表板中正確轉譯。

## 資料欄對齊
<a name="v9-panels-table-alignment"></a>

選擇 Grafana 應如何對齊儲存格內容：
+ Auto (自動) (預設)
+ Left (左)
+ Center
+ Right (右)

## 儲存格類型
<a name="v9-panels-table-cell-type"></a>

根據預設，Grafana 會自動選擇顯示設定。您可以選擇下列其中一個選項來覆寫設定，以設定所有欄位的預設值。某些儲存格類型可使用其他組態。

**注意**  
如果您在**欄位**索引標籤中設定這些項目，則類型會套用至所有欄位，包括時間欄位。您可以在**覆寫**索引標籤中設定它們，將變更套用至一或多個欄位。

**顏色文字**

如果設定閾值，則欄位文字會以適當的閾值顏色顯示。

**顏色背景 （漸層或固體）**

如果設定閾值，則欄位背景會以適當的閾值顏色顯示。

**量測計**

儲存格可以顯示為圖形指標，具有數種不同的呈現類型。

**基本**

基本模式會顯示簡單的量測計，其中包含定義量測計顏色的閾值層級。

**漸層**

閾值層級會定義漸層。

**LCD**

量測計會分割成點亮或未點亮的小儲存格。

**JSON 檢視**

顯示格式化為程式碼的值。如果值是物件，則允許瀏覽 JSON 物件的 JSON 檢視會在暫留時顯示。

## 儲存格值檢查
<a name="v9-panels-table-cell-value"></a>

啟用資料表儲存格的值檢查。原始值會顯示在模態視窗中。

**注意**  
只有當儲存格顯示模式設定為自動、顏色文字、顏色背景或 JSON 檢視時，才能使用儲存格值檢查。

## 資料欄篩選條件
<a name="v9-panels-table-col-filter"></a>

您可以暫時變更資料欄資料的顯示方式。例如，您可以排序從最高到最低的值，或隱藏特定值。如需詳細資訊，請參閱以下[篩選資料表資料欄](#v9-panels-table-filter)。

## 分頁
<a name="v9-panels-table-pagination"></a>

使用此選項啟用或停用分頁。這是不會影響查詢的前端選項。啟用時，頁面大小會自動調整為資料表的高度。

## 篩選資料表資料欄
<a name="v9-panels-table-filter"></a>

如果您開啟資料**欄篩選條件**，則可以篩選資料表選項。

**開啟資料欄篩選**

1. 在 Grafana 中，使用您要篩選的資料欄導覽至具有資料表的儀表板。

1. 在您要篩選的資料表面板上，開啟面板編輯器。

1. 選擇**欄位**索引標籤。

1. 在**資料表**選項中，開啟**資料欄篩選**選項。

每個資料欄標題旁都會顯示篩選條件圖示。

**篩選資料欄值**

若要篩選欄值，請選擇欄標題旁的篩選條件 （漏斗） 圖示。Grafana 會顯示該資料欄的篩選選項。

選擇您要顯示的值旁的核取方塊。在頂端的搜尋欄位中輸入文字，以在顯示器中顯示這些值，以便您可以選取它們，而不是捲動來尋找它們。

**清除資料欄篩選條件**

套用篩選條件的資料欄會在標題旁顯示藍色漏斗。

若要移除篩選條件，請選擇藍色漏斗圖示，然後選取清除篩選條件。

## 資料表頁尾
<a name="v9-panels-table-footer"></a>

您可以使用資料表頁尾來顯示欄位[的計算](v9-panels-calculation-types.md)。

啟用資料表頁尾之後，您可以選擇**計算**，然後選擇要計算**的欄位**。

如果您未選取欄位，系統會將計算套用至所有數值欄位。

**計數資料列**

如果您想要顯示資料集中的資料列數，而不是所選欄位中的值數，請選取**計數**計算並啟用**計數資料列**。

# 文字面板
<a name="v9-panels-text"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

文字面板可讓您直接在儀表板中包含文字或 HTML。這可用於新增內容資訊和描述，或內嵌複雜的 HTML。

**Mode (模式)**

模式決定內嵌內容的顯示方式。它有下列選項
+ **Markdown** – 此選項會將內容格式化為 Markdown。
+ **HTML** – 此設定會將內容轉譯為已淨化的 HTML。
+ **程式碼** – 此設定會在唯讀程式碼編輯器內轉譯內容。選取適當的語言，將語法反白套用至內嵌文字。

**變數**

內容中的變數將展開以顯示。

# 時間序列面板
<a name="v9-panels-time-series"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

時間序列面板可以將時間序列轉譯為線條、點的路徑或一系列長條。這種圖形的多樣性足以顯示幾乎任何時間序列資料。

**注意**  
您可以將圖形面板視覺效果遷移至時間序列視覺效果。若要遷移，請在**面板**索引標籤上，選擇**時間序列視覺化**。Grafana 會傳輸所有適用的設定。

**Topics**
+ [工具提示選項](v9-time-series-panel-tooltip.md)
+ [圖例選項](v9-time-series-panel-legend.md)
+ [圖形樣式選項](v9-time-series-graph.md)
+ [軸選項](v9-time-series-axis.md)
+ [顏色選項](v9-time-series-color.md)

# 工具提示選項
<a name="v9-time-series-panel-tooltip"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

當您將游標暫留在圖形上時，Grafana 可以顯示工具提示。選擇工具提示的行為方式：
+  **單一** – 暫留工具提示只會顯示您要暫留的序列。
+  **全部** – 暫留工具提示會顯示圖形中的所有序列。Grafana 會反白顯示您在工具提示的序列清單中以粗體暫留的序列。
+  **隱藏** – 請勿顯示工具提示。

# 圖例選項
<a name="v9-time-series-panel-legend"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

**圖例模式** – 選擇圖例的顯示方式。
+  **清單** – 將圖例顯示為清單。這是預設值。
+  **資料表** – 將圖例顯示為資料表。
+  **隱藏** – 隱藏圖例。

**圖例置放** – 選擇圖例的顯示位置。
+  **底部** – 圖表下方。
+  **右側** – 圖形右側。

**圖例計算**

選擇要在圖例中顯示的計算。如需詳細資訊，請參閱[計算類型](v9-panels-calculation-types.md)。

# 圖形樣式選項
<a name="v9-time-series-graph"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

**圖形樣式**

使用此選項來定義如何顯示時間序列資料。您可以使用覆寫來合併相同圖形中的多個樣式。有三種樣式選項。某些其他樣式選項僅適用於特定圖形樣式。
+ **行** – 在圖形上將時間序列顯示為行。
+ **長條** – 將時間序列顯示為圖形上的長條序列，每個資料點各一個。
+ **點** – 在圖形上將時間序列顯示為點，每個資料點各一個點。

**長條對齊**

對於長條圖， 會設定長條相對於圖形上繪製點的位置。由於長條具有寬度，因此可以放置在點之前、之後或中心。此選項的選項包括 **Before**、**Center** 或 **After**。

**線條寬度**

設定折線圖的線條粗細，或長條圖中每個長條的輪廓粗細。

**填補不透明度**

設定填充顏色的不透明度。例如，填充用於在折線圖中顯示線下的區域，或顯示為長條圖中長條的顏色。

**漸層模式**

漸層模式會指定漸層填充，這是根據序列顏色。若要變更顏色，請使用標準顏色方案欄位選項。如需詳細資訊，請參閱[顏色方案](v9-panels-configure-standard-options.md#v9-panels-standard-options-color-scheme)。漸層模式選項包括：
+ **無** – 無漸層填充。
+ **不透明度** – 不透明度漸層，其中填充的不透明度隨著 Y 軸值增加而增加。
+ **Hue** – 以系列顏色的色調為基礎的漸層。
+ **結構描述** – 顏色結構描述定義的顏色漸層。此設定可由填滿和線條使用。如需詳細資訊，請參閱[顏色選項](v9-time-series-color.md)。

填補**不透明度**設定也會修改漸層外觀。

**顯示點**

您可以設定視覺效果，將點新增至折線圖或長條圖。您可以選擇 **Always**、**Never** 或 **Auto**。使用 **Auto** 時，Grafana 會根據資料的密度決定是否顯示點。如果資料的密度夠低，則會顯示點。

**點大小**

設定繪製點的大小，直徑從 1 到 40 像素。

**行插補**

選擇 Grafana 如何插補序列行。選項包括**線性**、**平滑**、**步驟之前**和**步驟之後**。

**線條樣式**

設定線條的樣式。若要變更顏色，請使用標準顏色方案欄位選項。

線條樣式外觀會受到**線條寬度**和**填充不透明度**的設定影響。

行樣式的選擇為**實**心、**儀表板**和**點**。

**連接 null 值**

選擇 Null 值 （資料中的間隙） 在圖形上的顯示方式。可以連接 Null 值以形成連續的線條，或者選擇性地設定閾值，使資料中的間隙不再連接。您可以選擇**永不**連接具有間隙的資料點、**一律**連接具有間隙的資料點，或設定資料中不應再連接間隙的**閾值**。

**堆疊系列**

*堆疊*可讓 Grafana 互相顯示序列。在視覺化中使用堆疊時請小心，因為它可以輕鬆建立誤導的圖形。若要進一步了解堆疊可能不是最佳方法的原因，請參閱[堆疊問題](https://www.data-to-viz.com/caveat/stacking.html)。

堆疊的選項包括：
+ **關閉** – 關閉序列堆疊。
+ **正常** – 堆疊序列彼此重疊。
+ **100%** – 依百分比堆疊，其中所有序列加起來加起來為 100%。

**群組中的堆疊序列**

您可以覆寫堆疊行為，以在群組中堆疊序列。如需建立覆寫的詳細資訊，請參閱 [設定欄位覆寫](v9-panels-configure-overrides.md)。建立覆寫時，請提供您要序列所屬的堆疊群組名稱。

**將下方填入**

**下方填入選項**會填入兩個序列之間的區域。此選項僅適用於序列或欄位覆寫。使用此選項，您可以填入兩個序列之間的區域，而不是從序列列向下到 0。例如，如果您有兩個稱為 *Max* 和 *Min* 的序列，您可以選取 **Max** 系列，並覆寫它以**將下方填入** **Min** 系列。這只會填滿兩個序列行之間的區域。

# 軸選項
<a name="v9-time-series-axis"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

軸類別下方的選項會變更 X 軸和 Y 軸的轉譯方式。在您按一下正在編輯的欄位選項方塊之外，某些選項才會生效。您也可以或按 `Enter`。

**配置**

選取 Y 軸的位置。選項為：
+ **自動** – Grafana 會自動將 Y 軸指派給序列。當有兩個或更多具有不同單位的序列時，Grafana 會將左軸指派給第一個單位，並將右軸指派給後續的單位。
+ **左側** – 在左側顯示所有 Y 軸。
+ **右側** – 在右側顯示所有 Y 軸。
+ **隱藏** – 隱藏所有 Y 軸。

若要為每個欄位或序列指派軸，請[新增欄位覆寫](v9-panels-configure-overrides.md)。

**標籤**

設定 Y 軸文字標籤。如果您有多個 Y 軸，則可以使用覆寫來指派不同的標籤。

**Width (寬度)**

設定軸的固定寬度。根據預設，Grafana 會動態計算軸的寬度。

透過設定軸的寬度，具有不同軸類型的資料可以共用相同的顯示比例。此設定可讓您更輕鬆地比較多個圖形的資料值，因為軸不會在視覺上彼此接近的範圍內移動或延伸。

**軟性最小值和軟性最大值**

設定**軟最小值**或**軟最大值**選項，以更好地控制 Y 軸限制。根據預設，Grafana 會根據資料集自動設定 Y 軸的範圍。

軟性最小值和軟性最大值設定可在沒有重大變更時查看小型變更。從標準最小和最大欄位選項衍生的硬性最小值或最大值，可以透過將峰值剪輯超過特定點，防止間歇性峰值扁平化有用的詳細資訊。

若要定義 Y 軸的硬性限制，您可以設定標準最小/最大選項。如需詳細資訊，請參閱[設定標準選項](v9-panels-configure-standard-options.md)。

**擴展**

設定 Y 軸的擴展方式。選項為**線性**或**對數。**如果您選擇對數，您可以進一步選擇基本 2 或基本 10 對數縮放。

**Transform (變形)**

您可以覆寫序列，將轉換套用至圖形上的值 （不會影響基礎值或工具提示、內容功能表或圖例中的值）。您有兩個轉換選項：
+ **負 Y 轉換** – 將結果翻轉至 Y 軸上的負值。
+ **常數** – 將第一個值顯示為常數行。

# 顏色選項
<a name="v9-time-series-color"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

根據預設，圖形會使用標準[顏色方案](v9-panels-configure-standard-options.md#v9-panels-standard-options-color-scheme)選項來指派系列顏色。您也可以按一下圖例系列顏色圖示，使用圖例來開啟顏色挑選器。以這種方式設定顏色會自動建立覆寫規則，將 設定為特定序列的特定顏色。

以下是可用來覆寫系列顏色預設值的其他選項。

**Classic Palette**

最常見的設定是針對圖形使用 **Classic 調色盤**。此方案會根據每個欄位或序列的順序自動指派顏色。如果查詢中的欄位順序變更，顏色也會變更。您可以使用覆寫規則手動設定特定欄位的顏色。

**單一顏色**

使用此模式來指定顏色。您也可以按一下圖例中每個序列旁邊的彩色線條圖示，以開啟顏色挑選器。這會自動建立新的覆寫，將顏色方案設定為單一顏色和選取的顏色。

**依值顏色方案**

如果您選取按值顏色方案，例如**從閾值 （按值）** 或**Green-Yellow-Red （按值）**，則會顯示**按值序列**選項。此選項控制要使用哪個值 （最後、最小、最大值） 來指派序列的顏色。

**結構描述漸層模式**

位於**圖形樣式**下方的**漸層模式**選項具有名為**結構描述**的模式。當您啟用**結構描述**時，線條或長條會收到從所選顏色**結構描述定義的漸層顏色**。

**從閾值**

如果**顏色方案**設定為**從閾值 （依值）**，而**漸層模式**設定為**結構描述**，則線條或長條顏色會在超過定義的閾值時變更。您只會看到配置中選擇的確切顏色。

**漸層顏色方案**

使用漸層顏色方案*而不*將**漸層模式**設定為**方案**，表示所選顏色會在所選顏色之間形成漸層，因為序列中的值會在設定的閾值之間移動。

# 追蹤面板 (Beta 版）
<a name="v9-panels-traces"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

*追蹤*是一種視覺化，可讓您在請求周遊基礎設施中的服務時追蹤和記錄請求。

如需追蹤的詳細資訊，請參閱 [探索中的追蹤](v9-explore-tracing.md)。

# WindRose
<a name="v9-panels-windrose"></a>

****  
本文件主題專為支援 Grafana **9.x 版的 Grafana** 工作區而設計。  
如需支援 Grafana 10.x 版的 Grafana 工作區，請參閱[使用 Grafana 第 10 版](using-grafana-v10.md)。  
如需支援 Grafana 8.x 版的 Grafana 工作區，請參閱 [使用 Grafana 第 8 版](using-grafana-v8.md)。

WindRose 面板會接收原始時間序列資料，並將資料映射到 WindRose 圖表中。

![\[WindRose panel with two circular charts showing wind direction and speed data distribution.\]](http://docs.aws.amazon.com/zh_tw/grafana/latest/userguide/images/windrose.png)


## 選項
<a name="v9-panels-windrose-options"></a>

WindRose 面板支援下列選項：
+ 軸頻率
+ 軸樣式 （度或羅盤）
+ 縮放 （線性、方形、日誌）