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

# 建置儀表板
<a name="v9-dash-building-dashboards"></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-dash-creating.md)
+ [新增或編輯面板](v9-dash-edit-panels.md)
+ [修改儀表板設定](v9-dash-modify-settings.md)
+ [儀表板 URL 變數](v9-dash-dashboard-url-variables.md)
+ [將程式庫面板新增至儀表板](v9-dash-manage-library-panels.md)
+ [管理儀表板版本歷史記錄](v9-dash-manage-version-history.md)
+ [管理儀表板連結](v9-dash-manage-dashboard-links.md)
+ [儀表板 JSON 模型](v9-dash-dashboard-json-model.md)

# 建立儀表板
<a name="v9-dash-creating"></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-administration-authorization.md)」。
+ 識別您要新增面板的儀表板。
+ 了解目標資料來源的查詢語言。
+ 確定已新增您要為其寫入查詢的資料來源。

 若要建立儀表板：

1. 登入 Grafana，將游標暫留在**儀表板**上，然後按一下 **\$1 新增儀表板**。

1. 按一下**新增面板**。

1. 在**查詢**索引標籤的第一行中，按一下下拉式清單，然後選取資料來源。

1. 以資料來源的查詢語言撰寫或建構查詢。

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

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

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

**設定重複資料列**

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

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

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

1. 在儀表板首頁上，按一下**新增面板**。

1. 在**新增面板**對話方塊中，按一下**新增資料列**。

1. 將滑鼠暫留在資料列標題上，然後按一下齒輪圖示。

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

**移動面板**

1. 開啟儀表板。

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

**調整面板大小**

1. 開啟儀表板。

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

# 新增或編輯面板
<a name="v9-dash-edit-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)。

建立儀表板之後，您可以隨時新增、編輯或移除面板。
+ **檢視儀表板**：若要檢視儀表板，請從**首頁**功能表中選取**儀表板**，然後選擇您要檢視的儀表板。您可能需要展開包含儀表板的資料夾。
+ **新增面板**：若要將面板新增至儀表板，請在頁面頂端附近的選單列中選擇**新增面板**圖示。
+ **編輯面板** 若要編輯儀表板上的現有面板，請選擇將滑鼠游標暫留在面板上時出現的選單圖示，然後選擇**編輯**。
+ **移除面板** 若要移除儀表板上的現有面板，請選擇將游標暫留在面板上時出現的選單圖示，然後選擇**移除**。

# 修改儀表板設定
<a name="v9-dash-modify-settings"></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 模型

若要存取儀表板設定頁面：

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

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

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

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

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

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

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

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

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

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

**新增註釋查詢**

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

**新增 n 個註釋查詢**

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

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

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

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

查詢編輯器 UI 會根據您選取的資料來源而變更。如需如何建構查詢的詳細資訊，請參閱[資料來源](AMG-data-sources.md)文件。

**新增變數**

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

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

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

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

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

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

**新增連結 **

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

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

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

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

1.  若要新增連結，請新增使用者停留在連結上時顯示的 URL 和工具提示文字、選取連結旁顯示的圖示，然後選取任何儀表板連結選項。

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

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

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

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

