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

# Grafana 第 10 版中的儀表板
<a name="v10-dashboards"></a>

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

 儀表板是一組一或多個[面板](v10-panels.md)，組織並排列成一或多個資料列。Grafana 隨附各種面板，可讓您輕鬆建構正確的查詢，並自訂視覺化效果，以便建立符合您需求的理想儀表板。每個面板都可以與任何已設定 的資料互動[連線至資料來源](AMG-data-sources.md)。

 儀表板快照是靜態的。無法從快照重新執行查詢和表達式。因此，如果您更新查詢或表達式中的任何變數，它將不會變更儀表板資料。

**Topics**
+ [使用儀表板](v10-dash-using-dashboards.md)
+ [建置儀表板](v10-dash-building-dashboards.md)
+ [管理儀表板](v10-dash-managing-dashboards.md)
+ [管理播放清單](v10-dash-managing-playlists.md)
+ [共用儀表板和面板](v10-dash-sharing.md)
+ [Variables](v10-dash-variables.md)
+ [評估儀表板用量](v10-dash-assess-dashboard-usage.md)
+ [故障診斷儀表板](v10-dash-troubleshoot.md)
+ [在 Grafana 第 10 版中搜尋儀表板](v10-search.md)

# 使用儀表板
<a name="v10-dash-using-dashboards"></a>

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

本主題提供儀表板功能和捷徑的概觀，並說明如何使用儀表板搜尋。

## 功能
<a name="v10-dash-features"></a>

您可以使用儀表板來自訂資料的呈現。下圖顯示 Amazon Managed Grafana 工作區中的儀表板界面。

![\[顯示 Amazon Managed Grafana 工作區中儀表板界面的影像，其中包含不同功能的按鈕重點。\]](http://docs.aws.amazon.com/zh_tw/grafana/latest/userguide/images/AMG-dashboard-overview-v10.png)



|  功能  |  Description  | 
| --- | --- | 
| **1。首頁** | 選取要重新導向至 Grafana 執行個體中設定的首頁的 Grafana 主圖示。 | 
| **2. 標題** | 選取儀表板標題時，您可以搜尋目前資料夾中包含的儀表板。 | 
| **3. 共用儀表板** | 使用此選項，透過連結或快照共用目前的儀表板。您也可以從共用模式匯出儀表板定義。 | 
| **4. 新增面板** | 使用此選項可將面板、儀表板列或程式庫面板新增至目前的儀表板。 | 
| **5. 儲存儀表板** | 選擇儲存圖示以儲存儀表板的變更。 | 
| **6. 儀表板洞察** | 選擇檢視儀表板的分析，包括使用者、活動和查詢計數的相關資訊。如需詳細資訊，請參閱[評估儀表板用量](v10-dash-assess-dashboard-usage.md)。 | 
| **7. 儀表板設定** | 使用此選項可變更儀表板名稱、資料夾或標籤，以及管理變數和註釋查詢。如需儀表板設定的詳細資訊，請參閱 [修改儀表板設定](v10-dash-modify-settings.md)。 | 
| **8. 時間選擇器下拉式清單** |  使用 選取相對時間範圍選項並設定自訂絕對時間範圍。 您可以按一下變更時間設定按鈕，從時間範圍控制項變更**時區**和**會計年度****設定**。 時間設定是以每個儀表板為基礎儲存。  | 
| **9. 縮小時間範圍** |  使用 縮小時間範圍。如需如何使用時間範圍控制項的詳細資訊，請參閱 [設定儀表板時間範圍](#v10-dash-setting-dashboard-time-range)。  | 
| **10. 重新整理儀表板** | 選取 可立即觸發查詢並重新整理儀表板資料。 | 
| **11. 重新整理儀表板時間間隔** | 選取儀表板自動重新整理時間間隔。 | 
| **12. 檢視模式**  | 選取以在電視或資訊站等大型螢幕上顯示儀表板。檢視模式隱藏不相關的資訊，例如導覽功能表。  | 
| **13. 儀表板面板** |  儀表板的主要建置區塊是面板。若要新增面板、儀表板列或程式庫面板，請選取**新增面板**。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/grafana/latest/userguide/v10-dash-using-dashboards.html)  | 
| **14. 圖形圖例** | 直接從圖例變更系列顏色、y 軸和系列可見性。 | 
| **15. 儀表板列** | 儀表板列是儀表板內的邏輯分隔器，可將面板分組在一起。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/grafana/latest/userguide/v10-dash-using-dashboards.html)  | 

## 鍵盤快速鍵
<a name="v10-dash-keyboard-shortcuts"></a>

Grafana 有許多可用的鍵盤快速鍵。若要顯示所有可用的鍵盤快速鍵，請按鍵盤上的 **？** 或 **h**。
+ `Ctrl+S` 會儲存目前的儀表板。
+ `f` 會開啟儀表板搜尋工具/搜尋。
+  `d+k` 切換資訊站模式 （隱藏選單）。
+ `d+e` 會展開所有資料列。
+ `d+s` 會開啟儀表板設定。
+ `Ctrl+K` 會開啟命令調色盤。
+ `Esc` 在全螢幕檢視或編輯模式下結束面板。也會從儀表板設定傳回儀表板。

**聚焦面板**

若要使用以特定面板為目標的捷徑，請將滑鼠游標暫留在面板上。
+ `e` 切換面板編輯檢視 
+ `v` 切換面板全螢幕檢視 
+ `ps` 開啟面板共用功能 
+ `pd` 重複面板 
+ `pr` 移除面板 
+ `pl` 切換面板圖例 

## 設定儀表板時間範圍
<a name="v10-dash-setting-dashboard-time-range"></a>

Grafana 提供多種方法來管理要視覺化的資料時間範圍，包括儀表板、面板和提醒。

本節說明支援的時間單位和相對範圍、常用時間控制、儀表板範圍的時間設定，以及面板特定的時間設定。

**時間單位和相對範圍**

Grafana 支援下列時間單位：`s (seconds)`、`m (minutes)`、`h (hours)`、`d (days)``w (weeks)`、`M (months)`、`Q (quarters)`、 和 `y (years)`。

減號運算子可讓您回到相對於目前日期和時間的時間，或 `now`。如果您想要顯示單位的完整期間 （天、週或月），請附加`/<time unit>`到結尾。若要檢視會計期間，請使用 `fQ (fiscal quarter)`和 `fy (fiscal year)` 時間單位。

加號運算子可讓您相對於現在，及時向前邁進。例如，您可以使用此功能來查看未來的預測資料。

下表提供相對範圍的範例。


| 相對範圍範例 | 從 | 到 | 
| --- | --- | --- | 
| 過去 5 分鐘 |  `now-5m`  |  `now`  | 
| 到目前為止的那天 |  `now/d`  |  `now`  | 
| 本週 |  `now/w`  |  `now/w`  | 
| 本週到目前為止 |  `now/w`  |  `now`  | 
| 本月 |  `now/M`  |  `now/M`  | 
| 本月到目前為止 |  `now/M`  |  `now`  | 
| 上個月 |  `now-1M/M`  |  `now-1M/M`  | 
| 今年到目前為止 |  `now/Y`  |  `now`  | 
| 今年 |  `now/Y`  |  `now/Y`  | 
| 上一個會計年度 |  `now-1y/fy`  |  `now-1y/fy`  | 

**注意**  
 Grafana 警示不支援下列語法：  
`now+n` 用於未來的時間戳記。
`now-1n/n` 表示*從 n 開始到 n 結束*，因為這是絕對時間戳記。

**常見時間範圍控制**

儀表板和面板時間控制項具有通用的使用者介面。以下說明常見的時間範圍控制項。
+ 目前時間範圍也稱為*時間挑選器*，顯示目前顯示在您正在檢視的儀表板或面板中的時間範圍。將游標暫留在 欄位上，以查看範圍內的確切時間戳記及其來源 （例如本機瀏覽器時間）。按一下*目前的時間範圍*以進行變更。您可以使用*相對*時間範圍，例如過去 15 分鐘或絕對時間範圍，例如 `2020-05-14 00:00:00`，將目前時間變更為 `2020-05-15 23:59:59`。
+ 可以從**相對時間範圍**清單中選取**相對時間範圍**。您可以使用頂端的輸入欄位來篩選清單。時間範圍的一些範例包括*過去 30 分鐘*、*過去 12 小時*、*過去 7 天*、*過去 2 年*、*昨天*、*前一天*、*上週*、*今天到目前為止*、*本週到目前為止*，以及*本月到目前為止*。
+ **絕對時間範圍**可以透過兩種方式設定：將確切的時間值或相對時間值輸入**至開始**和**結束**欄位，然後按一下**套用時間範圍**，或按一下**開始**或**結束**欄位時，從顯示的行事曆中按一下日期或日期範圍。若要套用您的選擇，請按一下**套用時間範圍**。您也可以從最近使用的絕對時間範圍清單中選擇。
+ **您可以在絕對時間範圍設定中選取半相關**時間範圍。例如，若要顯示自特定日期以來的活動，您可以選擇開始時間的絕對時間，以及結束時間的相對時間 （例如 `now`)。

  使用半相對的時間範圍，隨著時間的推移，您的儀表板會自動逐步縮小，以顯示更多歷史記錄和更少的詳細資訊。以相同的速率，隨著高資料解析度的減少，整個期間的歷史趨勢將變得更加清晰。
**注意**  
警示不支援半相關時間範圍。
+ 選取**縮小**圖示來縮小 （或使用 Cmd\$1Z 或 Ctrl\$1Z 做為鍵盤快速鍵）。這會增加檢視，在儀表板或面板視覺化中顯示較大的時間範圍。
+ 透過選取您要在視覺化圖形上檢視的時間範圍來**放大**。
**注意**  
放大僅適用於圖形視覺化。

**重新整理儀表板**

按一下**重新整理儀表板**圖示，立即執行儀表板上的每個查詢，並重新整理視覺效果。當您觸發重新整理時，Grafana 會取消任何待處理的請求。

根據預設，Grafana 不會自動重新整理儀表板。查詢會根據面板設定依自己的排程執行。不過，如果您想要定期重新整理儀表板，請按一下**重新整理儀表板**圖示旁的向下箭頭，然後選取重新整理間隔。

**使用 URL 控制時間範圍**

