? ?查询数据时,OpenTSDB支持许多日期和时间格式。在通过GUI, CliQuery工具或HTTP API提交的查询中支持以下格式。每个查询都需要一个开始时间和一个可选结束时间。如果未指定结束时间,则将使用运行TSD的系统上的当前时间。
相对的
? ?如果您不知道要请求的确切时间戳,可以提交相对于TSD运行系统上的时间过去的时间。相对时间遵循以下格式& lt; amount> & lt;时间unit>前,其中& lt; amount>为数值,& lt;时间unit>是指时间单位,如小时,天,等。例如,如果我们提供了一个起始时间1 h-ago,并且离开结束时间,我们的查询将返回在1小时前到当前时间的数据。可能的时间单位包括:
-
<李> -毫秒女士李
<李> s -秒
<李> m -分钟
<李> h -小时
<李> d -天(24小时)
<李> w -周(7天)
<李> n -个月(30天)
<李> y -年(365天)
<强>注意:
? ?相对时间不包括闰秒,闰年或时区。他们只是计算当前时间过去的秒数。
绝对Unix时间
? ?在存储内部,所有数据都与Unix(或POSIX)风格的时间戳相关联.Unix时间定义为自1970年1月1日就是UTC时间起过去的秒数。时间戳被表示为一个正整数,例如1364410924,表示ISO 8601:2013-03-27T19:02:04Z。由于在OpenTSDB中存储数据的调用需要Unix时间戳,因此在查询中支持此格式是有意义的,因此,可以在查询中为开始或结束时间的提供整数。
? ?使用Unix时间戳的查询可以通过简单追加三位数字来支持毫秒精度。例如,提供开始时间1364410924000和结束时间1364410924250将返回250毫秒窗口内数据。毫秒时间戳也可以提供一段时间,从毫秒中分隔秒数1364410924.250。任何具有13(或14)个字符的整数都将被视为毫秒时间戳。任何10个字符或更少的字符代表秒。毫秒只能以3位精度提供。如果您的工具输出超过3位数字,则必须截断或舍入该值。
绝对格式化时间
? ?由于在您的头脑中计算Unix时间非常困难,OpenTSDB还支持人类可读的绝对日期和时间。支持的格式包括:
-
<李> YYYY/MM/DD-HH: MM: SS李
<李> yyyy/MM/dd HH: MM: ss李
<李> YYYY/MM/DD-HH: MM李
<李> yyyy/MM/dd HH: MM李
<李> YYYY/MM/DD
? ?yyyy代表年份为四位数值,例如2013.毫米代表从01月份到12月份.dd代表从月份开始的月份的一天01. hh代表在一天的24小时制出发的时间00到23.毫米表示起始于分钟00到59并党卫军表示秒开始00到59。所有月份,日,小时,分钟和秒钟都是单个数字,必须以0为前缀,例如每月的第5天必须为05年。当没有时间提供数据时,系统将假定给定日期的午夜。
? ?例子包括2013/01/23-12:50:42或2013/01/23。格式化的时间从运行TSD的主机的默认时区转换为UTC.HTTP API查询可以接受用户提供的时区以覆盖本地时区。
? ? <强>注意:
? ?使用CliQuery工具时,必须使用用短划线将时间与日期分开的格式。这是因为命令行以空格为分割,所以如果在时间戳中放置空格,它将无法正确解析执行
时区
? ?在转换人类可读的时间戳时,OpenTSDB将根据TSD正在运行的系统上配置的时区转换为UTC。尽管许多服务器都配置为UTC,但我们建议所有运行OpenTSDB的系统都使用UTC,但有时会使用本地时区。
? ?通过查询字符串查询HTTP API可以指定tz带有时区标识字符串的参数,格式适用于运行TSD的系统的本地化设置,例如,我们可以指定tz=美国/Los_Angeles将我们的时间戳从洛杉矶当地时间转换为UTC。
? ?或者,如果无法更改系统时区,则可以通过配置文件tsd.core.timezone属性提供覆盖。
<代码>下一篇
OpenTsdb官方文档——查询过滤器
