本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 控制面板
<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)。

 控制面板可以使用 [Annotations](dashboard-annotations.md) 跨面板显示事件数据。这有助于将面板中的时间序列数据与其他事件关联起来。

 控制面板可以通过多种方式轻松共享。有关更多信息，请参阅 [共享控制面板](share-a-dashboard.md)。

 您可以对控制面板进行标记，而通过控制面板选择器，您可以快速地、以搜索方式访问特定组织中的所有控制面板。

## 行
<a name="dashboard-rows"></a>

 *行*是控制面板中的逻辑分隔线。用于将面板分成组。

 行的宽度始终为 12 个*单位*。这些单位会根据浏览器的水平分辨率自动缩放。您可以通过设置特定宽度，控制行内面板的相对宽度。

 Amazon Managed Grafana 使用单位抽象来优化所有屏幕尺寸上的外观。

**注意**  
 借助该 MaxDataPoint 功能，无论分辨率或时间范围如何，Amazon Managed Grafana 都可以显示所需数量的数据点。

 要折叠行，请选择行标题。如果在保存控制面板时有一行处于折叠状态，则控制面板将以该状态保存，并且在展开该行之前不会加载其中的图表。

 根据所选的模板变量，使用重复行功能可以动态创建或移除整行面板。

# Annotations
<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>

 要打开“控制面板文件夹”页面，请在搜索结果中的控制面板列表上，或在“管理控制面板”页面上，将鼠标悬停在文件夹上，然后选择出现的齿轮图标。

 “控制面板文件夹”页面与“管理控制面板”页面类似。在“控制面板文件夹”页面，可以执行以下任务：
+  移动或删除文件夹中的控制面板。
+  重命名文件夹（在**设置**选项卡上）。
+  设置文件夹的权限（文件夹中的控制面板将继承此权限）。

## Permissions
<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 可自动将控制面板缩放至任何分辨率，包括大屏幕。

 您可以从**控制面板**子菜单的侧边菜单访问**播放列表**功能。

## 创建播放列表
<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 末尾来开启电视模式。
     +  您可以通过任何鼠标移动或键盘操作来禁用电视模式。
   +  **电视模式（带有自动调整面板）** 
     +  已隐藏或移除侧边菜单。
     +  导航栏、行和面板控件显示在屏幕顶部。
     +  控制面板中的面板会自动调整以优化屏幕空间。
   +  **自助服务模式** 
     +  侧边菜单、导航栏、行和面板控件会完全隐藏或从视图中移除。
     +  播放列表启动后，您可以使用 **d v** 序列快捷键手动启用自助服务模式。
     +  您可以使用相同的快捷键手动关闭自助服务模式。
   +  **自助服务模式（带有自动调整面板）：**
     +  侧边菜单、导航栏、行和面板控件会完全隐藏或从视图中移除。
     +  控制面板中的面板会自动调整以优化屏幕空间。

## 控制播放列表
<a name="control-a-playlist"></a>

 启动播放列表后，可通过屏幕顶部的导航栏，在**正常**或**电视**模式下控制播放列表。


|  按钮  |  结果  | 
| --- | --- | 
|  前进（双右箭头）  |  前进到下一个控制面板。 | 
|  后退（向左箭头）  |  返回到上一个控制面板。 | 
|  停止（方形箭头）  |  结束播放列表，退出到当前控制面板。 | 
|  循环视图模式（监视器图标）  |  将控制面板的显示更改为不同的视图模式。 | 
|  时间范围  | 显示某个时间范围内的数据。使用下拉箭头，可将其设置为显示最近 5 分钟至 5 年前的数据，或自定义时间范围。 | 
|  刷新（圆形箭头）  |  重新加载控制面板以显示当前数据。可使用下拉箭头将其设置为每 5 秒到 1 天自动重新加载一次。 | 

 要通过键盘停止播放列表，请按 **Esc** 键。

## 在视图模式下共享播放列表
<a name="share-a-playlist-in-a-view-mode"></a>

在您想要使用的视图模式中复制 URL 并粘贴到目标，就可以共享播放列表。

1.  从**控制面板**菜单中，选择**播放列表**。

1.  在要共享的播放列表旁边，选择**启动播放列表**，然后选择所需的视图模式。

1.  要将 URL 复制到剪贴板，请选择**复制链接地址**。

    例如，在自助服务模式下，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 时区，包括世界标准时间。有关详细信息，请参阅[时区列表](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)。
+  **自动刷新**：可自定义的相对时间和自动刷新设置选项。条目以逗号分隔，可以是任何有效的时间单位。
+  **现在延迟**：覆盖 `now` 值的时间延迟值。一般情况下，此功能用于通过顺应数据聚合中的已知延迟来避免空值。
+  **隐藏时间选择器**：用于不显示时间选择器的选项。

## 面板时间覆盖和时间偏移
<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`：定义时间范围的下限（以毫秒纪元或相对时间指定）。有关更多信息，请参阅 [相对时间范围](#relative-time-range)。
+  `to`：定义时间范围的上限（以毫秒纪元或相对时间指定）。有关更多信息，请参阅 [相对时间范围](#relative-time-range)。
+  `time` 和 `time.window`：定义从 `time-time.window/2` 到 `time+time.window/2` 的时间范围。两个参数都应以毫秒为单位指定。例如，`?time=1500000000000&time.window=10000` 得到 10 秒的时间范围，从 1499999995000 到 1500000005000 

# 导出和导入控制面板
<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)。

 通过用户界面或 [HTTP API]，可以轻松导出和导入 Amazon Managed Grafana 控制面板 

## 导出控制面板
<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 步，您可以更改控制面板的名称，指定希望控制面板使用的数据来源，并指定任何指标前缀（如果控制面板使用任何指标前缀）。

## 浏览 Grafana.com 上的控制面板
<a name="discover-dashboards-on-grafana.com"></a>

 在 [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** 可隐藏所有控件（隐藏控件适用于电视显示器）。
+  在全屏模式或编辑模式下，**Escape** 会退出图形。

# 控制面板 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 中每个字段的用法细节。


|  Name  |  用法  | 
| --- | --- | 
|  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_cn/grafana/latest/userguide/dashboard-json-model.html)  | 
|  time  |  控制面板的时间范围（例如，过去 6 小时，过去 7 天）。 | 
|  timepicker  |  时间选取器元数据。有关更多信息，请参阅 [时间选取器](#dashboard-json-timepicker)。 | 
|  templating  |  模板元数据。有关更多信息，请参阅 [模板和变量](templates-and-variables.md)。 | 
|  annotations  |  注释元数据。有关更多信息，请参阅 [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` 的用法细节。


|  Name  |  用法  | 
| --- | --- | 
|  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"
      }
    ]
  }
```

 下表为模板部分提供了用法细节。


|  Name  |  用法  | 
| --- | --- | 
|  enable  |  模板是否已激活。 | 
|  list  |  一个对象数组，每个对象代表一个模板变量  | 
|  allFormat  |  从数据来源获取所有值时使用的格式（例如 wildcard、glob、regex 和 pipe）。 | 
|  current  |  在控制面板上显示当前选定的变量文本/值  | 
|  data source  |  显示变量的数据来源  | 
|  includeAll  |  所有值选项是否可用  | 
|  multi  |  是否可以从变量值列表中选择多个值  | 
|  multiFormat  |  从数据来源获取时间序列时使用的格式  | 
|  name  |  变量的名称  | 
|  options  |  仪表板上可供选择的变量 text/value 对数组  | 
|  query  |  用于获取变量值的数据来源查询  | 
|  refresh  |  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/` 目录中找到更多示例。