您可以在儀表板 URL 中提供下列查詢參數，以控制儀表板的時間範圍。
+ `from` 定義時間範圍的下限，以 ms epoch 或[相對時間](#v10-dash-setting-dashboard-time-range)指定。
+ `to` 定義時間範圍的上限，以 ms epoch 或相對時間指定。
+ `time` 和 `time.window`定義從 `time-time.window/2`到 的時間範圍`time+time.window/2`。這兩個參數都應該以毫秒為單位指定。例如，`?time=1500000000000&time.window=10000`產生從 1499999995000 到 1500000005000 的 10s 時間範圍。

# 建置儀表板
<a name="v10-dash-building-dashboards"></a>

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

建立 Grafana 工作區並登入後，您可以建立儀表板並修改設定以符合您的需求。儀表板由[具有視覺化效果的面板](v10-panels-viz.md)組成。每個面板都有與其相關聯的查詢，以從您的其中一個 提取資料[連線至資料來源](AMG-data-sources.md)。

您可以透過新增和使用[變數](v10-dash-variables.md)來建立更多互動式和動態儀表板。您可以在指標查詢中使用變數，而不是硬式編碼伺服器、應用程式或其他名稱。

**Topics**
+ [建立儀表板](v10-dash-creating.md)
+ [匯入儀表板](v10-dash-importing.md)
+ [匯出儀表板](v10-dash-exporting.md)
+ [修改儀表板設定](v10-dash-modify-settings.md)
+ [儀表板 URL 變數](v10-dash-dashboard-url-variables.md)
+ [管理程式庫面板](v10-dash-manage-library-panels.md)
+ [管理儀表板版本歷史記錄](v10-dash-manage-version-history.md)
+ [管理儀表板連結](v10-dash-manage-dashboard-links.md)
+ [註釋視覺化效果](v10-dash-annotations.md)
+ [儀表板 JSON 模型](v10-dash-dashboard-json-model.md)
+ [儀表板的最佳實務](v10-dash-bestpractices.md)

# 建立儀表板
<a name="v10-dash-creating"></a>

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

**建立儀表板 **

儀表板和面板可讓您使用 Grafana 以視覺化形式顯示資料。每個面板至少需要一個查詢才能顯示視覺化。開始之前，請先完成下列先決條件。
+ 請確定您擁有適當的許可。如需許可的詳細資訊，請參閱「[使用者、團隊和許可](Grafana-administration-authorization.md)」。
+ 識別您要新增面板的儀表板。
+ 了解目標資料來源的查詢語言。
+ 確定您寫入查詢的資料來源已新增。如需詳細資訊，請參閱[連線至資料來源](AMG-data-sources.md)。

 若要建立儀表板：

1. 登入 Grafana，然後從左側選單中選取**儀表板**。

1. 選取**新增**，然後選取**新增儀表板**。

1. 在空白儀表板上，選取 **\$1 新增視覺效果**。這會開啟新的視覺化對話方塊。

1. 選取資料來源。您可以選擇現有的資料來源，這是 Grafana 內建的資料來源之一進行測試，或選擇**設定新的資料來源**來設定新的資料來源 （只有具有管理員許可的使用者才能設定新的資料來源）。

   **編輯面板**檢視隨即開啟，並選取您的資料來源。您可以視需要使用面板編輯器的**查詢**索引標籤，稍後變更面板的資料來源。

1. 以資料來源的查詢語言撰寫或建構查詢。選擇重新整理儀表板圖示，在資料來源上執行查詢，即可隨時查看結果。

1. 在**視覺化**清單中，選取視覺化類型。Grafana 會顯示已套用視覺化的查詢結果預覽。如需詳細資訊，請參閱[視覺化選項](v10-panels-viz.md)。

1. 在**面板選項**下，您可以輸入面板的標題和描述。

1. 大多數視覺化都需要先進行一些調整，才能顯示您需要的確切資訊。您可以透過下列方式調整面板設定。
   + [設定值映射](v10-panels-configure-value-mappings.md)
   + [視覺化特定選項](v10-panels-viz.md)
   + [覆寫欄位值](v10-panels-configure-overrides.md)
   + [設定閾值](v10-panels-configure-thresholds.md)
   + [設定標準選項](v10-panels-configure-standard-options.md)

1. 完成面板設定後，請選擇**儲存**以儲存儀表板。

   或者，選取**套用**以查看變更，而不離開面板編輯器。

1. 新增備註來描述視覺效果 （或描述您的變更），然後按一下頁面右上角的**儲存**。
**注意**  
如果您需要將儀表板還原至先前的版本，備註會很有幫助。

1. 選擇**儲存**。

1. 或者，您也可以選擇儀表板標頭中的**新增**，然後從下拉式清單中選取**視覺化**，將更多面板新增至儀表板。

**複製現有的儀表板**

您可以快速複製現有的儀表板，以快速開始建立新的儀表板。

**複製現有的儀表板**

1. 從左側功能表中選取**儀表板**。

1. 選擇您要複製的儀表板，以開啟它。

1. 選取儀表板右上角的設定 ****（齒輪圖示）。

1. 選取儀表板右上角的**另存新**檔。

1. （選用） 指定名稱、資料夾、描述，以及是否要複製所複製儀表板的原始儀表板標籤。

1. 選取**儲存**。

**設定重複資料列**

您可以設定 Grafana，根據變數的值將面板或資料列動態新增至儀表板。變數可動態變更儀表板中所有資料列的查詢。如需重複面板的詳細資訊，請參閱[設定重複面板]()。

如果您有已設定`Multi-value`或`Include all values`選取的變數，您也可以重複資料列。

開始之前，請確定查詢包含多值變數，然後您應該完成下列步驟。

**設定重複資料列**

1. 從左側功能表中選取**儀表板**，然後選擇您要修改的儀表板。

1. 在儀表板頂端，選取**新增**，然後從下拉式清單中選取**資料列**。

   如果儀表板是空的，您可以交替選取儀表板中間的 **\$1 新增列**按鈕。

1. 將滑鼠暫留在資料列標題上，然後選取出現**的設定** （齒輪） 圖示。

1. 在**資料列選項**對話方塊中，新增標題，然後選取您要為其新增重複資料列的變數。
**注意**  
 若要提供內容給儀表板使用者，請將 變數新增至資料列標題。

1. 選取 **Update** (更新)。

**重複資料列和儀表板特殊資料來源**

如果資料列包含使用特殊[儀表板](AMG-data-sources.md#AMG-data-sources-special)資料來源的面板，也就是使用來自 smae 儀表板中另一個面板之結果集的資料來源，則重複資料列中的對應面板將參考原始資料列中的面板，而不是重複資料列中的面板。

例如，在儀表板中：
+ `Row 1` 包含 `Panel 1A`和 `Panel 1B`。
+ `Panel 1B` 使用`Dashboard`資料來源`Panel 1A`來使用 的結果。
+ 重複`Row 2`包含 `Panel 2A`和 `Panel 2B`。
+ `Panel 2B` 參考 `Panel 1A`，而非 `Panel 2A`。

**移動面板**

1. 開啟儀表板。

1. 選取面板標題，並將面板拖曳至新位置。您可以在任何位置的儀表板上放置面板。

**調整面板大小**

1. 開啟儀表板。

1. 若要調整面板的大小，請拖曳面板的右下角。您可以調整儀表板面板的大小，以符合您的需求。

# 匯入儀表板
<a name="v10-dash-importing"></a>

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

您可以將預先設定的儀表板匯入 Amazon Managed Grafana 工作區。

**匯入儀表板**

1. 登入您的 Amazon Managed Grafana 工作區。

1. 從左側功能表中選取**儀表板**。

1. 選取**新增**，然後在下拉式選單中選擇**匯入**。

1. 接下來，您需要選擇要匯入的儀表板 JSON 定義。對於如何匯入 JSON，您有三種選擇：
   + 上傳包含儀表板 JSON 的檔案。
   + 直接將 JSON 文字複製到文字區域。
   + 將 Grafana Labs 儀表板 URL 或 ID 貼到 欄位中。如需 grafana.com 儀表板 URLs的詳細資訊，請參閱下一節。
   + （選用） 變更您要變更的任何儀表板詳細資訊。
   + 如有需要，請選取資料來源。
   + 選擇**匯入**。
   + 儲存儀表板。

## 在 https：//grafana.com 上尋找儀表板
<a name="v10-dash-import-from-grafana"></a>

https：//grafana.com[ 上的儀表板](https://grafana.com/grafana/dashboards/)頁面為您提供常見伺服器應用程式的儀表板。瀏覽官方和社群建置的儀表板程式庫，並匯入它們以快速啟動和執行。

**注意**  
若要從 grafana.com 匯入儀表板，Amazon Managed Grafana 工作區必須能夠存取網際網路。

# 匯出儀表板
<a name="v10-dash-exporting"></a>

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

您可以使用 Grafana UI 或 HTTP API 匯出儀表板。

儀表板匯出動作會建立 Grafana JSON 檔案，其中包含您需要的所有項目，包括配置、變數、樣式、資料來源、查詢等，以便您稍後匯入儀表板。

**讓儀表板成為可攜式**

如果您想要匯出儀表板以供其他人使用，您可以為指標字首 （使用常數變數） 和伺服器名稱等物件新增範本變數。

類型 的範本變數`Constant`會自動隱藏在儀表板中，也會在匯入儀表板時新增為必要的輸入。

**匯出儀表板**

1. 開啟您要匯出的儀表板。

1. 選取共用圖示。

1. 選擇 **Export** (匯出)。

1. 選擇**儲存至檔案。**

**注意**  
Grafana 會將 JSON 檔案下載到您的本機電腦。

# 修改儀表板設定
<a name="v10-dash-modify-settings"></a>

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

儀表板設定頁面可讓您：
+ 編輯一般儀表板屬性，包括時間設定。
+ 新增註釋查詢。
+ 新增儀表板變數。
+ 新增連結。
+ 檢視儀表板 JSON 模型

**存取儀表板設定頁面**

1. 以編輯模式開啟儀表板。

1. 按一下頁面頂端的**儀表板設定** （齒輪圖示）。

**修改儀表板時間設定**

當您想要變更儀表板時區、本機瀏覽器時間，並指定自動重新整理時間間隔時，請調整儀表板時間設定。

**修改儀表板時間設定**

1. 在**儀表板**設定頁面上，選取**一般**。

1. 導覽至**時間選項**區段。

1. 根據下列描述指定時間設定。

1. 
   + **時區** – 指定您要監控之服務或系統的本機時區。這在監控跨多個時區運作的系統或服務時很有幫助。
     + **預設** – Grafana 使用使用者設定檔、團隊或組織的預設所選時區。如果未為使用者設定檔、使用者所屬的團隊或組織指定時區，則 Grafana 會使用本機瀏覽器時間。
     + **本機瀏覽器時間** – 使用為檢視使用者瀏覽器設定的時區。這通常與電腦上設定的時區相同。
     + 使用標準 [ISO 8601 時區](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)，包括 UTC。
   + **自動重新整理** – 自訂顯示相對時間和自動重新整理選項的選項。項目以逗號分隔，並接受任何有效的時間單位。
   + **現在延遲** – 輸入`now`時間延遲來覆寫時間。使用此選項可因應資料彙總中的已知延遲，以避免 Null 值。
   + **隱藏時間挑選器** – 如果您不希望儀表板顯示時間挑選器，請選取此選項。

**注意**  
若要擁有時間控制，您的資料必須包含時間欄。如需包含時間欄的詳細資訊，請參閱特定[資料來源](AMG-data-sources.md)的文件。

**新增註釋查詢**

註釋查詢是查詢事件的查詢。這些事件可以在儀表板的圖形中視覺化為垂直行，以及您可以懸停的小型圖示來查看事件資訊。

**新增註釋查詢**

1. 在**儀表板設定**頁面上，選取**註釋**。

1. 選取**新增註釋查詢**。

1. 輸入名稱並選取資料來源。

1. 完成表單的其餘部分以建置查詢和註釋。

查詢編輯器 UI 會根據您選取的資料來源而變更。如需如何建構查詢的詳細資訊，請參閱[資料來源](AMG-data-sources.md)文件。或者，對於您從 安裝的資料來源外掛程式[使用外掛程式目錄尋找外掛程式](grafana-plugins.md#plugin-catalog)，您可以使用 [Grafana 實驗室網站上的文件](https://grafana.com/docs/grafana/v10.3/datasources/)。

**新增變數**

變數可讓您建立更具互動性和動態的儀表板。您可以在指標查詢中使用變數，而不是硬式編碼，例如伺服器、應用程式和感應器名稱。變數會顯示為儀表板頂端的下拉式清單。這些下拉式清單可讓您輕鬆變更儀表板中顯示的資料。

如需變數的詳細資訊，請參閱[變數](v10-dash-variables.md)。

**新增變數**

1. 在**儀表板設定**頁面上，按一下左側區段選單中的**變數**，然後按一下**新增變數**按鈕。

1. 在**一般**區段中，新增變數的名稱。這是您稍後將在查詢中使用的名稱。

1. 選取變數**類型**。
**注意**  
您選取的變數類型會影響您在頁面上填入的欄位。

1. 定義變數，然後按一下**更新**。

**新增連結**

儀表板連結可讓您將其他儀表板和網站的連結放在儀表板標頭的正下方。連結可讓您輕鬆導覽至其他相關的儀表板和內容。

**新增連結**

1. 在**儀表板設定**頁面上，從左側區段功能表中選擇**連結**，然後選擇**新增連結**按鈕。

1. 在**類型**欄位中輸入標題，然後選取**儀表板**或**連結**。

1. 若要新增儀表板連結，請新增選用標籤、選取任何儀表板連結選項，然後按一下**套用**。
**注意**  
使用標籤會建立具有特定標籤的儀表板動態下拉式清單。

1. 若要新增 Web 連結，請新增使用者將滑鼠游標移至連結上時顯示的 URL 和工具提示文字，選取連結旁顯示的圖示，然後選取任何儀表板連結選項。

**檢視儀表板 JSON 模型 **

Grafana 中的儀表板由 JSON 物件表示，該物件存放儀表板的中繼資料。儀表板中繼資料包括儀表板屬性、面板中繼資料、範本變數、面板查詢等。JSON 中繼資料會定義儀表板。

若要檢視儀表板 JSON 模型，請在**儀表板設定**頁面上按一下 **JSON**。

如需 JSON 欄位的詳細資訊，請參閱 [JSON 欄位](v10-dash-dashboard-json-model.md)。

# 儀表板 URL 變數
<a name="v10-dash-dashboard-url-variables"></a>

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

Grafana 可以在儀表板 URLs 中套用做為查詢參數傳遞的變數值。如需詳細資訊，請參閱[管理儀表板連結](v10-dash-manage-dashboard-links.md)和[範本和變數](v10-dash-variables.md)。

**將變數做為查詢參數傳遞**

Grafana 會將字首為 的查詢字串參數解譯`var-`為指定儀表板中的變數。

例如，在此 URL 中：

```
https://${your-domain}/path/to/your/dashboard?var-example=value
```

查詢參數`var-example=value`代表值為 的儀表板變數範例`value`。

**傳遞變數的多個值**

若要傳遞多個值，請為每個值重複變數參數一次。

```
https://${your-domain}/path/to/your/dashboard?var-example=value1&var-example=value2
```

Grafana 會解譯`var-example=value1&var-example=value2`為具有兩個值的儀表板變數範例： `value1`和 `value2`。

**將變數新增至儀表板連結**

當您從儀表板的設定產生變數時，Grafana 可以將變數新增至儀表板連結。如需新增變數的詳細資訊和步驟，請參閱[管理儀表板連結](v10-dash-manage-dashboard-links.md)。

**傳遞臨機操作篩選條件**

臨機操作篩選條件會將金鑰或值篩選條件套用至使用指定資料來源的所有指標查詢。如需詳細資訊，請參閱[臨機操作篩選條件](v10-dash-variable-add.md#v10-dash-variable-add-adhoc)。

若要傳遞臨機操作篩選條件做為查詢參數，請使用變數語法來傳遞臨機操作篩選條件變數，並提供金鑰、運算子做為值，以及值做為管道分隔清單。

例如，在此 URL 中：

`https://${your-domain}/path/to/your/dashboard?var-adhoc=example_key|=|example_value` 

查詢參數會使用 `example_key`金鑰、 `=`運算子和 `example_value`值，`var-adhoc=key|=|value`套用設定為臨機操作儀表板變數的臨機操作篩選條件。

**注意**  
與臨機操作篩選條件共用 URLs 時，請記得編碼 URL。在上述範例中，將管道 (`|`) 取代為 `%7C`，將等式運算子 (`=`) 取代為 `%3D`。

**使用 URL 控制時間範圍**

若要設定儀表板的時間範圍，請使用 `from`、`time`、 `to`和 `time.window`查詢參數。由於這些不是變數，因此不需要字`var-`首。

# 管理程式庫面板
<a name="v10-dash-manage-library-panels"></a>

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

程式庫面板是可重複使用的面板，可用於任何儀表板。當您變更程式庫面板時，變更會傳播到使用該面板的所有執行個體。程式庫面板可簡化跨多個儀表板的面板重複使用。

您可以將程式庫面板與儲存的儀表板一起儲存在資料夾中。

**建立程式庫面板**

當您建立程式庫面板時，來源儀表板上的面板也會轉換為程式庫面板。轉換面板後，您需要儲存原始儀表板。

**建立程式庫面板**

1. 在編輯模式中開啟您要轉換為程式庫面板的面板。

1. 在面板顯示選項中，按一下向下箭頭選項以開始視覺化的變更。

1. 選取**程式庫面板**，然後選取 **\$1 建立程式庫面板**。這會開啟建立對話方塊。

1. 在**程式庫面板名稱**中，輸入您要用於面板的名稱。

1. 在**儲存在資料夾中**，選取要儲存程式庫面板的資料夾。

1. 選取**建立程式庫面板**，將變更儲存至程式庫。

1. 儲存儀表板。

建立程式庫面板之後，您可以使用其上顯示的任何儀表板來修改面板。儲存變更後，程式庫面板的所有執行個體都會反映這些修改。

您也可以選取**更多...**然後建立程式庫面板，直接從任何面板的編輯功能表**建立程式庫面板**。

**將程式庫面板新增至儀表板**

當您想要將視覺化提供給其他儀表板使用者時，請將 Grafana 程式庫面板新增至儀表板。

**將程式庫面板新增至儀表板**

1. 選取左側選單上的**儀表板**。

1. 選取**新增**，然後從下拉式清單中選擇**新增儀表板**。

1. 在空白儀表板上，選取 **\$1 匯入程式庫面板**。您將看到程式庫面板的清單。

1. 篩選清單或搜尋以尋找您要新增的面板。

1. 按一下面板以將其新增至儀表板。

**取消連結程式庫面板**

當您想要對面板進行變更，且不會影響程式庫面板的其他執行個體時，請取消連結程式庫面板。

**取消連結程式庫面板**

1. 選取左側選單上的**儀表板**。

1. 選取**程式庫面板**。

1. 選取在不同儀表板中使用的程式庫面板。

1. 選取您要取消連結的面板。

1. 選取面板標題 （或將指標暫留在面板上的任何位置），以在面板的右上角顯示動作選單。

1. 選擇 **Edit** (編輯)。面板會以編輯模式開啟。

1. 選取頁面右上角的**取消連結**。

1. 選擇**是，取消連結**。

**檢視程式庫面板清單**

您可以檢視可用的程式庫面板清單，並搜尋程式庫面板。

**檢視程式庫面板清單**

1. 選取左側選單上的**儀表板**。

1. 選取**程式庫面板**。您可以查看先前定義的程式庫面板清單。

1. 如果您知道特定程式庫面板的名稱，請搜尋該程式庫面板。您也可以依資料夾或類型篩選面板。

**刪除程式庫面板**

當您不再需要程式庫面板時，請將其刪除。

**刪除程式庫面板**

1. 選取左側選單上的**儀表板**。

1. 選取**程式庫面板**。

1. 選取您要刪除之面板的程式庫面板名稱旁的刪除圖示。

# 管理儀表板版本歷史記錄
<a name="v10-dash-manage-version-history"></a>

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

每當您儲存儀表板版本時，都會儲存該版本的副本，以免遺失舊版儀表板。輸入儀表板設定，然後在左側選單中選取版本，即可取得這些**版本的**清單。

**注意**  
儀表板的最近 20 個版本會儲存。

儀表板版本歷史記錄功能可讓您比較和還原至先前儲存的儀表板版本。

**比較兩個儀表板版本**

若要比較兩個儀表板版本，請從清單中選取您要比較的兩個版本。按一下**比較版本**以檢視兩個版本之間的差異。這會引發版本差異檢視。根據預設，您會看到變更的文字摘要。

如果您想要檢視代表儀表板的原始 JSON 差異，您可以按一下底部的**檢視 JSON 差異**按鈕來執行此操作。

**還原至先前儲存的儀表板版本**

如果您需要還原至先前儲存的儀表板版本，您可以在儀表板版本清單中選取資料列右側的**還原**按鈕，或在差異檢視中選取**還原至版本 *<x>*** 按鈕。選取其中一個項目會提示您確認還原。

還原至先前的版本之後，將會建立新的版本，其中包含與先前版本相同的確切資料，但只能使用不同的版本編號。這會在新儀表板版本之資料列的**備註欄中**指出。這可確保您之前的儀表板版本不受變更影響。

# 管理儀表板連結
<a name="v10-dash-manage-dashboard-links"></a>

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

您可以使用連結在常用儀表板之間導覽，或將其他人連接到視覺化效果。連結可讓您建立其他儀表板、面板，甚至是外部網站的捷徑。

Grafana 支援儀表板連結、面板連結和資料連結。儀表板連結會顯示在儀表板頂端。按一下面板左上角的圖示，即可存取面板連結。

**選擇要使用哪個連結**

首先，了解您目前在儀表板之間導覽的方式。如果您經常在一組儀表板之間跳躍並努力在每個儀表板中找到相同的內容，連結有助於最佳化您的工作流程。

下一個步驟是找出適合您工作流程的連結類型。即使 Grafana 中的所有連結類型都用於建立其他儀表板或外部網站的捷徑，它們仍會在不同內容中運作。
+ 如果連結與大部分相關，如果不是儀表板中的所有面板，請使用儀表板連結。
+ 如果您想要深入了解特定的面板，請使用面板連結。
+ 如果您想要連結到外部網站，您可以使用儀表板連結或面板連結。
+ 如果您想要深入了解特定序列，或甚至是單一測量，請使用資料連結。

**使用 URL 控制時間範圍**

若要控制面板或儀表板的時間範圍，您可以在儀表板 URL 中提供查詢參數：
+ `from` 定義時間範圍的下限，以 ms epoch 指定。
+ `to` 定義時間範圍的上限，以 ms epoch 指定。
+ `time` 和 `time.window`定義從 `time-time.window/2`到 的時間範圍`time+time.window/2`。這兩個參數應以毫秒為單位指定。例如，`?time=1500000000000&time.window=10000`將導致從 1499999995000 到 1500000005000 的 10s 時間範圍。

**儀表板連結**

建立儀表板連結時，您可以包含時間範圍和目前範本變數，以直接跳到另一個儀表板中的相同內容。如此一來，您就不必擔心您傳送連結的人員是否正在查看正確的資料。如需其他類型的連結，請參閱[資料連結變數]()。

儀表板連結也可以用作外部系統的捷徑，例如使用目前的儀表板名稱提交 GitHub 問題。

新增儀表板連結後，它會顯示在儀表板的右上角。

**將連結新增至儀表板**

將連結新增至目前儀表板頂端的其他儀表板。

**將連結新增至儀表板**

1. 檢視您要連結的儀表板時，請按一下畫面頂端的齒輪以開啟**儀表板設定**。

1. 選取**連結**，然後**新增儀表板連結**或**新增**。

1. 在**類型**中，選取**儀表板**。

1. 從下列選取連結選項。
   + **使用標籤** – 輸入標籤，將連結的儀表板限制為您輸入的標籤。否則，Grafana 會包含所有其他儀表板的連結。
   + **下拉式清單** – 如果您要連結至許多儀表板，Grafana 預設會在儀表板頂端side-by-side顯示它們。選取此選項並新增選用標題， 會在下拉式清單中顯示連結。
   + **時間範圍** – 選取此選項以在連結中包含儀表板時間範圍。當使用者按一下連結時，連結的儀表板會開啟，並已設定指定的時間範圍。
   + **變數值** – 選取此選項，以在連結中包含目前用作查詢參數的範本變數。當使用者按一下連結時，連結儀表板中的任何相符範本都會設定為連結中的值。如需詳細資訊，請參閱[儀表板 URL 變數](v10-dash-dashboard-url-variables.md)。
   + 在**新標籤中開啟** – 如果您希望儀表板連結在新標籤或視窗中開啟，請選取此選項。

1. 按一下 **Add** (新增)。

**將 URL 連結新增至儀表板**

將連結新增至目前儀表板頂端的 URL。您可以連結到任何可用的 URL，包括儀表板、面板或外部網站。您甚至可以控制時間範圍，以確保使用者放大 Grafana 中的正確資料。

**將 URL 連結新增至儀表板**

1. 檢視您要連結的儀表板時，選取畫面頂端的齒輪以開啟**儀表板設定**。

1. 選取**連結**，然後**新增儀表板連結**或**新增**。

1. 在**類型**中，選取**連結**。

1. 從下列選取連結選項。
   + **URL** – 輸入您要連結的 URL。根據目標，您可能想要包含欄位值。
   + **標題** – 輸入您希望連結顯示的標題。
   + **工具提示** – 輸入您希望連結顯示的工具提示。
   + **圖示** – 選擇您想要與連結一起顯示的圖示。
   + **時間範圍** – 選取此選項以在連結中包含儀表板時間範圍。當使用者按一下連結時，連結的儀表板會開啟並設定指定的時間範圍。
     + `from` – 定義時間範圍的下限，以 ms epoch 指定。
     + `to` – 定義時間範圍的上限，以 ms epoch 指定。
     + `time` 和 `time.window` – 定義從 `time-time.window/2`到 的時間範圍`time+time.window/2`。這兩個參數應以毫秒為單位指定。例如，`?time=1500000000000&time.window=10000`將導致從 1499999995000 到 1500000005000 的 10s 時間範圍。
   + **變數值** – 選取此選項，以在連結中包含目前用作查詢參數的範本變數。當使用者按一下連結時，連結儀表板中的任何相符範本都會設定為連結中的值。

     變數格式如下所示：

     ```
     https://${you-domain}/path/to/your/dashboard?var-${template-varable1}=value1&var-{template-variable2}=value2
     ```
   + 在**新索引標籤中開啟** – 如果您希望儀表板連結在新索引標籤或視窗中開啟，請選取此選項

1. 選取**新增**。

**更新儀表板連結**

若要變更或更新現有的儀表板連結，請遵循此程序。

**更新儀表板連結**

1. 在**儀表板設定**的連結**索引標籤中，選取您要編輯的**現有連結。

1. 變更設定，然後選擇**更新**。

**複製儀表板連結**

若要複製現有的儀表板連結，請選取您要複製之現有連結旁的重複圖示。

**刪除儀表板連結**

若要刪除現有的儀表板連結，請選取您要刪除之連結旁的垃圾桶圖示。

**面板連結**

每個面板都可以有自己的一組連結，顯示在面板的左上角。您可以連結到任何可用的 URL，包括儀表板、面板或外部網站。您甚至可以控制時間範圍，以確保使用者放大 Grafana 中的正確資料。

若要查看可用的面板連結，請選取面板標題右側的圖示。
+ **新增面板連結**：每個面板可以有自己的一組連結，顯示在面板的左上角。您可以連結到任何可用的 URL，包括儀表板、面板或外部網站。您甚至可以控制時間範圍，以確保使用者放大 Grafana 中的正確資料。按一下面板左上角的圖示，查看可用的面板連結。

  1. 將游標暫留在您要新增連結的面板上。

  1. 選取選單，然後選擇**編輯**，或者您可以使用鍵盤快速鍵 `e`。

  1. 展開**面板選項**區段，然後向下捲動至**面板連結**。

  1. 選取**新增連結**。

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

  1. 輸入您要連結的 **URL**。按 `Ctrl+Space`（或 `Cmd+Space`)，然後選取 URL 欄位以查看可用的變數。透過將範本變數新增至面板連結，連結會將使用者傳送至正確的內容，並已設定相關變數。

     您也可以使用時間變數。
     + `from` 定義時間範圍的下限，以 ms epoch 指定。
     + `to` 定義時間範圍的上限，以 ms epoch 指定。
     + `time` 和 `time.window`定義從 `time-time.window/2`到 的時間範圍`time+time.window/2`。這兩個參數應以毫秒為單位指定。例如，`?time=1500000000000&time.window=10000`產生從 1499999995000 到 1500000005000 的 10s 時間範圍。
+ **更新面板連結**

  1. 選取面板 （或將游標放在面板上），以在面板的右上角顯示動作選單。

  1. 從功能表中，選取**編輯**。

     您也可以使用鍵盤快速鍵 `e`。

  1. 展開**面板選項**區段，然後向下捲動至**面板連結**。

  1. 尋找您要變更的連結，然後選取旁邊的**編輯** （鉛筆） 圖示。

  1. 進行任何必要變更。

  1. 選取**儲存**以儲存變更並關閉視窗。

  1. 選取右上角的儲存，將變更**儲存至**儀表板。
+ **刪除面板連結**

  1. 選取面板 （或將游標放在面板上），以在面板的右上角顯示動作選單。

  1. 從功能表中，選取**編輯**。

     您也可以使用鍵盤快速鍵 `e`。

  1. 展開**面板選項**區段，然後向下捲動至**面板連結**。

  1. 尋找您要刪除的連結，然後選取它旁邊的 **X** 圖示。

  1. 選取右上角的**儲存**，將變更儲存至儀表板。

# 註釋視覺化效果
<a name="v10-dash-annotations"></a>

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

註釋提供使用豐富事件在視覺效果上標記點的方法。它們會在所有圖形面板上以垂直線條和圖示視覺化。當您將滑鼠暫留在註釋上時，您可以取得事件描述和事件標籤。文字欄位可以包含其他系統的連結，其中包含更多詳細資訊。

您可以透過三種方式註釋視覺化效果：
+ 直接在面板中使用[內建註釋查詢](#v10-dash-built-in-query)。
+ 使用 Grafana HTTP API。
+ 在儀表板設定中設定註釋查詢。

在前兩個案例中，您要建立新的註釋，而在最後從資料來源查詢現有的註釋。內建註釋查詢也支援此功能。

本節說明第一個和第三個選項；如需使用 Grafana HTTP API 的相關資訊，請參閱 [註釋 API](Grafana-API-Annotations.md)。

下列視覺化類型支援註釋：
+ 時間序列 
+ 狀態時間軸
+ 蠟燭圖

## 在面板中建立註釋
<a name="v10-dash-create-annotations-in-panels"></a>

Grafana 能夠使用所有儀表板上存在的[內建註釋查詢，直接從面板新增註釋](#v10-dash-built-in-query)事件。您以這種方式建立的註釋會存放在 Grafana 中。

若要直接在面板中新增註釋：
+ 必須已儲存儀表板。
+ 必須啟用內建查詢。

**新增註釋**

1. 在儀表板中，選取您要新增註釋的面板。隨即顯示內容功能表。

1. 在內容功能表中，選取**新增註釋**。

1. （選用） 新增註釋描述和標籤。

1. 選取**儲存**。

或者，若要新增註釋，請在選取面板時按 `Ctrl`（或 `Cmd`)，即會顯示**新增註釋**快顯視窗。

**區域註釋**

您也可以建立註釋，以涵蓋視覺化中的區域或時段。

**新增區域註釋**

1. 在儀表板中，選取面板的區域時按 `Ctrl`（或 `Cmd`)。

1.  新增註釋描述和標籤 （選用）。

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

**編輯註釋**

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

1. 選取註釋工具提示中的**編輯** （鉛筆） 圖示。

1. 修改描述和/或標籤。

1. 選取**儲存**。

**刪除註釋**

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

1. 選取註釋工具提示中的**刪除** （垃圾桶） 圖示。

## 透過儀表板設定擷取註釋
<a name="v10-dash-fetch-annotations"></a>

在儀表板設定中，您可以在**註釋**下新增查詢，以使用任何資料來源擷取註釋，包括內建的資料註釋資料來源。註釋查詢會傳回事件，這些事件可在儀表板的圖形中視覺化為事件標記。

**新增註釋查詢**

1. 選取儀表板標頭中的**設定** （齒輪） 圖示，以開啟設定選單。

1. 選取**註釋**。

1. 按一下**新增註釋查詢**。

1. 輸入註釋查詢的名稱。

   此名稱會提供給切換 （核取方塊），可讓您啟用顯示來自此查詢的註釋事件。

1. 選取註釋的資料來源。

   您也可以選擇**開啟進階資料來源挑選器**以查看更多選項，包括新增資料來源 （僅適用於管理員）。

1. 如果您不想立即使用註釋查詢，請清除**已啟用**核取方塊。

1. 如果您不希望註釋查詢切換顯示在儀表板中，請選取**隱藏**核取方塊。

1. 選取事件標記的顏色。

1. 在**顯示**下拉式清單中，選擇下列其中一個選項：
   + **所有面板** – 註釋會顯示在支援註釋的所有面板上。
   + **選取的面板** – 註釋會顯示在您選取的所有面板上。
   + 除了 **之外的所有面板** – 除了您選取的面板之外，註釋會顯示在所有面板上。

1. 設定查詢。

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

## 內建查詢
<a name="v10-dash-built-in-query"></a>

新增註釋之後，它們仍然可見。這是因為所有儀表板上都存在內建註釋查詢。此註釋查詢將擷取來自目前儀表板的所有註釋事件，這些儀表板存放在 Grafana 中，並在建立它們的面板上顯示它們。這包括提醒狀態歷史記錄註釋。

根據預設，內建註釋查詢會使用`Grafana`特殊資料來源，且僅支援使用此資料來源的手動註釋。您可以在內建註釋查詢中使用另一個資料來源，但您只能使用該資料來源的查詢編輯器建立自動註釋。

若要直接將註釋新增至儀表板，必須啟用此查詢。

**確認已啟用內建查詢**

1. 選取儀表板標頭中的儀表板**設定** （齒輪） 圖示，以開啟儀表板設定選單。

1. 選取**註釋**。

1. 尋找**註釋和提醒 （內建） **查詢。

   如果它在查詢名稱之前顯示**已停用**，則您需要選取查詢名稱來開啟它並更新設定。

**停止擷取和繪製註釋**

1. 選取儀表板標頭中的儀表板**設定** （齒輪） 圖示，以開啟儀表板設定選單。

1. 選取**註釋**。

1. 選取**註釋和提醒 （內建） **查詢。

1. 選取**已啟用**切換以將其關閉。

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

**依標籤篩選查詢**

您可以透過將**篩選條件**設定為 ，來建立新的查詢，以使用`Grafana`資料來源從內建註釋查詢擷取註釋`Tags`。

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

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

# 儀表板 JSON 模型
<a name="v10-dash-dashboard-json-model"></a>

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

Grafana 中的儀表板由 JSON 物件表示，該物件存放其儀表板的中繼資料。儀表板中繼資料包括儀表板屬性、面板中繼資料、範本變數和面板查詢。

**檢視儀表板的 JSON**

1. 導覽至儀表板。

1. 在頂端導覽功能表中，選取**儀表板設定** （齒輪） 圖示。

1. 選取 **JSON 模型**。

## JSON 欄位
<a name="v10-dash-json-fields"></a>

當使用者建立新的儀表板時，會使用下列欄位初始化新的儀表板 JSON 物件。

**注意**  
在下列 JSON 中，id 會顯示為 null，這是在儲存儀表板之前指派給它的預設值。儲存儀表板後，系統會將整數值指派給 `id` 欄位。

```
{
  "id": null,
  "uid": "cLV5GDCkz",
  "title": "New dashboard",
  "tags": [],
  "timezone": "browser",
  "editable": true,
  "graphTooltip": 1,
  "panels": [],
  "time": {
    "from": "now-6h",
    "to": "now"
  },
  "timepicker": {
    "time_options": [],
    "refresh_intervals": []
  },
  "templating": {
    "list": []
  },
  "annotations": {
    "list": []
  },
  "refresh": "5s",
  "schemaVersion": 17,
  "version": 0,
  "links": []
}
```

以下說明儀表板 JSON 中的每個欄位。


| 名稱 | Usage | 
| --- | --- | 
| `id` | 儀表板的唯一數字識別符 （由 db 產生） | 
| `uid` | 可由任何人產生的唯一儀表板識別符。 字串 (8-40) | 
| `title` | 儀表板的目前標題 | 
| `tags` | 與儀表板相關聯的標籤，字串陣列 | 
| `style` | 儀表板佈景主題，例如 `dark`或 `light` | 
| `timezone` | 儀表板的時區，例如 `utc`或 `browser` | 
| `editable` | 儀表板是否可編輯 | 
| `graphTooltip` | 無共用十字線或工具提示 （預設） 為 0，共用十字線為 1，共用十字線為 2，共用工具提示 | 
| `time` | 儀表板的時間範圍，例如 `last 6 hours`或 `last 7 days` | 
| `timepicker` | timepicker 中繼資料，請參閱 [timepicker 區段](#v10-dash-json-panels)以取得詳細資訊 | 
| `templating` | 範本中繼資料，請參閱[範本區段](#v10-dash-json-panels)以取得詳細資訊 | 
| `annotations` | 註釋中繼資料，請參閱如何新增的[註釋](v10-dash-annotations.md)  | 
| `refresh` | 自動重新整理間隔 | 
| `schemaVersion` | JSON 結構描述的版本 （整數），會在每次 Grafana 更新對此結構描述帶來變更時遞增 | 
| `version` | 儀表板版本 （整數），每次更新儀表板時都會遞增 | 
| `panels` | 面板陣列 （如需詳細資訊，請參閱下一節） | 

## 面板
<a name="v10-dash-json-panels"></a>

面板是儀表板的建置區塊。它包含資料來源查詢、圖形類型、別名等。面板 JSON 由一組 JSON 物件組成，每個物件代表不同的面板。大多數欄位適用於所有面板，但某些欄位取決於面板類型。以下是文字面板的面板 JSON 範例。

```
"panels": [
  {
    "type": "text",
    "title": "Panel Title",
    "gridPos": {
      "x": 0,
      "y": 0,
      "w": 12,
      "h": 9
    },
    "id": 4,
    "mode": "markdown",
    "content": "# title"
  }
```

**面板大小和位置**

gridPos 屬性說明網格座標中的面板大小和位置。
+ `w` – 1 到 24 （儀表板的寬度分為 24 欄）
+ `h` – 在網格高度單位中，每個單位代表 30 個像素。
+ `x` – x 位置，與 位於相同單位`w`。
+ `y` – y 位置，與 位於相同單位`h`。

如果面板上方有空白空間，則網格具有負重力，可向上移動面板。

**Timepicker**

```
"timepicker": {
    "collapse": false,
    "enable": true,
    "notice": false,
    "now": true,
    "refresh_intervals": [
      "5s",
      "10s",
      "30s",
      "1m",
      "5m",
      "15m",
      "30m",
      "1h",
      "2h",
      "1d"
    ],
    "status": "Stable",
    "type": "timepicker"
  }
```

**範本化 **

`templating` 欄位包含 範本變數的陣列及其儲存的值，以及一些其他中繼資料。

```
"templating": {
    "enable": true,
    "list": [
       {
        "allFormat": "wildcard",
        "current":  {
          "tags": [],
          "text": "prod",
          "value": "prod"
        },
        "datasource": null,
        "includeAll": true,
        "name": "env",
        "options": [
           {
            "selected": false,
            "text": "All",
            "value": "*"
          },
           {
            "selected": false,
            "text": "stage",
            "value": "stage"
          },
           {
            "selected": false,
            "text": "test",
            "value": "test"
          }
        ],
        "query": "tag_values(cpu.utilization.average,env)",
        "refresh": false,
        "type": "query"
      },
       {
        "allFormat": "wildcard",
        "current":  {
          "text": "apache",
          "value": "apache"
        },
        "datasource": null,
        "includeAll": false,
        "multi": false,
        "multiFormat": "glob",
        "name": "app",
        "options": [
           {
            "selected": true,
            "text": "tomcat",
            "value": "tomcat"
          },
           {
            "selected": false,
            "text": "cassandra",
            "value": "cassandra"
          }
        ],
        "query": "tag_values(cpu.utilization.average,app)",
        "refresh": false,
        "regex": "",
        "type": "query"
      }
    ]
  }
```

下表說明範本欄位的使用方式。


| 名稱 | Usage | 
| --- | --- | 
|  `enable`  |  是否啟用範本  | 
|  `list`  |  物件陣列，每個代表一個範本變數  | 
|  `allFormat`  |  從資料來源擷取所有值時要使用的格式，包括 `wildcard`、`glob`、`regex`、`pipe`。  | 
|  `current`  |  在儀表板上顯示目前選取的變數文字/值  | 
|  `datasource`  |  顯示變數的資料來源  | 
|  `includeAll`  |  是否可使用所有值選項  | 
|  `multi`  |  是否可以從變數值清單中選取多個值  | 
|  `multiFormat`  |  從資料來源擷取時間序列時要使用的格式  | 
|  `name`  |  變數的名稱  | 
|  `options`  |  可在儀表板上選取的變數文字/值對陣列  | 
|  `query`  |  用來擷取變數值的資料來源查詢  | 
|  `refresh`  |  設定何時重新整理變數  | 
|  `regex`  |  擷取序列名稱或指標節點區段的一部分  | 
|  `type`  |  變數類型、`query`、 `custom`或 `interval`  | 

# 儀表板的最佳實務
<a name="v10-dash-bestpractices"></a>

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

本節提供 Grafana 管理員和使用者如何建置和維護 Grafana 儀表板的最佳實務的相關資訊。

如需有關您可以建立的不同儀表板類型的資訊，請參閱 [Grafana 儀表板：您可以在 Grafana 實驗室網站上建立部落格文章的所有不同類型的完整指南](https://grafana.com/blog/2022/06/06/grafana-dashboards-a-complete-guide-to-all-the-different-types-you-can-build/?pg=webinar-getting-started-with-grafana-dashboard-design-amer&plcmt=related-content-1)。

**注意**  
本節可協助您建立監控和儀表板維護的策略。您最了解您的系統，並應使用本節來引導您的理解。最後，您有責任為您的系統建立最佳策略。

## 常見的可觀測性策略
<a name="v10-dash-common-observability-strategies"></a>

當您有許多監控項目時，例如伺服器陣列，您需要策略來決定要監控的重要項目。此頁面說明數種常用方法來選擇要監控的內容。

邏輯策略可讓您更輕鬆地建立統一儀表板並擴展可觀測性平台。

**策略的指導方針**
+ USE 方法會告訴您機器的滿意程度，RED 方法會告訴您的使用者滿意程度。
+ 問題原因的使用報告。
+ RED 報告使用者體驗，更有可能報告問題症狀。
+ 監控兩者對於了解您的系統至關重要。最佳實務是提醒症狀，而不是原因。一般而言，警示是在 RED 儀表板上設定。

**使用方法**

USE 代表：
+ **使用率** – 資源忙碌的時間百分比，例如節點 CPU 用量。
+ **飽和度** – 資源必須執行的工作量，通常是佇列長度或節點負載。
+ **錯誤** – 錯誤事件的計數。

此方法最適合用於基礎設施中的硬體資源，例如 CPU、記憶體和網路裝置。如需詳細資訊，請參閱 Brendan Gregg 的部落格文章[「使用方法](http://www.brendangregg.com/usemethod.html)」。

**RED 方法**

RED 代表：
+ **速率** – 每秒請求數
+ **錯誤** – 失敗的請求數量。
+ **持續時間** – 這些請求所花費的時間、延遲測量的分佈。

此方法最適用於 服務，尤其是微服務環境。對於每個服務，檢測程式碼以公開每個元件的這些指標。RED 儀表板適用於提醒和 SLAs。精心設計的 RED 儀表板是使用者體驗的代理。

如需詳細資訊，請參閱 Tom Wilkie 的部落格文章 [RED 方法：如何檢測您的服務](https://grafana.com/blog/2018/08/02/the-red-method-how-to-instrument-your-services)。

**四種黃金訊號**

根據 [Google SRE 手冊](https://landing.google.com/sre/sre-book/chapters/monitoring-distributed-systems/#xref_monitoring_golden-signals)，如果您只能測量使用者面向系統的四個指標，請專注於這四個指標。

此方法類似於 RED 方法，但包含飽和度。
+ **延遲** – 處理請求所需的時間。
+ **流量** – 對系統的需求量。
+ **錯誤** – 失敗的請求率。
+ **飽和度** – 您的系統有多完整，

## 儀表板管理成熟度模型
<a name="v10-dash-management-maturity-model"></a>

*儀表板管理成熟度*是指儀表板生態系統設計和效率的良好程度。我們建議您定期檢閱儀表板設定，以衡量您的所在位置以及如何改進。

廣義而言，儀表板成熟度可以定義為低、中或高。

 本主題的大部分內容都取自 KubeCon 2019 對話 [Fool-Proof Kubernetes Dashboards for Sleep-Deprived Oncalls](https://www.youtube.com/watch?v=YE2aQFiMGfY)。

**低 – 預設狀態**

在此階段，您沒有一致的儀表板管理策略。幾乎每個人都從這裡開始。

如何告訴您在這裡？
+ 每個人都可以修改您的儀表板。
+ 大量複製的儀表板，很少或不會重複使用儀表板。
+ 永遠環繞的一次性儀表板。
+ 無版本控制 （版本控制中的儀表板 JSON)。
+ 大量瀏覽儀表板，搜尋正確的儀表板。這表示許多浪費時間嘗試尋找您需要的儀表板。
+ 沒有任何提醒可引導您前往正確的儀表板。

**中 – 系統化儀表板**

在此階段，您開始透過系統化儀表板來管理儀表板的使用。您可能已制定策略，但有一些可以改善的事項。

 如何告訴您在這裡？ 
+ 使用範本變數防止擴展。例如，每個節點不需要單獨的儀表板，您可以使用查詢變數。更好的是，您也可以讓資料來源成為範本變數，因此您可以在不同的叢集間重複使用相同的儀表板並監控後端。

  如需想法[Variables](v10-dash-variables.md)，請參閱 中的範例清單。
+ 根據[可觀測性策略](#v10-dash-common-observability-strategies)的邏輯儀表板。
+ 具有向下切入至下一個層級的階層式儀表板。
+ 儀表板設計反映服務階層。例如，您可以使用 RED 方法，每個服務一列。當您向下捲動儀表板時，資料列順序可以反映資料流程。
+ 比較類似：當大小不同時分割服務儀表板。確保彙總指標不會耗盡重要資訊。
+ 有意義地使用顏色和可正常化軸的表達式圖表。
  + 有意義的顏色範例：藍色表示很好，紅色表示不好。[閾值](v10-panels-configure-thresholds.md)可以提供幫助。
  + 標準化軸的範例：比較 CPU 用量時，請依據百分比而非原始數字進行測量，因為機器的核心數量可能不同。依核心數量標準化 CPU 用量可減少認知負載，因為檢視器可以信任 100% 使用所有核心，而不必知道 CPUs 數量。
+ 導向瀏覽可減少猜測。
  + 範本變數可讓您更難隨機或無瞄準地瀏覽。
  + 大多數儀表板都應該透過提醒連結到 。
  + 瀏覽以連結為導向。如需詳細資訊，請參閱[管理儀表板連結](v10-dash-manage-dashboard-links.md)。
+  版本控制的儀表板 JSON。

**高 – 最佳化使用**

在此階段，您已使用一致且周到的策略最佳化儀表板管理使用。它需要維護，但結果值得。
+ 主動減少擴展。
  + 定期檢閱現有的儀表板，以確保它們仍然相關。
  + 只有已新增至主儀表板清單的已核准儀表板。
  + 追蹤儀表板的使用。您可以利用[用量洞察](v10-dash-assess-dashboard-usage.md)。
+ 設計一致性。
+ 使用指令碼程式庫來產生儀表板，確保模式和樣式的一致性。
  + grafonnet (Jsonnet)
  + grafanalib (Python)
+ 在瀏覽器中不編輯。儀表板檢視器會使用變數變更檢視。
+ 瀏覽儀表板是例外狀況，而非規則。
+ 在專用的個別 Grafana 執行個體中執行實驗和測試，而非您的生產執行個體。當測試環境中的儀表板證實有用時，請將該儀表板新增至您的主要 Grafana 執行個體。

## 建立儀表板的最佳實務
<a name="v10-dash-best-practices-for-creating-dashboards"></a>

本節概述建立 Grafana 儀表板時應遵循的一些最佳實務。

**開始之前**

 以下是建立儀表板之前需要考慮的一些原則。

**儀表板應告知案例或回答問題**

您使用儀表板嘗試說什麼故事？ 嘗試建立資料的邏輯進展，例如大型到小型或一般到特定。此儀表板的目標是什麼？ （提示：如果儀表板沒有目標，請詢問自己是否真的需要儀表板。)

讓您的圖形保持簡單，並專注於回答您詢問的問題。例如，如果您的問題是「哪些伺服器有問題？」，則可能不需要顯示所有伺服器資料。只要顯示有問題的資料即可。

**儀表板應該減少認知負載，而不是新增到其中**

*認知負載*基本上是您需要多努力思考才能找出答案。讓您的儀表板易於解譯。其他使用者和未來您 （當您嘗試在2AM 點找出中斷的情況時） 將會非常感謝。

 問問自己：
+ 我是否可以知道每個圖形的確切代表什麼？ 這是顯而易見的，還是必須考慮？
+ 如果我向其他人展示此項目，他們需要多長時間才能找出答案？ 它們是否會遺失？

**制定監控策略**

建立新儀表板很容易。最佳化儀表板建立並遵循計劃較困難，但值得。此策略應同時控管您的整體儀表板結構描述，並在個別儀表板設計中強制執行一致性。

如需詳細資訊，請參閱[常見可觀測性策略](#v10-dash-common-observability-strategies)和[儀表板管理成熟度層級](#v10-dash-management-maturity-model)。

**將其寫下來**

制定策略或設計指導方針後，請將其寫下來，以協助隨著時間維持一致性。

**要遵循的最佳實務**
+ 建立新的儀表板時，請確定它具有有意義的名稱。
  + 如果您要建立儀表板來播放或實驗，請將 字`TEST`或 放在名稱`TMP`中。
  + 考慮在儀表板名稱或標籤中包含您的姓名或首字母，以便人們知道誰擁有儀表板。
  + 當您完成臨時實驗儀表板時，請將其移除。
+ 如果您建立許多相關的儀表板，請考慮如何交叉參考它們，以便於導覽。如需詳細資訊，請參閱本節稍後[管理儀表板的最佳實務](#v10-dash-best-practices-for-managing-dashboards)。
+ Grafana 從資料來源擷取資料。一般而言，了解 [連線至資料來源](AMG-data-sources.md) 和您的特定資料來源非常重要。
+ 避免不必要的儀表板重新整理，以減少網路或後端的負載。例如，如果您的資料每小時變更一次，則不需要將儀表板重新整理率設定為 30 秒。
+ 顯示具有不同單位或範圍的時間序列時，請使用左右 Y 軸。
+ 將文件新增至儀表板和面板。
  + 若要將文件新增至儀表板，請將[文字面板視覺化](v10-panels-text.md)新增至儀表板。記錄像是儀表板用途、實用資源連結，以及使用者與儀表板互動時可能需要的任何指示。
  + 若要將文件新增至面板，請編輯面板設定並新增描述。如果您將游標停留`i`在面板左上角的小型 上，您新增的任何文字都會顯示。
+ 重複使用您的儀表板，並使用[範本和變數](v10-dash-variables.md)強制執行一致性。
+ 請小心堆疊圖形資料。視覺效果可能會誤導，並隱藏重要資料。在大多數情況下，我們建議將其關閉。

## 管理儀表板的最佳實務
<a name="v10-dash-best-practices-for-managing-dashboards"></a>

 此頁面概述管理 Grafana 儀表板時應遵循的一些最佳實務。

**開始之前**

以下是開始管理儀表板之前需要考慮的一些原則。

**策略可觀測性**

有幾種[常見的可觀測性策略](#v10-dash-common-observability-strategies)。您應該研究它們，並決定其中之一是否適用於您，或是您想要自行提出。無論哪種方式，都要有計劃，將其寫下來，並堅持下去。

視需要調整您的策略以變更需求。

**成熟度層級**

您的儀表板成熟度層級為何？ 分析您目前的儀表板設定，並將其與[儀表板管理成熟度模型](#v10-dash-management-maturity-model)進行比較。了解您的所在位置可協助您決定如何到達您想要的位置。

**要遵循的最佳實務**
+ 避免儀表板擴散，這表示儀表板的不受控制成長。儀表板擴散會對尋找正確儀表板的時間產生負面影響。複製儀表板和變更「一個物件」（更差：保留原始標籤） 是最簡單的方式。
  + 定期檢閱儀表板並移除不必要的儀表板。
  + 如果您建立暫時儀表板，或許是為了測試某些項目，請在名稱前加上 `TEST:`。完成時刪除儀表板。
+ 複製沒有重大變更的儀表板並非好主意。
  + 您錯過原始儀表板的更新，例如文件變更、錯誤修正或指標的新增。
  + 在許多情況下，系統會製作複本，透過設定範本參數來自訂檢視。這應該改為透過維護主儀表板的連結，並使用 [URL 參數](v10-panels-configure-data-links.md#v10-panels-data-link-variables)自訂檢視來完成。
+ 當您必須複製儀表板時，請明確重新命名儀表板，*不要*複製儀表板標籤。標籤是搜尋期間使用的儀表板的重要中繼資料。複製標籤可能會導致錯誤相符。
+ 維護儀表板或交叉參考儀表板的儀表板。這可以透過幾種方式完成：
  + 建立儀表板連結、面板或資料連結。連結可以移至其他儀表板或外部系統。如需詳細資訊，請參閱[管理儀表板連結](v10-dash-manage-dashboard-links.md)。
  +  新增[儀表板清單面板](v10-panels-dashboard-list.md)。然後，您可以透過執行標籤或資料夾搜尋來自訂看到的內容。
  + 新增[文字面板](v10-panels-dashboard-list.md)並使用 Markdown 來自訂顯示。

# 管理儀表板
<a name="v10-dash-managing-dashboards"></a>

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

在工作區的**儀表板**頁面上 （可從左側功能表中選取**儀表板**)，您可以執行儀表板管理任務，包括將儀表板整理成資料夾。

如需建立儀表板的詳細資訊，請參閱 [建置儀表板](v10-dash-building-dashboards.md)。

## 瀏覽儀表板
<a name="v10-dash-browse-dashboards"></a>

在**儀表板**頁面上，您可以瀏覽和管理資料夾和儀表板。這包括以下選項：
+ 建立資料夾和儀表板。
+ 在資料夾之間移動儀表板。
+ 刪除多個儀表板和資料夾。
+ 導覽至資料夾。
+ 管理資料夾許可。如需詳細資訊，請參閱[儀表板和資料夾許可](dashboard-and-folder-permissions.md)。

## 建立儀表板資料夾
<a name="v10-dash-create-dashboard-folder"></a>

資料夾可協助您整理和分組儀表板，當您有許多儀表板或使用相同 Grafana 執行個體的多個團隊時，此功能非常有用。子資料夾可讓您在儀表板組織中建立巢狀階層。

**先決條件**

確保您具有 Grafana Admin 許可。如需儀表板許可的詳細資訊，請參閱 [儀表板和資料夾許可](dashboard-and-folder-permissions.md)。

**建立儀表板資料夾**

1. 登入 Grafana。

1. 在左側功能表中，選取**儀表板**。

1. 在**儀表板**頁面上，選取**新增**，然後在下拉式清單中選擇**新增資料夾**。

1. 輸入唯一的名稱，然後按一下**建立**。

**注意**  
儲存儀表板時，您可以選擇要儲存儀表板的資料夾，或建立新的資料夾。

**編輯資料夾的名稱**

1. 選取左側選單中的**儀表板**。

1. 選取要重新命名的資料夾

1. 選取標頭中的**編輯標題** （鉛筆） 圖示，並更新資料夾的名稱。

   系統會自動儲存新的資料夾名稱。

**資料夾許可**

您可以將許可指派給資料夾。資料夾中的儀表板會繼承您指派給資料夾的任何許可。您可以將許可指派給組織角色、團隊和使用者。

**修改資料夾的許可**

1. 從左側功能表中選取**儀表板**。

1. 選取清單中的資料夾。

1. 在資料夾的詳細資訊頁面上，選取**資料夾動作**，然後選取下拉式清單中的**管理許可**。

1. 視需要更新許可。

變更會自動儲存。

# 管理播放清單
<a name="v10-dash-managing-playlists"></a>

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

*播放清單*是依序顯示的儀表板清單。您可以使用播放清單來建立情境感知，或將您的指標呈現給您的團隊或訪客。Grafana 會自動將儀表板擴展到任何解析度，這使得它們非常適合大型螢幕。您可以從 **Dashboards** 子功能表中的 Grafana 側邊選單存取播放清單功能。

## 存取、共用和控制播放清單
<a name="v10-dash-access-share-control-playlist"></a>

使用本節中的資訊來存取現有的播放清單。使用五種可用模式之一啟動和控制播放清單的顯示。

**存取播放清單**

1. 從左側選單中選取**播放清單**。

1. 從現有播放清單選擇播放清單。

**啟動播放清單**

您可以在五種不同的檢視模式中啟動播放清單。檢視模式決定選單和導覽列在儀表板上的顯示方式。

根據預設，每個儀表板都會針對您在建立或編輯播放清單時所設定的**間隔**欄位中輸入的時間量顯示。啟動播放清單後，您可以使用頁面頂端的導覽列來控制播放清單。

**啟動播放清單**

1. 存取播放清單頁面以查看現有播放清單的清單。

1. 尋找您要開始的播放清單，然後按一下**開始播放清單**。

   開始播放清單對話方塊隨即開啟。

1. 根據下表中的資訊，選取五個可用的播放清單模式之一。

1. 按一下**開始 <播放清單名稱>**。

播放清單會顯示`Interval`欄位中指定時間的每個儀表板，並在建立或編輯播放清單時設定。播放清單開始後，您可以使用畫面頂端的導覽列來控制它。


| Mode | Description | 
| --- | --- | 
| 一般模式 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/grafana/latest/userguide/v10-dash-managing-playlists.html)  | 
| 電視模式 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/grafana/latest/userguide/v10-dash-managing-playlists.html)  | 
| 電視模式 （使用自動擬合面板） |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/grafana/latest/userguide/v10-dash-managing-playlists.html)  | 
| Kiosk 模式 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/grafana/latest/userguide/v10-dash-managing-playlists.html)  | 
| Kiosk 模式 （使用自動擬合面板） |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/grafana/latest/userguide/v10-dash-managing-playlists.html)  | 

**控制播放清單**

您可以在播放清單啟動後，使用螢幕頂端的導覽列，以**一般**或**電視**模式控制播放清單。按鍵盤中的 `Esc`鍵停止播放清單。


| 按鈕 | Action | 
| --- | --- | 
| 下一步 （向右雙箭頭） | 前進到下一個儀表板。 | 
| 返回 （向左箭頭） | 返回上一個儀表板。 | 
| 停止 （平方） | 結束播放清單，並結束目前的儀表板。 | 
| 週期檢視模式 （監視器圖示） | 以不同的檢視模式輪換儀表板的顯示。 | 
| 時間範圍 | 顯示時間範圍內的資料。它可以設定為使用向下箭頭顯示最後 5 分鐘到 5 年前，或自訂時間範圍。 | 
| 重新整理 （圓形箭頭） | 重新載入儀表板，以顯示目前的資料。您可以使用下拉箭頭，將其設定為每 5 秒自動重新載入至 1 天。 | 

## 建立播放清單
<a name="v10-dash-create-playlist"></a>

您可以建立播放清單，以具有設定順序和儀表板之間時間間隔的序列呈現儀表板。

**建立播放清單**

1. 從左側功能表中選取**儀表板**。

1. 在**播放清單**頁面上選取播放清單。

1. 選取**新增播放清單**。

1. 在名稱文字方塊中輸入描述性**名稱**。

1. 在間隔****文字方塊中輸入時間間隔。您新增的儀表板會依序列出。

1. 在**儀表板**中，使用**依標題新增**和**依標籤新增**下拉式清單選項，將現有的儀表板新增至播放清單。

1. 或者：
   + 依儀表板名稱、規則表達式或標籤搜尋儀表板。
   + 依星號狀態或標籤篩選結果。
   + 使用向上和向下箭頭圖示重新排列您已新增的儀表板順序。
   + 按一下儀表板旁的 **x** 圖示，從播放清單中移除儀表板。

1. 選取**儲存**以儲存變更。

## 儲存播放清單
<a name="v10-dash-save-playlist"></a>

您可以儲存播放清單並將其新增至播放**清單**頁面，您可以在其中開始播放清單。

**重要**  
在建立或編輯播放清單時，請確定您要出現在播放清單中的所有儀表板都已新增，然後再儲存。

**儲存播放清單**

1. 選取左側選單中的**儀表板**。

1. 選取**播放清單**以檢視可用的播放清單。

1. 選擇您選擇的播放清單。

1. 編輯播放清單。

1. 檢查播放清單是否具有**名稱**、**間隔**，以及至少新增一個**儀表板**。

1. 選取**儲存**以儲存變更。

## 編輯或刪除播放清單
<a name="v10-dash-edit-delete-playlist"></a>

您可以透過更新播放清單的名稱、間隔時間，以及新增、移除和重新排列儀表板順序來編輯播放清單，或者您可以刪除播放清單。

**編輯播放清單**

1. 在**播放清單頁面上選取編輯**播放清單。

1. 更新名稱和時間間隔，然後使用上述建立播放清單中的指示，從播放清單中新增或移除儀表板。

1. 選取**儲存**以儲存變更。

**刪除播放清單**

1. 選取**播放清單**。

1. 選取您要刪除的播放清單旁的**移除**。

**在播放清單中重新排列儀表板順序**

1. 在您要移動的儀表板旁，按一下向上或向下箭頭。

1. 選取**儲存**以儲存變更。

**移除儀表板**

1. 選取**移除**，從播放清單中移除儀表板。

1. 選取**儲存**以儲存變更。

## 在檢視模式中共用播放清單
<a name="v10-dash-share-playlist-view-mode"></a>

您可以在您偏好的檢視模式中複製連結地址，並將 URL 貼到您的目的地，以共用播放清單。

**在檢視模式中共用播放清單**

1. 從**儀表板**左側功能表中，選擇**播放清單**。

1. 選取您要共用的**播放清單旁的開始**播放清單。

1. 在下拉式清單中，用滑鼠右鍵按一下您偏好的檢視模式。

1. 選取**複製連結地址**，將 URL 複製到剪貼簿。

1. 將 URL 貼到您的目的地。

# 共用儀表板和面板
<a name="v10-dash-sharing"></a>

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

Grafana 可讓您與組織內的其他使用者，以及在某些情況下，在 Web 上公開共用儀表板和面板。您可以使用下列方式共用：
+ 直接連結
+ 快照
+ 匯出連結 （僅適用於儀表板）

您必須擁有授權檢視器許可，才能查看由直接連結轉譯的影像。

當您以快照形式共用面板或儀表板時，快照 （在您拍攝快照時為面板或儀表板） 可在 Web 上公開取得。具有連結的任何人都可以存取它。由於快照不需要任何授權即可檢視，Grafana 會移除與其來源帳戶相關的資訊，以及快照中的任何敏感資料。

## 共用儀表板
<a name="v10-dash-share-dashboard"></a>

您可以直接連結或快照形式共用儀表板。您也可以匯出儀表板。

**注意**  
如果您變更儀表板，請確定您在共用之前儲存變更。

**共用儀表板**

1. 從工作區的左側選單中選取**儀表板**。

1. 選擇您要共用的儀表板。

1. 選取畫面頂端的共用圖示。

   共用對話方塊隨即開啟，並顯示**連結**索引標籤。

**共用直接連結**

**連結**索引標籤會顯示目前的時間範圍、範本變數和預設佈景主題。您也可以共用縮短的 URL。

**共用直接連結**

1. 選取**複製**。此動作會將預設或縮短的 URL 複製到剪貼簿。

1. 將複製的 URL 傳送給具有檢視連結授權的 Grafana 使用者。

**發佈快照**

儀表板快照公開共用互動式儀表板。Grafana 會去除敏感資料，例如查詢 （指標、範本和註釋） 和面板連結，只留下內嵌在儀表板中的可見指標資料和序列名稱。具有連結的任何人都可以存取儀表板快照。

您可以將快照發佈至本機執行個體。

**發佈快照**

1. 選取**快照**索引標籤。

1. 選取**本機快照**。

1. Grafana 會產生快照的連結。複製快照連結，並在組織內部或 Web 上公開共用。

**匯出儀表板**

Grafana 儀表板可以輕鬆匯出和匯入。如需詳細資訊，請參閱 中的匯入和匯出區段[建置儀表板](v10-dash-building-dashboards.md)。

## 共用面板
<a name="v10-dash-share-panel"></a>

您可以直接連結或快照形式共用面板。您也可以在任何面板上使用**共用**選項來建立程式庫面板。

**共用面板**

1. 選取您要共用之面板的面板標題。面板功能表隨即開啟。

1. 選取**共用**。共用對話方塊隨即開啟，並顯示**連結**索引標籤。

**使用直接連結**

**連結**索引標籤會顯示目前的時間範圍、範本變數和預設佈景主題。您可以選擇性地啟用縮短的 URL 來共用。

**使用直接連結**

1. 選取**複製**，將預設或縮短的 URL 複製到剪貼簿。

1. 將複製的 URL 傳送給具有檢視連結授權的 Grafana 使用者。

**發佈面板的快照**

面板快照是互動式面板的公開共享。Grafana 會去除敏感資料，只留下內嵌在儀表板中的可見指標資料和序列名稱。具有連結的任何人都可以存取面板快照。

您可以將快照發佈至本機執行個體。

**發佈面板的快照**

1. 在**共用面板**對話方塊中，選取**快照**標籤。

1. 選取**本機快照**。Grafana 會產生快照的連結。

1. 複製快照連結，並在組織內部或 Web 上公開共用。

如果您錯誤地建立快照，請按一下**刪除快照**，從 Grafana 執行個體中移除快照。

**建立程式庫面板**

從**共用面板對話方塊建立程式庫面板**。

**建立程式庫面板**

1. 選取**程式庫面板**。

1. 在**程式庫面板名稱**中，輸入名稱。

1. 在**儲存在資料夾中**，選取要儲存程式庫面板的資料夾。根據預設，會選取根資料夾。

1. 選取**建立程式庫面板**以儲存您的變更。

1. 儲存儀表板。

# Variables
<a name="v10-dash-variables"></a>

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

變數是值的預留位置。您可以在指標查詢和面板標題中使用變數。因此，當您使用儀表板頂端的下拉式清單變更值時，面板的指標查詢將會變更以反映新值。

變數可讓您建立更具互動性和動態的儀表板。您可以在指標查詢中使用變數，而不是硬式編碼，例如伺服器、應用程式和感應器名稱。變數會顯示為儀表板頂端的下拉式清單。這些下拉式清單可讓您輕鬆變更儀表板中顯示的資料。

對於想要允許 Grafana 檢視器快速調整視覺效果，但不想提供完整編輯許可的管理員來說，這些功能特別有用。Grafana 檢視器可以使用變數。

變數和範本也可讓您使用單一來源儀表板。如果您有多個相同的資料來源或伺服器，您可以建立一個儀表板，並使用變數來變更您正在檢視的內容。這可簡化維護並大量維護。

**範本**

範本是包含變數的任何查詢。例如，如果您管理儀表板來監控多個伺服器，您可以為每個伺服器建立儀表板，或者您可以建立一個儀表板，並使用面板搭配範本查詢，如下所示。

```
wmi_system_threads{instance=~"$server"}
```

變數值一律使用語法 var-<varname>=value 同步至 URL。

**範例**

變數會在畫面頂端的下拉式清單中列出。選取不同的變數，以查看視覺效果如何變更。

若要查看變數設定，請導覽至**儀表板設定 > 變數**。按一下清單中的變數以查看其設定。

變數可用於標題、描述、文字面板和查詢。開頭為 的文字查詢`$`是 範本。並非所有面板都會有範本查詢。

**變數最佳實務**
+ 變數下拉式清單會依其在**儀表板設定**中的變數清單中列出的順序顯示。
+ 將您經常變更的變數放在頂端，以便先顯示變數 （儀表板上最左邊）。
+ 變數預設會預先選取下拉式清單中最上方的值。如果您想要改為選擇空值，請變更變數設定，如下所示：

  1. 選取**包含所有選項**核取方塊。

  1. 在**自訂所有值**欄位中，輸入值 `+`。

**Topics**
+ [新增和管理變數](v10-dash-variable-add.md)
+ [檢查變數](v10-dash-variable-add-inspect.md)
+ [變數語法](v10-dash-variable-syntax.md)

# 新增和管理變數
<a name="v10-dash-variable-add"></a>

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

下表列出 Grafana 中的變數類型。


| 變數類型 | Description | 
| --- | --- | 
| Query | 查詢產生的值清單，例如指標名稱、伺服器名稱、感應器 IDs、資料中心等。 | 
| Custom | 使用逗號分隔清單手動定義變數選項。 | 
| Text box (文字方塊) | 顯示具有選用預設值的任意文字輸入欄位。 | 
| 常數 | 定義隱藏的常數。 | 
| 資料來源 | 快速變更整個儀表板的資料來源。 | 
| Interval | 間隔變數代表時間範圍。 | 
| 臨機操作篩選條件 | 金鑰值篩選條件會自動新增至資料來源的所有指標查詢 （僅限 Prometheus、Loki、InfluxDB 和 Elasticsearch)。 | 
| 全域變數 | 內建變數，可用於查詢編輯器中的表達式。 | 
| 鏈結變數 | 變數查詢可以包含其他變數。 | 

**Topics**
+ [輸入一般選項](#v10-dash-variable-options)
+ [新增查詢變數](#v10-dash-variable-add-query)
+ [新增自訂變數](#v10-dash-variable-add-custom)
+ [新增文字方塊變數](#v10-dash-variable-add-text)
+ [新增常數變數](#v10-dash-variable-add-constant)
+ [新增資料來源變數](#v10-dash-variable-add-datasource)
+ [新增間隔變數](#v10-dash-variable-add-internal)
+ [新增臨機操作篩選條件](#v10-dash-variable-add-adhoc)
+ [設定變數選取選項](#v10-dash-variable-add-selection)
+ [全域變數](#v10-dash-variable-add-global)
+ [鏈結變數](#v10-dash-variable-add-chained)
+ [管理變數](#v10-dash-variable-add-manage)
+ [使用 regex 篩選變數](#v10-dash-variable-add-filter)

## 輸入一般選項
<a name="v10-dash-variable-options"></a>

您必須為您建立的任何類型的變數輸入一般選項。

**輸入一般選項**

1. 導覽至您要為 建立變數的儀表板，然後選取頁面頂端的**儀表板設定** （齒輪） 圖示。

1. 在**變數**索引標籤上，選取**新增變數**。

1. 輸入變數**的名稱**。

1. 在**類型**清單中，選取**查詢**。

1. （選用） 在**標籤**中，輸入變數下拉式清單的顯示名稱。

   如果您未輸入顯示名稱，則下拉式清單為變數名稱。

1. 選擇**隱藏**選項：
   + **無選擇 （空白）** – 變數下拉式清單會顯示變數**名稱**或**標籤**值。
   + **標籤** – 變數下拉式清單只會顯示選取的變數值和向下箭頭。
   + **變數** – 儀表板上不會顯示變數下拉式清單。

## 新增查詢變數
<a name="v10-dash-variable-add-query"></a>

查詢變數可讓您撰寫資料來源查詢，以傳回指標名稱、標籤值或索引鍵的清單。例如，查詢變數可能會傳回伺服器名稱、感應器 IDs或資料中心的清單。變數值會隨著動態擷取具有資料來源查詢的選項而變更。

查詢變數通常僅支援字串。如果您的查詢傳回數字或任何其他資料類型，您可能需要將其轉換為字串，以將其用作變數。例如，對於 Azure 資料來源，您可以為此使用 [tostring](https://docs.microsoft.com/en-us/azure/data-explorer/kusto/query/tostringfunction) 函數。

查詢表達式可以包含對其他變數的參考，並實際建立連結變數。Grafana 會偵測到此情況，並在其中一個連結變數變更時自動重新整理變數。

**注意**  
每個資料來源的查詢表達式都不同。如需詳細資訊，請參閱[資料來源](AMG-data-sources.md)的文件。

**新增查詢變數**

1. 輸入一般選項，如上所述。

1. 在**資料來源**清單中，選取查詢的目標資料來源。

1. 在**重新整理**清單中，選取變數應該更新選項的時間。
   + **在儀表板載入**上 – 每次儀表板載入時都會查詢資料來源。這會使儀表板載入速度變慢，因為必須先完成變數查詢，才能初始化儀表板。
   + **在時間範圍變更** – 在儀表板時間範圍變更時查詢資料來源。只有在變數選項查詢包含時間範圍篩選條件或取決於儀表板時間範圍時，才使用此選項。

1. 在**查詢**欄位中，輸入查詢。
   + 查詢欄位會根據您的資料來源而有所不同。有些資料來源具有自訂查詢編輯器。
   + 查詢必須傳回名為 `__text`和 的值`__value`。例如，在 SQL 中，您可以使用查詢，例如 `SELECT hostname AS __text, id AS __value from MyTable`。其他語言的查詢會根據語法而有所不同。
   + 如果您在單一輸入欄位查詢編輯器中需要更多空間，請將游標暫留在欄位右下角的行上，然後向下拖曳以展開。

1. （選用） 在 **Regex** 欄位中，輸入 regex 表達式來篩選或擷取資料來源查詢傳回的名稱的特定部分。若要查看範例，請參閱[使用 regex 篩選變數](#v10-dash-variable-add-filter)。

1. 在**排序**清單中，選取要在下拉式清單中顯示之值的排序順序。預設選項**已停用**，表示將使用資料來源查詢傳回的選項順序。

1. （選用） 輸入[選擇選項](#v10-dash-variable-add-selection)。

1. 在**預覽值**中，Grafana 會顯示目前變數值的清單。檢閱它們以確保它們符合您的期望。

1. 選取**新增**，將變數新增至儀表板。

## 新增自訂變數
<a name="v10-dash-variable-add-custom"></a>

針對不會變更的值使用*自訂*變數，例如數字或字串。

例如，如果您的伺服器名稱或區域名稱永遠不會變更，則您可能想要將它們建立為自訂變數，而不是查詢變數。由於它們不會變更，您可以在[鏈結變數](#v10-dash-variable-add-chained)中使用它們，而不是其他查詢變數。這會減少 Grafana 在更新鏈結變數時必須傳送的查詢數量。

**新增自訂變數**

1. 輸入一般選項，如上所述。

1. 在**以逗號分隔的值**清單中，在以逗號分隔的清單中輸入此變數的值。您可以包含以空格和冒號分隔的數字、字串或鍵值對。例如 `key1 : value1,key2 : value2`。

1. （選用） 輸入[選擇選項](#v10-dash-variable-add-selection)。

1. 在**預覽值**中，Grafana 會顯示目前變數值的清單。檢閱它們以確保它們符合您的期望。

1. 選取**新增**，將變數新增至儀表板。

## 新增文字方塊變數
<a name="v10-dash-variable-add-text"></a>

*文字方塊*變數會顯示具有選用預設值的任意文字輸入欄位。這是最靈活的變數，因為您可以輸入任何值。如果您有高基數的指標，或想要同時更新儀表板中的多個面板，請使用此類型的變數。

**新增文字方塊變數**

1. 輸入一般選項，如上所述。

1. （選用） 在**預設值**欄位中，選取變數的預設值。如果您在此欄位中未輸入任何內容，則 Grafana 會顯示空白文字方塊，供使用者輸入文字。

1. 在**預覽值**中，Grafana 會顯示目前變數值的清單。檢閱它們以確保它們符合您的期望。

1. 選取**新增**，將變數新增至儀表板。

## 新增常數變數
<a name="v10-dash-variable-add-constant"></a>

*常數*變數可讓您定義隱藏常數。這適用於您要共用之儀表板的指標路徑字首。匯出儀表板時，常數變數會轉換為匯入選項。

常數變數*不*靈活。每個常數變數只保留一個值，除非您更新變數設定，否則無法更新。

當您有複雜的值需要包含在查詢中，但不想在每個查詢中重新輸入時，常數變數很有用。例如，如果您有名為 的伺服器路徑`i-0b6a61efe2ab843gg`，則可以將其取代為名為 的變數`$path_gg`。

**新增常數變數**

1. 輸入一般選項，如上所述。

1. 在**值**欄位中，輸入變數值。您可以輸入字母、數字和符號。如果您使用[原始格式](v10-dash-variable-syntax.md#v10-dash-variable-syntax-raw)，甚至可以使用萬用字元。

1. 在**預覽值**中，Grafana 會顯示目前變數值的清單。檢閱它們以確保它們符合您的期望。

1. 選取**新增**，將變數新增至儀表板。

## 新增資料來源變數
<a name="v10-dash-variable-add-datasource"></a>

*資料來源*變數可讓您快速變更整個儀表板的資料來源。如果您有多個資料來源的執行個體，它們可能在不同的環境中很有用。

**新增資料來源變數**

1. 輸入一般選項，如上所述。

1. 在**類型**清單中，選取變數的目標資料來源。

   您也可以選擇**開啟進階資料來源挑選器**以查看更多選項，包括新增資料來源 （僅限管理員）。如需詳細資訊，請參閱[連線至資料來源](AMG-data-sources.md)。

1. （選用） 在**執行個體名稱篩選條件**中，輸入資料來源執行個體在變數值下拉式清單中選擇的 regex 篩選條件。將此欄位保留空白，以顯示所有執行個體。

1. （選用） 輸入[選擇選項](#v10-dash-variable-add-selection)。

1. 在**預覽值**中，Grafana 會顯示目前變數值的清單。檢閱它們以確保它們符合您的期望。

1. 選取**新增**，將變數新增至儀表板。

## 新增間隔變數
<a name="v10-dash-variable-add-internal"></a>

使用*間隔*變數來表示時間範圍，例如 `1m``1h`、 或 `1d`。您可以*依時間命令將它們視為整個儀表板的群組*。間隔變數會變更資料在視覺化中的分組方式。您也可以使用自動選項，傳回每個時間範圍的固定資料點數量。

您可以使用間隔變數做為依時間分組的參數 （適用於 InfluxDB)、日期長條圖間隔 （適用於 Elasticsearch)，或做為摘要函數參數 （適用於 Graphite)。

**新增間隔變數**

1. 輸入一般選項，如上所述。

1. 在**值**欄位中，輸入您要顯示在變數下拉式清單中的時間範圍間隔。支援下列時間單位：`s (seconds)`、`m (minutes)`、`h (hours)`、`d (days)``w (weeks)`、`M (months)`、 和 `y (years)`。您也可以接受或編輯預設值：`1m,10m,30m,1h,6h,12h,1d,7d,14d,30d`。

1. （選用） 如果您想要將 **選項新增至清單，請開啟自動**`auto`選項。此選項可讓您指定目前時間範圍應分割的次數，以計算目前`auto`時間範圍。如果您將其開啟，則會顯示另外兩個選項：
   + **步驟計數** – 選取將分割目前時間範圍以計算值的次數，類似於**最大資料點**查詢選項。例如，如果目前可見的時間範圍是 30 分鐘，則`auto`間隔會將資料分組為 30 個一分鐘增量。預設值為 30 個步驟。
   + **最小間隔** – 步驟計數間隔低於的最低閾值不會分割時間。若要繼續 30 分鐘的範例，如果最小間隔設定為 2 公尺，則 Grafana 會將資料分組為 15 個兩分鐘增量。

1. 在**預覽值中**，Grafana 會顯示目前變數值的清單。檢閱它們以確保它們符合您的期望。

1. 選取**新增**，將變數新增至儀表板。

**間隔變數範例**

下列範例顯示 Graphite 函數`myinterval`中的範本變數：

```
summarize($myinterval, sum, false)
```

## 新增臨機操作篩選條件
<a name="v10-dash-variable-add-adhoc"></a>

*臨機操作篩選條件*可讓您新增鍵值篩選條件，這些篩選條件會自動新增至使用指定資料來源的所有指標查詢。與其他變數不同，您不會在查詢中使用臨機操作篩選條件。反之，您可以使用臨機操作篩選條件來寫入現有查詢的篩選條件。

**注意**  
臨機操作篩選條件變數僅適用於 Prometheus、Loki、InfluxDB 和 Elasticsearch 資料來源。

1. 輸入一般選項，如上所述。

1. 在**資料來源**清單中，選取目標資料來源。

   您也可以選擇**開啟進階資料來源挑選器**以查看更多選項，包括新增資料來源 （僅限管理員）。如需詳細資訊，請參閱[連線至資料來源](AMG-data-sources.md)。

1. 選取**新增**，將變數新增至儀表板。

**建立臨機操作篩選條件**

臨機操作篩選條件是最複雜且靈活的變數選項之一。此變數不是變數選項的一般清單，而是可讓您建置整個儀表板的臨機操作查詢。您以此方式套用的篩選條件會套用至儀表板上的所有面板。

## 設定變數選取選項
<a name="v10-dash-variable-add-selection"></a>

*選擇選項*是一項功能，可用來管理變數選項選擇。所有選擇選項都是選用的，預設為關閉。

### 多值變數
<a name="v10-dash-variable-add-selection-multi"></a>

插入已選取多個值的變數很棘手，因為它不會直接將多個值格式化為在使用變數的指定內容中有效的字串。Grafana 嘗試透過允許每個資料來源外掛程式通知範本插補引擎要用於多個值的格式來解決此問題。

**注意**  
變數上的**自訂所有值**選項必須為空白，Grafana 才能將所有值格式化為單一字串。如果保留空白，則 Grafana 會串連 （加在一起） 查詢中的所有值。例如 `value1,value2,value3`。如果使用自訂`all`值，則值將改為 `*`或 `all`。

**具有 Graphite 資料來源的多值變數**

Graphite 使用 glob 表達式。在此情況下，具有多個值的變數會被插入，就`{host1,host2,host3}`好像目前的變數值是 *host1*、*host2* 和 *host3*。

**具有 Prometheus 或 InfluxDB 資料來源的多值變數**

InfluxDB 和 Prometheus 使用 regex 表達式，因此相同的變數會插入為 `(host1|host2|host3)`。每個值也會逸出 regex。如果不是，具有 regex 控制字元的值會破壞 regex 表達式。

**具有彈性資料來源的多值變數**

Elasticsearch 使用 lucene 查詢語法，因此相同的變數格式為 `("host1" OR "host2" OR "host3")`。在這種情況下，每個值都會逸出，因此該值只包含 lucene 控制單字和引號。

**對多值變數進行故障診斷**

自動逸出和格式化可能會導致問題，並且很難掌握背後的邏輯。特別是對於使用 regex 語法的 InfluxDB 和 Prometheus，需要在 regex 運算子內容中使用 變數。

如果您不希望 Grafana 執行此自動 regex 逸出和格式化，則必須執行下列其中一項操作：
+ 關閉**多值**或**包含所有選項**選項。
+ 使用[原始格式](v10-dash-variable-syntax.md#v10-dash-variable-syntax-raw)。

### 包含所有選項
<a name="v10-dash-variable-add-multi-all"></a>

Grafana 會將 `All`選項新增至變數下拉式清單。如果使用者選取此選項，則會選取所有變數選項。

### 自訂所有值
<a name="v10-dash-variable-add-multi-custom"></a>

只有在選取**包含所有選項時，**才會顯示此選項。

在**自訂所有值**欄位中輸入 regex、glob 或 lucene 語法，以定義`All`選項的值。

根據預設，該`All`值包含合併表達式中的所有選項。這可能會變得很長，並可能有效能問題。有時候，最好指定自訂的所有值，例如萬用字元規則運算式。

若要在自訂**所有值**選項中具有自訂 regex、glob 或 lucene 語法，它永遠不會逸出，因此您必須考慮資料來源的有效值。

## 全域變數
<a name="v10-dash-variable-add-global"></a>

Grafana 具有全域內建變數，可用於查詢編輯器中的表達式。本主題會依字母順序列出並加以定義。這些變數在查詢、儀表板連結、面板連結和資料連結中很有用。

**\$1\$1\$1儀表板**

此變數是目前儀表板的名稱。

**\$1\$1\$1from 和 \$1\$1\$1to**

Grafana 有兩個內建的時間範圍變數： `$__from`和 `$__to`。根據預設，它們目前一律會插入為 epoch 毫秒，但您可以控制日期格式。


| 語法 | 範例結果 | Description | 
| --- | --- | --- | 
|  `${__from}`  |  1594671549254  |  Unix 毫秒 epoch  | 
|  `${__from:date}`  |  2020-07-13T20：19：09.254Z  |  無 args，預設為 ISO 8601/RFC 3339  | 
|  `${__from:date:iso}`  |  2020-07-13T20：19：09.254Z  |  ISO 8601/RFC 3339  | 
|  `${__from:date:seconds}`  |  1594671549  |  Unix 秒 epoch  | 
|  `${__from:date:YYYY-MM}`  |  2020-07  |  不包含 ： 字元的任何自訂日期格式  | 

上述語法也適用於 `${__to}`。

**\$1\$1\$1interval**

您可以使用 `$__interval`變數做為依時間分組的參數 （適用於 InfluxDB、MySQL、Postgres、MSSQL)、日期長條圖間隔 （適用於 Elasticsearch)，或做為*摘要*函數參數 （適用於 Graphite)。

Grafana 會自動計算可用於在查詢中依時間分組的間隔。當有比圖形上顯示的更多資料點時，可以透過按較大的間隔分組來提高查詢的效率。例如，如果您正在查看 3 個月的資料圖表，則可能無法在分鐘層級查看詳細資訊。按小時或天分組可讓查詢更有效率，而不會影響圖形顯示的內容。`$__interval` 使用時間範圍和圖形寬度 （像素數） 計算。

近似值計算： `(to - from) / resolution`

例如，當時間範圍為 1 小時且圖形為全螢幕時，間隔可能會計算為 `2m` - 點以 2 分鐘的間隔分組。如果時間範圍為 6 個月且圖形為全螢幕，則間隔可能是 `1d`(1 天） - 點會依天分組。

在 InfluxDB 資料來源中，舊版變數`$interval`是相同的變數。 `$__interval`應該改用 。

InfluxDB 和 Elasticsearch 資料來源具有用於硬式編碼間隔或設定`$__interval`變數下限`Group by time interval`的欄位 （使用`>`語法，例如 `>10m`)。

**\$1\$1\$1interval\$1ms**

此變數是以毫秒為單位的`$__interval`變數，而不是時間間隔格式的字串。例如，如果 `$__interval`是 `20m`，則 `$__interval_ms`是 `1200000`。

**\$1\$1\$1org**

此變數是目前組織的 ID。 `${__org.name}`是目前組織的名稱。

**\$1\$1\$1user**

`${__user.id}` 是目前使用者的 ID。 `${__user.login}` 是目前使用者的登入控制代碼。 `${__user.email}`是目前使用者的電子郵件。

**\$1\$1\$1range**

僅支援 Prometheus 和 Loki 資料來源。此變數代表目前儀表板的範圍。它由 計算`to - from`。它有一個毫秒，第二個表示法稱為 `$__range_ms`和 `$__range_s`。

**\$1\$1\$1rate\$1interval**

僅支援 Prometheus 資料來源。`$__rate_interval` 變數旨在用於 速率函數。

**\$1timeFilter 或 \$1\$1\$1timeFilter**

`$timeFilter` 變數會傳回目前選取的時間範圍做為表達式。例如，時間範圍間隔`Last 7 days`表達式為 `time > now() - 7d`。

這在幾個地方使用，包括：
+ InfluxDB 資料來源的 WHERE 子句。在查詢編輯器模式下，Grafana 會自動將其新增至 InfluxDB 查詢。您可以在文字編輯器模式中手動新增它：`WHERE $timeFilter`。
+ Azure Monitor 資料來源中的日誌分析查詢。
+ MySQL、Postgres 和 MSSQL 中的 SQL 查詢。
+ `$__timeFilter` 變數用於 MySQL 資料來源。

**\$1\$1\$1timezone**

`$__timezone` 變數會傳回目前選取的時區，`utc`或 IANA 時區資料庫的項目 （例如 `America/New_York`)。

如果目前選取的時區是*瀏覽器時間*，Grafana 會嘗試判斷您的瀏覽器時區。

## 鏈結變數
<a name="v10-dash-variable-add-chained"></a>

*鏈結變數*也稱為*連結變數*或*巢狀變數*，是在其變數查詢中具有一或多個其他變數的查詢變數。

每個資料來源的鏈結變數查詢都不同，但所有 的 內部部署都相同。您可以在允許它們的任何資料來源中使用鏈結變數查詢。

可以建立極為複雜的連結範本儀表板，深度為 5 或 10 層。在技術上，您可以達到的深度或複雜程度沒有限制，但您擁有的連結越多，查詢負載越大。

**最佳實務和秘訣**

下列實務可讓您更輕鬆地使用儀表板和變數。

**建立新的連結變數**
+ 鏈結變數會建立父/子相依性。您可以將它們想像成階梯或樹。
+ 建立新鏈結變數的最簡單方法是複製要作為新變數基礎的變數。在變數清單中，按一下變數項目右側的**複製**變數圖示來建立複本。然後，您可以將 新增至父變數的查詢。
+ 以這種方式建立的新變數會出現在清單底部。您可能需要將它拖曳到清單中的不同位置，才能使其符合邏輯順序。

**變數順序**

您可以按一下每個項目右側的向上和向下箭頭，變更儀表板變數清單中的變數順序。Grafana 會根據此清單列出由左至右的變數下拉式清單，變數位於最左上方。
+ 在子變數前面列出沒有相依性的變數。
+ 每個變數都應遵循其相依的變數。
+ 請記住，UI 中沒有指出哪些變數具有相依性關係。以邏輯順序列出變數，讓其他使用者 （和您自己） 更輕鬆。

**複雜性考量**

變數中的相依性層越多，變更變數後更新儀表板所需的時間就越長。

例如，如果您有一系列四個連結變數 （國家/地區、區域、伺服器、指標），而且您變更根變數值 （國家/地區），則 Grafana 必須對所有相依變數執行查詢，才能更新儀表板中的視覺效果。

## 管理變數
<a name="v10-dash-variable-add-manage"></a>

變數頁面可讓您新增變數和管理現有的變數。它也可讓您[檢查](v10-dash-variable-add-inspect.md)變數，並識別在其他變數或儀表板中是否參考 （或使用） 變數。

**移動** – 您可以使用拖放將變數向上或向下移動清單。

**複製** – 若要複製變數，請按一下右側的一組圖示中的複製圖示。這會建立變數的複本，其名稱為字首為 的原始變數`copy_of_`。

**刪除** – 若要刪除變數，請按一下右側的一組圖示中的垃圾桶圖示。

## 使用 regex 篩選變數
<a name="v10-dash-variable-add-filter"></a>

使用 Regex 查詢選項，您可以篩選變數查詢傳回的選項清單，或修改傳回的選項。

此頁面顯示如何使用 regex 在變數下拉式清單中篩選/修改值。

使用 Regex 查詢選項，您可以篩選變數查詢傳回的選項清單，或修改傳回的選項。如需詳細資訊，請參閱[規則表達](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions)式上的 Mozilla 指南。

下列範例顯示篩選下列選項清單

```
backend_01
backend_02
backend_03
backend_04
```

**篩選，只`02`傳回以 `01`或 結尾的選項**

Regex：

```
/
(
01|02 
) 
$/
```

結果：

```
backend_01
backend_02
```

**使用 regex 擷取群組篩選和修改選項，以傳回部分文字**

Regex：

```
/.* 
(
01|02 
)
/
```

結果：

```
01
02
```

**篩選和修改 - Prometheus 範例**

對於此選項清單：

```
up{instance="demo.robustperception.io:9090",job="prometheus"} 1 1521630638000
up{instance="demo.robustperception.io:9093",job="alertmanager"} 1 1521630638000
up{instance="demo.robustperception.io:9100",job="node"} 1 1521630638000
```

此 regex：

```
/. *instance="
(
[^"]*
)
.*/
```

傳回這些結果：

```
demo.robustperception.io:9090
demo.robustperception.io:9093
demo.robustperception.io:9100
```

**使用具名文字和值擷取群組進行篩選和修改**

使用具名擷取群組，您可以從變數查詢傳回的選項中擷取個別的「文字」和「值」部分。這可讓變數下拉式清單包含每個可選取值的易記名稱。

例如，在查詢 `node_hwmon_chip_names` Prometheus 指標時， `chip_name` 是該`chip`值的好朋友。因此，下列變數查詢結果：

```
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_0",chip_name="enp216s0f0np0"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_1",chip_name="enp216s0f0np1"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_2",chip_name="enp216s0f0np2"} 1
node_hwmon_chip_names{chip="0000:d7:00_0_0000:d8:00_3",chip_name="enp216s0f0np3"} 1
```

通過下列 Regex：

```
/chip_name="(?<text>[ ^ " ] + ) |chip=" (?<value >[ ^ " ] + )/g
```

會產生下列下拉式清單：

```
Display Name          Value
------------          -------------------------
enp216s0f0np0         0000:d7:00_0_0000:d8:00_0
enp216s0f0np1         0000:d7:00_0_0000:d8:00_1
enp216s0f0np2         0000:d7:00_0_0000:d8:00_2
enp216s0f0np3         0000:d7:00_0_0000:d8:00_3
```

僅支援 `text`和`value`擷取群組名稱。

# 檢查變數
<a name="v10-dash-variable-add-inspect"></a>

變數頁面可讓您輕鬆地識別在其他變數或儀表板中是否正在參考 （或使用） 變數。

任何參考或使用的變數旁邊都有綠色核取記號，而未參考的變數旁邊則有一個橘色警告圖示。此外，所有參考的變數在綠色核取記號旁都有相依性圖示。您可以選取 圖示以檢視相依性映射。您可以移動相依性映射。您可以使用滑鼠滾輪或對等項目放大或縮小。

# 變數語法
<a name="v10-dash-variable-syntax"></a>

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

面板標題和指標查詢可以使用兩種不同的語法來參考變數。
+ `$varname` – 此語法易於閱讀，但不允許您在單字中間使用變數。

  **範例**：`apps.frontend.$server.requests.count`
+ `${var_name}` – 當您想要在表達式中間使用變數時，請使用此語法。
+ `${var_name:<format>}` – 此格式可讓您進一步控制 Grafana 如何解譯值。如需詳細資訊，請參閱此清單後面的*進階變數格式選項*。
+ `[[varname]]` – 請勿使用。此語法是舊的，已棄用。它將在未來的版本中移除。

將查詢傳送至資料來源之前，會*插入*查詢，這表示變數會取代為其目前的值。在插補期間，可能會*逸出*變數值，以符合查詢語言及其使用位置的語法。例如，InfluxDB 或 Prometheus 查詢中 regex 表達式中使用的變數將逸出 regex。

**進階變數格式選項**

變數插補的格式取決於資料來源，但在某些情況下，您可能想要變更預設格式。

例如，MySQL 資料來源的預設值是將多個值以逗號分隔並加上引號：`'server01','server02'`。在某些情況下，您可能想要有一個逗號分隔的字串，不含引號：`server01,server02`。您可以使用下列進階變數格式化選項來達成此目的。

**一般語法**

語法: `${var_name:option}`

如果指定了任何無效的格式選項，則 `glob` 是預設/備用選項。

**CSV**

將具有多個值的變數格式化為逗號分隔字串。

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:csv}'
Interpolation result:  'test1,test2'
```

**分散式 - OpenTSDB**

使用 OpenTSDB 自訂格式的多個值格式化變數。

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:distributed}'
Interpolation result:  'test1,servers=test2'
```

**雙引號**

將單值和多值變數格式化為逗號分隔字串，由 逸出每個值`"`，`\"`並使用 引用每個值`"`。

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:doublequote}'
Interpolation result:  '"test1","test2"'
```

**Glob - 石灰色**

將具有多個值的變數格式化為 glob （適用於 Graphite 查詢）。

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:glob}'
Interpolation result:  '{test1,test2}'
```

**JSON**

將具有多個值的變數格式化為逗號分隔字串。

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:json}'
Interpolation result:  '["test1", "test2"]'
```

**Lucene - Elasticsearch**

使用 Elasticsearch 的 Lucene 格式的多個值格式化變數。

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:lucene}'
Interpolation result:  '("test1" OR "test2")'
```

**百分比編碼**

格式化單一和多值變數，以用於 URL 參數。

```
servers = [ 'foo()bar BAZ',  'test2' ]
String to interpolate:  '${servers:percentencode}'
Interpolation result:  'foo%28%29bar%20BAZ%2Ctest2'
```

**管道**

將具有多個值的變數格式化為管道分隔字串。

```
servers = [ 'test1.',  'test2' ]
String to interpolate:  '${servers:pipe}'
Interpolation result:  'test1.|test2'
```

**原始**

關閉資料來源特定的格式，例如 SQL 查詢中的單引號。

```
servers = [ 'test.1',  'test2' ]
String to interpolate:  '${var_name:raw}'
Interpolation result:  'test.1,test2'
```

**Regex**

將具有多個值的變數格式化為 regex 字串。

```
servers = [ 'test1.',  'test2' ]
String to interpolate:  '${servers:regex}'
Interpolation result:  '(test1\.|test2)'
```

**單引號**

將單值和多值變數格式化為逗號分隔字串，由 逸出每個值`'`，`\'`並使用 引用每個值`'`。

```
servers = [ 'test1',  'test2' ]
String to interpolate:  '${servers:singlequote}'
Interpolation result:  "'test1','test2'"
```

**Sqlstring**

將單值和多值變數格式化為逗號分隔字串，由 逸出每個值`'`，`''`並使用 引用每個值`'`。

```
servers = [ "test'1",  "test2" ]
String to interpolate:  '${servers:sqlstring}'
Interpolation result:  "'test''1','test2'"
```

**Text (文字)**

將單值和多值變數格式化為文字表示法。對於單一變數，它只會傳回文字表示法。對於多值變數，它會傳回與 結合的文字表示法`+`。

```
servers = [ "test1",  "test2" ]
String to interpolate:  '${servers:text}'
Interpolation result:  "test1 + test2"
```

**查詢參數**

將單值和多值變數格式化為查詢參數表示法。範例：`var-foo=value1&var-foo=value2`

```
servers = [ "test1",  "test2" ]
String to interpolate:  '${servers:queryparam}'
Interpolation result:  "var-servers=test1&var-servers=test2"
```

# 評估儀表板用量
<a name="v10-dash-assess-dashboard-usage"></a>

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

對於每個儀表板和資料來源，您可以存取用量資訊。

**儀表板洞察**

若要查看儀表板用量資訊，請選取頂端列中的**儀表板洞察**。

儀表板洞察會顯示下列資訊。
+ **統計資料** – 過去 30 天內的每日查詢和錯誤數量。
+ **使用者和活動** – 過去 30 天的每日檢視計數；儀表板上的最後一個活動和最近的使用者 （上限為 20)。

**資料來源洞察**

資料來源洞見提供過去 30 天內資料來源使用方式的相關資訊，例如：
+ 每天查詢數
+ 每天錯誤數
+ 每天查詢載入時間 （平均毫秒）

**尋找資料來源洞見**

1. 在工作區的主要導覽中選取**連線**。

1. 選取**資料來源**。

1. 選擇資料來源。

1. 選取 **Insights** 索引標籤。

## 存在指標
<a name="v10-dash-presence-indicator"></a>

當您登入並查看儀表板時，可以透過顯示最近與儀表板互動之使用者的頭像的上線指標，知道誰正在查看與您相同的儀表板。預設時間範圍為 10 分鐘。若要查看使用者名稱，請將滑鼠游標暫留在使用者的頭像上。頭像是根據使用者的電子郵件來自 [Gravatar](https://gravatar.com/)。

當儀表板上的作用中使用者數量超過可在存在指標內的數量時，請按一下 **\$1X** 圖示。這樣做會開啟儀表板洞察，其中包含有關最近使用者活動的詳細資訊。

## 使用洞見資料排序儀表板
<a name="v10-dash-sort-dashboards"></a>

在搜尋檢視中，您可以使用洞見資料來協助您尋找最常用、中斷和未使用的儀表板。您可以依下列方式排序儀表板。
+ 檢視
+ 錯誤
+ 檢視
+ 建立的時間
+ 更新時間

# 故障診斷儀表板
<a name="v10-dash-troubleshoot"></a>

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

 使用下列策略來協助您疑難排解常見的儀表板問題。

## 儀表板緩慢
<a name="v10-dash-dashboard-is-slow"></a>
+ 您是否嘗試在圖形上轉譯數十 （或數百或數千） 個時間序列？ 這可能會導致瀏覽器延遲。嘗試使用 `highestMax`（在 Graphite 中） 之類的函數來減少傳回的序列數目。
+ 有時序列名稱可能非常大。這會導致較大的回應大小。嘗試使用 `alias`來減少傳回序列名稱的大小。
+ 您要查詢許多時間序列還是長時間範圍？ 這兩種情況都可能導致 Grafana 或資料來源提取大量資料，這可能會減慢儀表板速度。請嘗試減少其中之一或兩者。
+ 您的網路基礎設施可能會有高負載。如果速度不一致，這可能是問題所在。

## 儀表板重新整理速率問題
<a name="v10-dash-refresh-rate-issues"></a>

根據預設，Grafana 每 30 秒會查詢您的資料來源。不過，在儀表板上設定低重新整理率會對後端造成不必要的壓力。在許多情況下，不需要經常查詢，因為資料來源不會經常傳送資料，因此每 30 秒變更一次。

我們建議下列作法：
+ 僅在必要時在儀表板、面板或變數上啟用自動重新整理。使用者可以手動重新整理瀏覽器。
+ 如果您需要自動重新整理，請將重新整理速率設定為有意義的較長時段，例如每分鐘一次、每 10 分鐘或每小時一次。
+ 檢查儀表板的時間範圍。如果您的儀表板有較長的時間範圍，例如一週，則您真的不需要自動重新整理，而且應該停用它。

## 處理或轉譯 null 資料錯誤或令人困惑
<a name="v10-dash-handling-or-rendering-null-data-is-wrong-or-confusing"></a>

有些應用程式會間歇性發佈資料；例如，只有在事件發生時才會發佈指標。根據預設，Grafana 圖形會連接資料點之間的線條，但這可能是欺騙性的。

將 **Connect null 值**選項設定為 **Always** 的圖形，將連接缺少值的行。

修正此問題的一種方法是使用長條而非行，並將**無值**選項 （在**標準選項**下） 設定為 `0`。在這種情況下，缺少的資料會顯示為圖形中沒有資料的區域。

# 在 Grafana 第 10 版中搜尋儀表板
<a name="v10-search"></a>

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

您可以依儀表板名稱和面板標題來搜尋儀表板。當您搜尋儀表板時，系統會傳回 Grafana 執行個體內可用的所有儀表板，即使您沒有檢視儀表板內容的許可。

## 使用儀表板名稱搜尋儀表板
<a name="v10-search-by-name"></a>

在搜尋列中輸入儀表板名稱的任何部分。在您輸入時，搜尋會即時傳回任何部分字串比對的結果。

儀表板搜尋為：
+ Real-time
+ *不*區分大小寫
+ 跨儲存和檔案型儀表板的功能。

**提示**  
您可以使用鍵盤方向鍵導覽結果，然後按 `Enter`開啟選取的儀表板。

## 使用面板標題搜尋儀表板
<a name="v10-search-by-title"></a>

您可以依顯示在儀表板中的面板標題來搜尋儀表板。如果面板的標題符合您的搜尋查詢，儀表板會出現在搜尋結果中。

## 依標籤篩選儀表板搜尋結果
<a name="v10-search-by-tag"></a>

標籤是整理儀表板的絕佳方式，尤其是隨著儀表板數量的增加。您可以在儀表板**設定**中新增和管理標籤。

當您選取多個標籤時，Grafana 會顯示包含所有所選標籤的儀表板。

若要依標籤篩選儀表板搜尋結果，請完成下列其中一個步驟：
+ 若要依標籤篩選儀表板搜尋結果，請選擇出現在搜尋結果右欄中的標籤。

  您可以選擇其他標籤以繼續篩選。
+ 若要查看所有可用標籤的清單，請按一下**依標籤篩選**下拉式功能表，然後選取標籤。

  系統會顯示所有標籤，當您選取標籤時，儀表板搜尋將立即篩選。

**提示**  
僅使用鍵盤時，按 `tab`鍵並導覽至**依標籤篩選**下拉式功能表，按向下箭頭鍵以啟用選單並尋找標籤，然後按 `Enter` 選取標籤。

## 命令面板
<a name="v10-search-palette"></a>

您可以使用命令調色盤來執行下列動作：
+ 搜尋並開啟儀表板和資料夾。
+ 建立儀表板和提醒規則。
+ 在 Grafana 中尋找頁面。
+ 將佈景主題變更為深色或淺色。

頂端開啟命令面板，在 MacOS 中輸入 `ctrl+k`(`cmd+k`)。您也可以在 Grafana 導覽列中選取搜尋輸入。

**注意**  
若要前往上一個步驟，請按 ，命令面板`backspace`為空。