使用CLI的灵活时间格式来执行查询、报警和下载等

介绍

在查询、统计、拉取时需要传入时间范围，但是经常我们需要传入更灵活的参数，如：”今天凌晨”，”昨天”，”3天前”，”现在”等参数时，大脑需要费力的换算成对应的时间格式，如”2018-8-1 10:10:00”等。 另一方面，用脚本定期跑的时候，需要相对这样的相对值，例如，每5分钟查询，过去60分钟的范围的数据是否有异常等。每次执行希望有一个时间范围是：过去60分钟到现在。

现在这样的方式CLI支持了!

支持的方法

以下方法的参数，如from_time、to_time等目前也接受相对时间了。

方法	作用
get_log	查询统计数据（参数放在文件中），未完成时自动重试。
get_logs	查询统计数据（参数放在命令行中），未完成时自动重试。
get_log_all	迭代式查询更大量的数据，未完成时自动重试。
pull_log	基于服务器接受时间范围，批量拉取特定shard的数据。
pull_log_dump	并发批量下载logstore所有shard的数据到本地。
get_cursor	获取特定服务器时间特定shard的游标（以便基于游标拉取数据）
get_histograms	获取查询范围内的日志分布。

支持的时间格式

除了常规的格式，例如：”%Y-%m-%d %H:%M:%S+8:00”的例子”2018-01-02 12:12:10+8:00”； 也支持”1 hour ago”, “now”, “yesterday 0:0:0”等格式了。更多格式也可以参考https://dateparser.readthedocs.io/en/latest/

相对1分钟: -1min ~ now， 或 1 min ago ~ now

相对4小时: -4h ~ now，或 4 hours ago ~ now 或 4 hour ago

相对4天（24小时）: -1d ~ now，或 1 day ago ~ now

相对1周(7x24小时): -1week ~ now, 或 1 week ago ~ now

今天: today 0:0:0 ~ now

昨天: yesterday 0:0:0 ~ yesterday 23:59:59，或 1 day ago 0:0:0 ~ -1d 23:59:59

前天: the day before yesterday 0:0:0 ~ 2 day ago 23:59:59

例子

实时显示当前网站UV

如下命令

aliyunlog log get_log --project=pdata1 --logstore=log1 --from_time="today 00:00:00" --to_time="now" --query="host: www.dcd.mock-domain.com | select count(distinct remote_addr) as uv" --jmes-filter="join('\n', map(&to_string(uv), @))"

每次运行时都会显示今天的独立访问客户的数量

定期导出客户端IP列表

aliyunlog log get_log --project=pdata1 --logstore=log1 --from_time="yesterday 00:00:00" --to_time="yesterday 23:59:59" --query="host: www.dcd.mock-domain.com | select distinct remote_addr" --jmes-filter="join('\n', map(&to_string(remote_addr), @))"

以上命令可以在每天0:0:1运行，导出昨天的独立访问客户的列表