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

# 儀表板
<a name="dashboard-overview"></a>

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

 *儀表板*是一組一或多個面板，組織並排列成一或多個資料列。Amazon Managed Grafana 隨附各種面板。Amazon Managed Grafana 可讓您輕鬆地建構正確的查詢並自訂顯示屬性，以便建立所需的儀表板。每個面板都可以與任何已設定資料來源的資料互動。

## 管理儀表板
<a name="manage-dashboards"></a>

 若要控制儀表板的期間，您可以使用儀表板右上角的 [時間範圍控制項](dashboard-time-range-controls.md) 。

 儀表板可以使用範本和變數，讓它們更具動態和互動性。如需詳細資訊，請參閱[範本和變數](templates-and-variables.md)。

 儀表板可以使用 [註釋](dashboard-annotations.md) 顯示跨面板的事件資料。這有助於將面板中的時間序列資料與其他事件建立關聯。

 儀表板可以透過各種方式輕鬆共用。如需詳細資訊，請參閱[共用儀表板](share-a-dashboard.md)。

 儀表板可以加上標籤，而儀表板挑選器可提供對特定組織中所有儀表板的快速、可搜尋存取。

## 資料列
<a name="dashboard-rows"></a>

 資料*列*是儀表板內的邏輯分隔器。它用於將面板分組在一起。

 資料列一律為 12 個*單位*寬。這些單位會根據瀏覽器的水平解析度自動擴展。您可以透過設定面板的特定寬度來控制資料列內的面板相對寬度。

 Amazon Managed Grafana 使用單位抽象來最佳化所有螢幕大小的外觀。

**注意**  
 有了 MaxDataPoint 功能，Amazon Managed Grafana 可以顯示所需的資料點數量，無論解析度或時間範圍為何。

 若要收合資料列，請選擇資料列標題。如果您在資料列摺疊的情況下儲存儀表板，儀表板會儲存為該狀態，而且在您展開資料列之前，不會載入這些圖表。

 使用重複資料列功能，根據選取的範本變數，動態建立或移除面板的整個資料列。

# 註釋
<a name="dashboard-annotations"></a>

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

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

## 原生註釋
<a name="native-annotations"></a>

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

## 新增註釋
<a name="adding-annotations"></a>

 若要新增註釋，請按 **Ctrl** 或 **Cmd**，然後選擇您要新增註釋的位置。若要從其他儀表板搜尋註釋，請在其中新增標籤。

### 新增區域註釋
<a name="adding-regions-events"></a>

 若要建立區域的註釋，請在選擇區域時按 **Ctrl** 或 **Cmd**。

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

 新增註釋後，該註釋會保持可見。這是因為所有儀表板上都存在內建註釋查詢。此註釋查詢會擷取來自目前儀表板的所有註釋事件，並將其顯示在建立它們的面板上。這包括提醒狀態歷史記錄註釋。您可以選擇**儀表板設定** （齒輪） 圖示、選擇**註釋，然後修改名為 的查詢**，以停止擷取和顯示註釋`Annotations & Alerts (Built-in)`。

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

### 依標籤查詢
<a name="annotation-query-by-tag"></a>

 您可以使用`-- Grafana --`資料來源並將**篩選條件**設定為**標籤**，來建立新的註釋查詢，以從原生註釋存放區擷取註釋。指定至少一個標籤。例如，建立名為 的註釋查詢`outages`，並指定名為 的標籤`outage`。此查詢會顯示您建立 （從任何儀表板或透過 API) 且具有 `outage`標籤的所有註釋。

根據預設，如果您在註釋查詢中新增多個標籤，Amazon Managed Grafana 只會顯示具有您提供之所有標籤的註釋。若要顯示至少包含您提供的其中一個標籤的註釋，請開啟**符合任何**標籤。

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

## 查詢其他資料來源
<a name="querying-other-data-sources"></a>

 使用註釋查詢擷取註釋事件。若要將新的註釋查詢新增至儀表板，請選擇**儀表板設定** （齒輪） 圖示，選擇 `Annotations`，然後選擇**新增**。

 指定註釋查詢的名稱。此名稱會以核取方塊顯示，用於顯示或隱藏此查詢的註釋事件。例如，您可能有兩個名為 `Deploys`和 的註釋查詢`Outages`。您可以選取或清除核取方塊，以指定要顯示的註釋。

