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

# 时间范围控件
<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