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

# 使用控制面板
<a name="v9-dash-using-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)。

本主题概述了控制面板的功能和快捷方式，并介绍了如何使用控制面板搜索。

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

您可以通过以下方式使用控制面板自定义数据的表示形式。


|  功能  |  说明  | 
| --- | --- | 
| **1。主页** | 单击 Grafana 主页图标，重定向到 Grafana 实例中配置的主页。 | 
| **2。标题** | 单击控制面板标题时，可以搜索当前文件夹中包含的控制面板。 | 
| **3。共享控制面板** | 使用此选项通过链接或快照共享当前控制面板。您还可以从共享模式中导出控制面板定义。 | 
| **4。添加新面板** | 使用此选项向当前控制面板添加面板、控制面板行或库面板。 | 
| **5。控制面板设置** | 使用此选项可以更改控制面板名称、文件夹和标签，管理变量和注释查询。有关控制面板设置的更多信息，请参阅 [修改控制面板设置](v9-dash-modify-settings.md)。 | 
| **6。时间选取器下拉列表** |  单击选择相对时间范围选项，设置自定义绝对时间范围。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/v9-dash-using-dashboards.html)  | 
| **7。缩小时间范围**  | 单击可缩小时间范围。有关如何使用时间范围控件的更多信息，请参阅 [设置控制面板时间范围](#v9-dash-setting-dashboard-time-range)。  | 
| **8。刷新控制面板** | 单击可立即触发查询并刷新控制面板数据。 | 
| **9。刷新控制面板时间间隔** | 单击选择控制面板自动刷新时间间隔。 | 
| **10。视图模式**  | 单击以在大屏幕（如电视或信息亭）上显示控制面板。视图模式会隐藏不相关的信息，例如导航菜单。  | 
| **11。控制面板面板** |  控制面板的主要构件是面板。要添加新面板、控制面板行或库面板，请单击**添加面板**。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/v9-dash-using-dashboards.html)  | 
| **12。图形图例** | 直接从图例中更改序列颜色、y 轴和序列可见性。 | 
| **13。控制面板搜索** | 单击**搜索**按名称或面板标题搜索控制面板。 | 
| **14。控制面板行** | 控制面板行是控制面板中的逻辑分隔线，用于将面板分组在一起。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/grafana/latest/userguide/v9-dash-using-dashboards.html)  | 

## 键盘快捷键
<a name="v9-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="v9-dash-setting-dashboard-time-range"></a>

Grafana 提供了多种方法来管理可视化数据的时间范围，包括控制面板、面板和警报。

本节介绍了支持的时间单位和相对范围、常用时间控件、控制面板范围的时间设置以及面板特定的时间设置。

**时间单位和相对范围**

Grafana 支持以下时间单位：`s (seconds)`、`m (minutes)`、`h (hours)`、`d (days)`、`w (weeks)`、`M (months)`、`Q (quarters)` 和 `y (years)`。

减号运算符可以回退时间（相对于现在）。如果要显示单位的完整周期（日、周或月），请在末尾附加 `/<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 Alerting 不支持将 `now+n` 用于未来时间戳，也不支持将 `now-1n/n` 用于“从 n 开始到 n 结束”**时间戳。

**常用时间范围控件**

控制面板和面板时间控件具有通用的用户界面。以下介绍了常用的时间范围控件。
+ 当前时间范围（也称为“时间选取器”**）显示您正在查看的控制面板或面板中当前显示的时间范围。将光标悬停在字段上，可查看范围内的确切时间戳及其来源（如本地浏览器）。单击“当前时间范围”**进行更改。您可以使用“相对时间范围”**（例如过去 15 分钟）或“绝对时间范围”（例如从 `2020-05-14 00:00:00` 到 `2020-05-15 23:59:59`）。
+ 可从**相对时间范围**列表中选择**相对时间范围**。您可以使用顶部的输入字段来筛选列表。时间范围的一些示例包括“过去 30 分钟”**、“过去 12 小时”**、“过去 7 天”**、“过去 2 年”**、“昨天”**、“前天”**、“上周今天”**、“本日至今”**、“本周至今”**和“本月至今”**。
+ 可通过两种方式设置**绝对时间范围**：在**从**和**到**字段中输入确切的时间值或相对时间值，然后单击**应用时间范围**，或者在单击**从**或**到**字段时，从显示的日历中单击日期或日期范围。要应用选择，请单击**应用时间范围**。

*其他时间范围功能*

1. 若要缩小，请单击 **Cmd\$1Z** 或 **Ctrl\$1Z**。单击该图标可在控制面板或面板可视化中查看更大的时间范围。

1. 若要放大，请单击并拖动以选择要在可视化中查看的时间范围。

**注意**  
放大仅适用于图形可视化。

*刷新控制面板*

单击**刷新控制面板**图标可立即运行控制面板上的所有查询，并刷新可视化。触发刷新时，Grafana 会取消所有待处理的请求。

默认情况下，Grafana 不会自动刷新控制面板。根据面板设置，按自己的时间表运行查询。但是，如果要定期刷新控制面板，请单击**刷新控制面板**图标旁边的向下箭头，然后选择刷新间隔。

**使用 URL 控制时间范围**

您可以通过在控制面板 URL 中提供以下查询参数来控制面板的时间范围。
+ `from` 定义时间范围的下限（以毫秒纪元为单位指定）或[相对时间](#v9-dash-setting-dashboard-time-range)。
+ `to` 定义时间范围的上限（以毫秒纪元为单位指定）或相对时间。
+ `time` 和 `time.window` 定义了从 `time-time.window/2` 到 `time+time.window/2` 的时间范围。两个参数均应以毫秒为单位指定。例如，`?time=1500000000000&time.window=10000` 将得出 10 秒的时间范围，从 1499999995000 到 1500000005000。