### 註釋查詢詳細資訊
<a name="annotation-query-details"></a>

 每個資料來源的註釋查詢選項都不同。
+ [使用 Graphite 查詢編輯器的註釋](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-graphite-in-AMG.html#graphite-annotations)
+ [使用 OpenSearch 資料來源的註釋](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/ES-use-datasource.html#ES-annotations)
+ [使用 Prometheus 的註釋](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-prometheus-datasource.html#p-annotations)
+ [使用 MySQL 的註釋](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-mysql-in-AMG.html#mysql-annotations)
+ [使用 PostgreSQL 的註釋](https://docs.aws.amazon.com/en_us/grafana/latest/userguide/using-postgresql-in-AMG.html#postgresql-annotations)

# 儀表板資料夾
<a name="dashboard-folders"></a>

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

 資料夾是組織和分組儀表板的一種方式。如果您有許多儀表板或多個團隊使用相同的 Grafana 工作區，這很有用。

## 建立資料夾
<a name="how-to-create-a-folder"></a>

若要建立資料夾，請執行下列其中一項操作：
+  在側邊選單的 \$1 圖示下，選擇**建立資料夾**連結。
+  在**管理儀表板**頁面上，選擇**建立資料夾**按鈕。

 在**建立資料夾**頁面上，輸入資料夾的唯一名稱，然後選擇**建立**。

儲存儀表板時，您可以選擇現有的資料夾或建立新的資料夾。

## 管理儀表板
<a name="folders-manage-dashboards"></a>

 在**管理儀表板**頁面上，您可以執行各種任務：
+  建立資料夾。
+  建立儀表板。
+  將儀表板移至資料夾。
+  刪除多個儀表板。
+  導覽至資料夾頁面 （您可以在其中設定資料夾或其儀表板的許可）。

## 儀表板資料夾頁面
<a name="dashboard-folder-page"></a>

 若要開啟儀表板資料夾頁面，請選擇當您在搜尋結果或管理儀表板頁面的儀表板清單中的資料夾上暫停時出現的齒輪圖示。

 Dashboard Folder 頁面類似於管理 Dashboards 頁面。在儀表板資料夾頁面上，您可以執行下列任務：
+  移動或刪除資料夾中的儀表板。
+  重新命名資料夾 （在**設定**索引標籤上）。
+  設定 資料夾的許可 （由 資料夾中的儀表板繼承）。

## 許可
<a name="folder-permissions"></a>

 許可可以指派給資料夾，並由其中包含的儀表板繼承。存取控制清單 (ACL) 可用來指派**組織角色**、**團隊**和個別**使用者**許可。如需詳細資訊，請參閱[儀表板和資料夾許可](dashboard-and-folder-permissions.md)。

# 播放清單
<a name="dashboard-playlist"></a>

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

 播放清單是序列中顯示的儀表板清單。您可以使用播放清單來建立情境感知，或將您的指標呈現給您的團隊或訪客。

 Amazon Managed Grafana 會自動將儀表板擴展到任何解析度，包括大螢幕。

 您可以從 **Dashboards** 子功能表中的側邊選單存取**播放清單**功能。

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

 播放清單會依序顯示儀表板，其中包含設定的順序和儀表板之間的時間間隔。

1.  若要存取**播放清單**功能，請在側邊選單上暫停。

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

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

1.  在 **名稱** 文字方塊中，輸入播放清單的名稱。

1.  在 **間隔** 文字方塊中，輸入時間間隔。

     時間間隔 是  Amazon Managed Grafana 在 進入 播放清單中  的 下一個 儀表板 之前  ，停留  在特定儀表板  上的 時間  量。

1.  在您要新增至播放清單的每個儀表板旁，選擇**新增至播放清單**。

1.  選擇**建立**。

## 編輯播放清單
<a name="edit-a-playlist"></a>

 您可以在建立播放清單時或在儲存播放清單之後編輯播放清單。

1.  若要存取播放清單功能，請在側邊選單上暫停。

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

1.  選擇您要編輯的播放清單。

### 編輯播放清單的名稱
<a name="edit-the-name-of-a-playlist"></a>

1. 選擇**名稱**文字方塊。

1.  編輯名稱。

1.  選擇**儲存**，以儲存變更。

### 編輯播放清單的間隔
<a name="edit-the-interval-of-a-playlist"></a>

1.  選擇**間隔**文字方塊。

1.  編輯間隔。

1.  選擇**儲存**，以儲存變更。

### 將儀表板新增至播放清單
<a name="add-a-dashboard-to-a-playlist"></a>

1.  在您要新增的儀表板旁，選擇**新增至播放清單**。

1.  選擇**儲存**，以儲存變更。

### 搜尋要新增的儀表板
<a name="search-for-a-dashboard-to-add"></a>

1. 在**新增儀表板**下，選擇**依名稱搜尋儀表板**文字方塊。

1.  輸入名稱或規則表達式。

1. 如有需要，請依星號狀態或標籤篩選結果。根據預設，您的星號儀表板會顯示為新增到播放清單的選項。

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

### 重新排列儀表板順序
<a name="rearrange-dashboard-order"></a>

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

1.  選擇**儲存**，以儲存變更。

### 移除儀表板
<a name="remove-a-dashboard"></a>

1.  選擇 x 圖示，從播放清單中移除儀表板。

1.  選擇**儲存**，以儲存變更。

### 刪除播放清單
<a name="delete-a-playlist"></a>

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

1.  在您要刪除的播放清單旁，選擇 x 圖示。

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

 您可以儲存播放清單以將其新增至播放清單頁面，您可以在其中啟動播放**清單**。在儲存之前，請務必新增要出現在播放清單中的所有儀表板。

1.  若要存取**播放清單**功能，請在側邊選單上暫停。

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

1.  選擇播放清單。

1.  編輯播放清單。

   請確定您的播放清單已新增**名稱**、**間隔**和至少一個**儀表板**。

1.  選擇**儲存**。

## 啟動播放清單
<a name="start-a-playlist"></a>

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

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

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

1.  在您要開始的播放清單旁，選擇**開始播放清單**。

1.  在下拉式清單中，選擇下列其中一個顯示模式：
   +  **一般模式** 
     +  側邊選單會保持可見。
     +  導覽列、列和面板控制項會出現在畫面頂端。
   +  **電視模式** 
     +  側邊選單會隱藏或移除。
     +  導覽列、列和面板控制項會出現在畫面頂端。
     +  使用者閒置 1 分鐘後，電視模式會自動開啟。
     +  您可以使用 **d v** 序列捷徑，或將 參數附加`?inactive`至儀表板 URL，以手動開啟電視模式。
     +  您可以使用任何滑鼠移動或鍵盤動作來停用電視模式。
   +  **電視模式 （使用自動擬合面板）** 
     +  側邊選單會隱藏或移除。
     +  導覽列、列和面板控制項會出現在畫面頂端。
     +  儀表板面板會自動調整以最佳化螢幕上的空間。
   +  **Kiosk 模式** 
     +  側邊選單、導覽列、列和面板控制項會完全隱藏或從檢視中移除。
     +  您可以在播放清單啟動後，使用 **d v** 序列捷徑手動開啟 Kiosk 模式。
     +  您可以使用相同的捷徑手動關閉 Kiosk 模式。
   +  **Kiosk 模式 （使用自動擬合面板）：**
     +  側邊選單、導覽列、列和面板控制項會完全隱藏或從檢視中移除。
     +  儀表板面板會自動調整以最佳化螢幕上的空間。

## 控制播放清單
<a name="control-a-playlist"></a>

 您可以在播放清單啟動****後，使用螢幕頂端的導覽列來控制**播放**清單。


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

 若要從鍵盤停止播放清單，請按 **Esc**。

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

您可以在您想要的檢視模式中複製 URL，並將 URL 貼到您的目的地，以共用播放清單。

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

1.  在您要共用的播放清單旁，選擇**開始播放清單**，然後選擇您想要的檢視模式。

1.  若要將 URL 複製到剪貼簿，請選擇**複製連結地址**。

    例如，在 Kiosk 模式中 Grafana Play 網站上的播放清單 URL 可以是 `https://play.grafana.org/d/000000010/annotations?orgId=1&kiosk` 

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

# 儀表板搜尋
<a name="dashboard-search"></a>

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

 儀表板可以依儀表板名稱搜尋、依一個 （或多個） 標籤篩選，或依星號狀態篩選。儀表板搜尋可透過儀表板選擇器存取，可在儀表板頂端導覽列中取得。您也可以使用捷徑 **F** 開啟儀表板搜尋。

僅使用鍵盤時，您可以使用鍵盤方向鍵導覽結果，然後按 **Enter** 開啟所需的儀表板。

## 依儀表板名稱尋找
<a name="find-by-dashboard-name"></a>

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

儀表板搜尋如下：
+ 即時
+ 不區分大小寫
+  跨儲存和檔案型儀表板的功能

## 依標籤篩選
<a name="filter-by-tags"></a>

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

 若要依標籤篩選儀表板清單，請選擇出現在右欄中的任何標籤。您可以選擇其他標籤，進一步篩選清單。

若要查看所有可用標籤的清單，請選擇**依標籤篩選**下拉式功能表。當您選取標籤時，儀表板搜尋會立即篩選。

僅使用鍵盤時，按 **Tab** 以聚焦於標籤連結，按向下箭頭鍵尋找標籤，然後按 **Enter** 選取標籤。

**注意**  
 選取多個標籤時，Amazon Managed Grafana 會顯示包含所有標籤的儀表板。

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

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

 若要共用儀表板，請選擇頂端導覽列中的**共用儀表板** （共用圖示）。這會開啟**共用**對話方塊，您可以在其中取得目前儀表板的連結，其中包含目前選取的時間範圍和範本變數。如果您已變更儀表板，請務必先儲存這些變更，再複製連結。

## 儀表板快照
<a name="dashboard-snapshot"></a>

 儀表板快照是公開共用互動式儀表板的即時方式。建立快照時，Amazon Managed Grafana 會去除敏感資料，例如查詢 （指標、範本和註釋） 和面板連結，只留下內嵌在儀表板中的可見指標資料和序列名稱。儀表板快照可由擁有連結且可到達 URL 的任何人存取。

## 發佈快照
<a name="publish-snapshots"></a>

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

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

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

 選擇面板標題以開啟面板功能表，然後在面板功能表中選擇**共用**以開啟**共用面板**對話方塊。您可以複製連結，這會帶您使用目前時間範圍和選取的範本變數，確切地前往此面板。

# 時間範圍控制項
<a name="dashboard-time-range-controls"></a>

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

 Amazon Managed Grafana 提供多種方式，可在儀表板層級和面板層級管理要視覺化的資料時間範圍。

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

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

## 時間單位和相對範圍
<a name="time-units-and-relative-ranges"></a>

 支援下列時間單位：
+ `s` （秒）
+ `m` （分鐘）
+ `h` （小時）、
+ `d` （天）
+ `w` （週）
+ `M` （月）
+ `y` （年）

 使用減號運算子回到相對於現在的時間。若要顯示單位的完整期間 （例如日、週或月），請附加 `/<time unit>`。

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

 以下是一些範例：


|  相對範圍範例  |  從  |  到  | 
| --- | --- | --- | 
|  過去 5 分鐘  |  now-5m  |  now  | 
|  到目前為止的那一天  |  now/d  |  now  | 
|  本週  |  now/w  |  now/w  | 
|  週迄今  |  now/w  |  now  | 
|  上個月  |  now-1M/M  |  now-1M/M  | 

## 常見時間範圍控制
<a name="common-time-range-controls"></a>

 儀表板和面板時間控制具有通用的使用者介面，具有下列選項。

### 目前時間範圍
<a name="current-time-range"></a>

 目前時間範圍也稱為*時間挑選器*，會顯示目前顯示在您正在檢視的儀表板或面板中的時間範圍。

 在欄位上暫停，以查看範圍中的確切時間戳記及其來源，例如本機瀏覽器。

 若要變更時間範圍，請在目前的時間範圍中選擇 。您可以使用*相對時間範圍變更目前時間*，例如過去 15 分鐘，或是*絕對時間範圍*，例如 `2020-05-14 00:00:00 to 2020-05-15 23:59:59`。

### 相對時間範圍
<a name="relative-time-range"></a>

 從相對時間範圍清單中選取**相對時間範圍**。以下是相對時間範圍的一些範例：
+  過去 30 分鐘 
+  過去 12 小時 
+  過去 7 天 
+  過去 2 年 
+  昨天 
+  前一天 
+  上週這一天 
+  目前為止 
+  本週到目前為止 
+  本月到目前為止 

### 絕對時間範圍
<a name="absolute-time-range"></a>

 以兩種方式之一設定絕對時間範圍：
+  在**從**和**到**欄位中輸入值。您可以輸入確切的時間值或相對值，例如 `now-24h`，然後選擇**套用時間範圍**。
+  選擇**從**或**到**欄位。Amazon Managed Grafana 會顯示行事曆。選擇您要用作目前時間範圍的日期，然後選擇**套用時間範圍**。

 Amazon Managed Grafana 也會顯示最近使用的絕對範圍。

### 縮小 (Cmd\$1Z 或 Ctrl\$1Z)
<a name="zoom-out-cmdz-or-ctrlz"></a>

 若要在儀表板或面板視覺化中檢視較大的時間範圍，請選擇**時間範圍縮小**圖示。

### 放大 （僅適用於圖形視覺化）
<a name="zoom-in-only-applicable-to-graph-visualizations"></a>

 在圖形視覺化中，拖曳 以選取要檢視的時間範圍。

### 重新整理儀表板
<a name="refresh-dashboard"></a>

 選擇**重新整理儀表板**圖示，以立即在儀表板上執行每個查詢，並重新整理視覺效果。開始新的重新整理時，Amazon Managed Grafana 會取消任何待處理的請求。

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

## 儀表板時間設定
<a name="dashboard-time-settings"></a>

 時間設定是以每個儀表板為基礎儲存。

 若要存取儀表板時間設定，請選擇畫面頂端的**儀表板設定** （齒輪） 圖示。設定位於**一般**索引標籤**的時間選項**區段中。
+  **時區** – 您要監控之服務或系統的本機時區。當您監控跨多個時區運作的系統或服務時，這會很有幫助。
  +  **預設** – 使用者設定檔、團隊或組織的預設選取時區。如果未為使用者設定檔、使用者所屬的團隊或組織指定時區，Amazon Managed Grafana 會使用本機瀏覽器時間。
  +  **瀏覽器時間** 針對正在使用的瀏覽器設定的時區。這通常是在電腦上設定的時區。
  +  **國際標準時間** – 標準 ISO 8601 時區，包括 UTC。如需詳細資訊，請參閱[時區清單](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)。
+  **自動重新整理** – 可自訂的選項，包括相對時間和自動重新整理設定。項目以逗號分隔，可以是任何有效的時間單位。
+  **現在延遲 –** 覆寫值的時間延遲`now`值。最常見的是，此功能透過調節資料彙總中的已知延遲來避免 null 值。
+  **隱藏時間選擇器** – 不顯示時間選擇器的選項。

## 面板時間覆寫和時間轉移
<a name="panel-time-overrides-and-timeshift"></a>

 在 中[查詢選項](panel-queries.md#query-options)，您可以覆寫個別面板的相對時間範圍，導致它們與頂端導覽列中儀表板時間選擇器中選取的時間範圍不同。您可以同時顯示不同時段或天數的指標。

## 使用 URL 控制時間範圍
<a name="control-the-time-range-using-a-url"></a>

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

# 匯出和匯入儀表板
<a name="dashboard-export-and-import"></a>

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

 Amazon Managed Grafana Dashboards 可以從 UI 或 【HTTP API】 輕鬆匯出和匯入 

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

 儀表板會以 Amazon Managed Grafana JSON 格式匯出，並包含您所需的一切，包括配置、變數、樣式、資料來源和查詢，以便稍後匯入儀表板。

 匯出功能是在共享視窗中存取，您可以透過選擇儀表板功能表中的共享按鈕來開啟。

### 讓儀表板成為可攜式
<a name="making-a-dashboard-portable"></a>

 當您匯出儀表板供其他人使用時，最好為指標字首 （使用常數變數） 和伺服器名稱等值新增範本變數。

 類型 的範本變數`Constant`會自動隱藏在儀表板中。匯入儀表板時，也會將其新增為必要輸入。如需範本和範本變數的詳細資訊，請參閱 [範本和變數](templates-and-variables.md)。

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

 若要匯入儀表板，請選擇側邊選單中的 \$1 圖示，然後選擇**匯入**。

 您可以上傳儀表板 JSON 檔案、貼上儀表板 URL 或直接將儀表板 JSON 文字貼入文字區域。

 在匯入程序的步驟 2 中，您可以變更儀表板的名稱、指定您希望儀表板使用的資料來源，以及指定任何指標字首 （如果儀表板使用任何）。

## 在 https：//Grafana.com 上探索儀表板
<a name="discover-dashboards-on-grafana.com"></a>

 在 https：//[Grafana.com/dashboards](https://grafana.com/dashboards) 尋找常見伺服器應用程式的儀表板。

# 儀表板版本歷史記錄
<a name="dashboard-version-history"></a>

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

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

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

## 比較兩個儀表板版本
<a name="comparing-two-dashboard-versions"></a>

 若要比較兩個儀表板版本，請從清單中選取您要比較的兩個版本。選取兩個版本後，選擇**比較版本**以開啟差異檢視。根據預設，您會看到變更的文字摘要，如下圖所示。

 若要檢視代表儀表板的原始 JSON 差異，請選擇**檢視 JSON 差異**。

 若要還原至您要比較的較早版本，請選擇**還原至版本 <x>**。

## 還原至先前儲存的儀表板版本
<a name="restoring-to-a-previously-saved-dashboard-version"></a>

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

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

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

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

 Amazon Managed Grafana 有許多可用的鍵盤快速鍵。若要顯示 Amazon Managed Grafana 版本中可用的所有鍵盤快速鍵，請按鍵盤上的 **Shift \$1 ？**。

 **Amazon Managed Grafana 包含下列熱門捷徑：**
+  **Ctrl\$1S** 會儲存目前的儀表板。
+  **Ctrl\$1F** 會開啟儀表板搜尋工具/搜尋。
+  **Ctrl\$1H** 隱藏所有控制項 （隱藏控制項非常適合電視顯示器）。
+  **逸出**會在處於全螢幕或編輯模式時結束圖形。

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

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

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

**檢視儀表板的 JSON**

1.  開啟儀表板。

1.  在頂端導覽列上，選擇**管理儀表板**上的 。

1.  從下拉式選單中選取**檢視 JSON**。

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

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

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

```
{
  "id": null,
  "uid": "cLV5GDCkz",
  "title": "New dashboard",
  "tags": [],
  "style": "dark",
  "timezone": "browser",
  "editable": true,
  "hideControls": false,
  "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  |  儀表板的唯一數字識別符 （由資料庫產生）。 | 
|  uid  |  任何人都可以產生的唯一儀表板識別符。uid 是 8-40 個字元的字串。 | 
|  標題  |  儀表板的目前標題。 | 
|  tags  |  與儀表板相關聯的標籤。在 JSON 中，標籤是字串陣列。 | 
|  style  |  儀表板的主題 （例如， dark 或 light)。 | 
|  timezone  |  儀表板的時區 (utc 或 browser)。 | 
|  editable  |  是否可以編輯儀表板。 | 
|  graphTooltip  |  工具提示樣式。[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/grafana/latest/userguide/dashboard-json-model.html)  | 
|  time  |  儀表板的時間範圍 （例如， 過去 6 小時、過去 7 天）。 | 
|  timepicker  |  Timepicker 中繼資料。如需詳細資訊，請參閱[時間挑選器](#dashboard-json-timepicker)。 | 
|  templating  |  範本中繼資料。如需詳細資訊，請參閱[範本和變數](templates-and-variables.md)。 | 
|  annotations  |  註釋中繼資料。如需詳細資訊，請參閱[註釋](dashboard-annotations.md)。 | 
|  refresh  |  自動重新整理間隔。 | 
|  schemaVersion  |  JSON 結構描述的版本 （整數），會在每次 Amazon Managed Grafana 更新變更結構描述時遞增。 | 
|  version  |  儀表板的版本 （整數），會在每次更新儀表板時遞增。 | 
|  panels  |  面板陣列。如需詳細資訊，請參閱[面板](#dashboard-JSON-panels)。 | 

## 面板
<a name="dashboard-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"
  }
```

### 面板大小和位置
<a name="panel-size-and-position"></a>

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

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

### 時間挑選器
<a name="dashboard-json-timepicker"></a>

下列範例顯示 `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"
  }
```

 下表提供 的使用詳細資訊`timepicker`。


|  名稱  |  Usage  | 
| --- | --- | 
|  collapse  |  timepicker 是否收合  | 
|  enable  |  timepicker 是否已啟用  | 
|  notice  |  TODO  | 
|  now  |  TODO  | 
|  refresh\$1intervals  |  TODO  | 
|  status  |  TODO  | 
|  type  |  TODO  | 

### 範本化
<a name="json-templating"></a>

 `templating` 欄位包含具有儲存值和其他中繼資料的範本變數陣列。下列範例顯示`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  | 
| --- | --- | 
|  啟用  |  是否啟用範本。 | 
|  清單  |  物件陣列，每個代表一個範本變數  | 
|  allFormat  |  從資料來源擷取所有值時要使用的格式 （例如 wildcard、regex、 glob和 pipe)。 | 
|  目前  |  在儀表板上顯示目前選取的變數文字或值  | 
|  資料來源  |  顯示變數的資料來源  | 
|  includeAll  |  是否可使用所有值選項  | 
|  多重  |  是否可以從變數值清單中選取多個值  | 
|  multiFormat  |  從資料來源擷取時間序列時要使用的格式  | 
|  name  |  變數的名稱  | 
|  options  |  可在儀表板上選取的變數文字/值對陣列  | 
|  query  |  用來擷取變數值的資料來源查詢  | 
|  重新整理  |  TODO  | 
|  regex  |  TODO  | 
|  type  |  變數的類型 (custom、 query或 interval)  | 

# 指令碼儀表板
<a name="scripted-dashboards"></a>

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

**警告**  
 此功能已棄用，並將在未來版本中移除。

 如果您有許多指標名稱在定義的模式中變更 （例如新伺服器），則持續建立新儀表板可能會很耗時。

 使用指令碼儀表板，您可以使用 JavaScript 動態建立儀表板。在 Grafana 安裝資料夾中，`public/dashboards/`有一個名為 的檔案`scripted.js`。此檔案包含指令碼儀表板的範例。您可以使用 URL 來存取它： `http://grafana_url/dashboard/script/scripted.js?rows=3&name=myName`

 當您開啟 時`scripted.js`，您可以查看它如何從`ARGS`變數讀取 URL 參數，然後新增資料列和面板。

## 範例：Scripted.js
<a name="example"></a>

```
var seriesName = 'argName';

if (!_.isUndefined(ARGS.name)) {
  seriesName = ARGS.name;
}

dashboard.panels.push({
  title: 'Events',
  type: 'graph',
  fill: 1,
  linewidth: 2,
  gridPos: {
    h: 10,
    w: 24,
    x: 0,
    y: 10,
  },
  targets: [
    {
      target: "randomWalk('" + seriesName + "')",
    },
    {
      target: "randomWalk('random walk2')",
    },
  ],
});

return dashboard;
```

## 更多 範例
<a name="more-examples"></a>

 您可以在 Grafana 安裝的 `public/dashboards/`目錄中找到更多範例。