# 儀表板 URL 變數
<a name="v9-dash-dashboard-url-variables"></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 可以在儀表板 URLs 中套用做為查詢參數傳遞的變數值。如需詳細資訊，請參閱[管理儀表板連結](v9-dash-manage-dashboard-links.md)和[範本和變數](v9-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 可以將變數新增至儀表板連結。如需新增變數的詳細資訊和步驟，請參閱[管理儀表板連結](v9-dash-manage-dashboard-links.md)。

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

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

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

例如，在此 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="v9-dash-manage-library-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)。

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

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

**建立程式庫面板**

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

1. 以編輯模式開啟面板。

1. 在面板顯示選項中，按一下向下箭頭選項，將變更帶入視覺效果。

1. 若要開啟**建立**對話方塊，請按一下**程式庫面板**選項，然後按一下**建立程式庫面板**。

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

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

1. 若要儲存變更，請按一下**建立程式庫面板**。

1. 若要儲存儀表板，請按一下**儲存**。

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

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

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

1. 將滑鼠游標暫留在左側選單的**儀表板**選項上，然後從下拉式清單選項中選取**新增儀表板**。**新增面板**對話方塊隨即開啟。

1. 按一下面板程式庫中的**新增**面板選項。您將看到程式庫面板的清單。

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

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

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

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

1. 將滑鼠游標暫留在左側選單上的**儀表板**上，然後按一下**程式庫面板**。

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

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

1. 按一下面板的標題，然後按一下**編輯**。面板會以編輯模式開啟。

1. 按一下頁面右上角的**取消連結**選項。

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

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

1. 將滑鼠游標暫留在左側選單的**儀表板**選項上，然後按一下**程式庫面板**。您可以查看先前定義的程式庫面板清單。

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

**刪除程式庫面板**

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

1. 將滑鼠游標暫留在左側選單上的**儀表板**上，然後選取**程式庫面板**。

1. 選取您要刪除的面板。

1. 按一下程式庫名稱旁的刪除圖示。

# 管理儀表板版本歷史記錄
<a name="v9-dash-manage-version-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)。

每當您儲存儀表板的版本時，都會儲存該版本的複本，如此舊版的儀表板就永遠不會遺失。輸入儀表板設定，然後在左側功能表中選取版本，即可取得這些**版本的**清單。

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

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

若要比較兩個儀表板版本，請從清單中選取您要比較的兩個版本。按一下**比較版本**以檢視兩個版本之間的差異。

按一下按鈕時，系統會將您帶到差異檢視。根據預設，您會看到變更的文字摘要。

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

如果您想要還原至您要差異的版本，您可以按一下右上角的**還原至版本 <x>** 按鈕來執行此操作。

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

如果您需要還原至先前儲存的儀表板版本，您可以按一下儀表板版本清單中資料列右側的**還原**按鈕，或按一下顯示在差異檢視中的**還原至版本 <x>** 按鈕。按一下按鈕將出現下列快顯視窗，提示您確認還原。

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

# 管理儀表板連結
<a name="v9-dash-manage-dashboard-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)。

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

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 問題](https://github.com/grafana/grafana/issues/new?title=Dashboard%3A%20HTTP%20Requests)。

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

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

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

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

1. 按一下**連結**，然後按一下**新增儀表板連結**或**新增**。

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

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

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

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

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

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

1. 按一下**連結**，然後按一下**新增儀表板連結**或**新增**。

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

1. 從下列選取連結選項。
   + **URL**：輸入您要連結的 URL。根據目標，您可能想要包含欄位值。如需詳細資訊，請參閱此 [Github 範例](https://github.com/grafana/grafana/issues/new?title=Dashboard%3A%20HTTP%20Requests)。
   + **標題**：輸入您希望連結顯示的標題。
   + **工具提示**：輸入您希望連結顯示的工具提示。
   + **圖示**：選擇您要與連結一起顯示的圖示。
   + **時間範圍**：選取此選項以在連結中包含儀表板時間範圍。當使用者按一下連結時，連結的儀表板會開啟並設定指定的時間範圍。
     + `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. 按一下 **Add** (新增)。

**更新儀表板連結**

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

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

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

**複製儀表板連結**

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

**刪除儀表板連結**

若要刪除現有的儀表板連結，請按一下您要刪除之重複圖示旁的垃圾桶圖示。

**面板連結**

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

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

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

  1. 在**面板**索引標籤上，向下捲動至**連結**區段。

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

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

  1. 輸入您要連結的 **URL**。您甚至可以新增儀表板中定義的其中一個範本變數。在 URL 欄位中按 `Ctrl+Space`或 `Cmd+Space`並按一下，以查看可用的變數。透過將範本變數新增至面板連結，連結會將使用者傳送至正確的內容，並已設定相關變數。

     您也可以使用時間變數。
     + `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. 按一下**編輯** （鉛筆） 圖示以開啟編輯連結視窗。

  1. 進行任何必要變更。

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

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

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

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

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

# 儀表板 JSON 模型
<a name="v9-dash-dashboard-json-model"></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 物件表示，該物件存放其儀表板的中繼資料。儀表板中繼資料包括儀表板屬性、面板的中繼資料、範本變數和面板查詢。

檢視儀表板的 JSON。

1. 導覽至儀表板。

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

1. 按一下 **JSON 模型**。

**JSON 欄位**

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

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

```
{
  "id": null,
  "uid": "cLV5GDCkz",
  "title": "New dashboard",
  "tags": [],
  "style": "dark",
  "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) | 
| **標題** | 儀表板的目前標題 | 
| **tags** | 與儀表板相關聯的標籤，字串陣列 | 
| **樣式** | 儀表板佈景主題，例如*深色*或*淺色* | 
| **timezone** | 儀表板的時區，例如 *utc* 或*瀏覽器* | 
| **可編輯** | 儀表板是否可編輯 | 
| **graphTooltip** | 無共用十字線或工具提示 （預設） 為 0，共用十字線為 1，共用十字線為 2，共用工具提示 | 
| **time** | 儀表板的時間範圍，例如*過去 6 小時*或*過去 7 天* | 
| **timepicker** | timepicker 中繼資料，請參閱 [timepicker 區段](#v9-dash-dashboard-json-model)以取得詳細資訊 | 
| **範本化** | 範本中繼資料，請參閱[範本區段](#v9-dash-dashboard-json-model)以取得詳細資訊 | 
| **註釋** | 註釋中繼資料，請參閱如何新增中繼資料[的註釋](v9-panels-annotate-visualizations.md)  | 
| **重新整理** | 自動重新整理間隔 | 
| **schemaVersion** | JSON 結構描述的版本 （整數），每次 Grafana 更新對上述結構描述帶來變更時都會遞增 | 
| **version** | 儀表板版本 （整數），每次更新儀表板時都會遞增 | 
| **面板** | 面板陣列 （如需詳細資訊，請參閱下文） | 

**面板**

面板是儀表板的建置區塊。它包含資料來源查詢、圖形類型、別名等。面板 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"
      }
    ]
  }
```