Grafana 为仪表盘、面板和警报提供了多种管理可视化数据时间范围的方法。
本节将介绍支持的时间单位和相对范围、常用时间控件、仪表盘范围的时间设置以及特定于面板的时间设置。
Grafana 支持以下时间单位:s(秒)、m(分)、h(小时)、d(天)、w(周)、M(月)、Q(季度)和 y(年)。
通过减号(-)运算符,可以回溯到当前日期和时间或现在。如果要显示单位的完整时间段(日、周、月等......),请在最后添加 /<时间单位>。要查看财政期,请使用 fQ(财政季度)和 fy(财政年度)时间单位。
通过加号(+)运算符,可以将时间相对于现在向前推移。例如,您可以使用该功能查看未来的预测数据。
下表提供了相对范围的示例:
相对范围示例 | 从: | 至: |
最后 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 警报系统目前不支持以下语法:
now+n 表示未来时间戳。
now-1n/n 表示 "从 n 开始到 n 结束",因为这是一个绝对时间戳。
仪表板和面板时间控制具有共同的用户界面:
以下各节定义了常用的时间范围控制。
当前时间范围也称为时间选择器,显示当前在仪表盘或面板中显示的时间范围。
将光标悬停在字段上,可查看范围内的确切时间戳及其来源(如本地浏览器)。
单击当前时间范围进行更改。您可以使用相对时间范围(如过去 15 分钟)或绝对时间范围(如 2020-05-14 00:00:00 至 2020-05-15 23:59:59)更改当前时间。
从相对时间范围列表中选择相对时间范围。您可以使用顶部的输入框过滤列表。时间范围的示例包括:
最后 30 分钟
最近 12 小时
最近 7 天
最近 2 年
昨天
前天
上周今日
今天到目前为止
本周至今
本月至今
您可以通过以下方式设置绝对时间范围:
在 "From" 和 "To" 字段中键入值。可以输入准确的时间值或相对值,如 now-24h,然后单击应用时间范围。
在 "From" 或 "To" 字段中单击,Grafana 会显示日历。单击要用作当前时间范围的一天或多天,然后单击应用时间范围。
本节还显示最近使用的绝对范围。
注意:Grafana 警报不支持半相对时间范围。
您也可以使用绝对时间范围设置来设置半相对时间范围。半相对时间范围仪表盘在需要监控一段时间内的进展情况,但又想查看从某个起点开始的整个历史记录时非常有用。
通过将开始时间设置为绝对时间戳,将结束时间设置为相对于当前时间的“now”,来设置半相对时间范围。例如:
开始时间: 2023-05-01 00:00:00
结束时间: now
如果你想在工作时间跟踪某件事情的进展,可以设置一个时间范围,涵盖当前一天,但从早上 8 点开始,就像这样:
开始时间: now/d+8h
结束时间: now
这等同于 "今天到目前为止" 时间范围预设,但它的开始时间是早上 8:00,而不是 12:00,方法是在定期开始时间后附加 +8h。
使用半相关的时间范围,随着时间的推移,仪表盘会自动逐步放大,显示更多的历史记录和更少的细节。同时,随着高数据分辨率的降低,整个时间段的历史趋势也会变得更加清晰。
单击 "缩小" 图标,查看仪表盘或面板可视化中更大的时间范围。
单击并拖动以选择要查看的可视化时间范围。
单击刷新仪表盘图标可立即运行仪表盘上的所有查询并刷新可视化。触发刷新时,Grafana 会取消任何待处理请求。
默认情况下,Grafana 不会自动刷新仪表盘。查询会根据面板设置按照自己的计划运行。但是,如果要定期刷新仪表盘,请单击刷新仪表盘图标旁边的向下箭头,然后选择刷新间隔。
选择自动间隔会根据查询时间范围和浏览器窗口宽度安排刷新。较短的时间范围更新频繁,而较长的时间范围更新不频繁。刷新频率无需超过可用于绘制任何更新的像素。
你可以通过在仪表盘 URL 中提供以下查询参数来控制仪表盘的时间范围:
from:定义时间范围的下限,以毫秒、纪元或相对时间为单位指定
to:定义时间范围的上限,以毫秒、时间或相对时间为单位
time 和 time.window:定义时间范围,从 time-time.window/2 到 time+time.window/2。两个参数都应以毫秒为单位。例如,time=1500000000000&time.window=10000 会导致 10 秒的时间范围,即从 1499999995000 到 1500000005000