timelion 介绍

ES2.0 开始提供了一个崭新的 pipeline aggregation 特性，但是 Kibana 似乎并没有立刻跟进这方面的意思，相反，Elastic 公司推出了另一个实验室产品：Timelion。

timelion 的用法在官博里已经有介绍。尤其是最近两篇如何用 timelion 实现异常告警的文章，更是从 ES 的 pipeline aggregation 细节和场景一路讲到 timelion 具体操作，我这里几乎没有再重新讲一遍 timelion 操作入门的必要了。不过，官方却一直没有列出来 timelion 支持的请求语法的文档，而是在页面上通过点击图标的方式下拉帮助。

timelion 页面设计上，更接近 Kibana3 而不是 Kibana4。比如 panel 分布是通过设置几行几列的数目来固化的；query 框是唯一的，要修改哪个 panel 的 query，鼠标点选一下 panel，query 就自动切换成这个 panel 的了。

为了方便大家在上手之前了解 timelion 能做到什么，今天特意把 timelion 的请求语法所支持的函数分为几类，罗列如下：

可视化效果类

• .bars($width): 用柱状图展示数组
• .lines($width, $fill, $show, $steps): 用折线图展示数组
• .points(): 用散点图展示数组
• .color("#c6c6c6"): 改变颜色
• .hide(): 隐藏该数组
• .label("change from %s"): 标签
• .legend($position, $column): 图例位置
• .yaxis($yaxis_number, $min, $max, $position): 设置 Y 轴属性，.yaxis(2) 表示第二根 Y 轴

数据运算类

• .abs(): 对整个数组元素求绝对值
• .precision($number): 浮点数精度
• .testcast($count, $alpha, $beta, $gamma): holt-winters 预测
• .cusum($base): 数组元素之和，再加上 $base
• .derivative(): 对数组求导数
• .divide($divisor): 数组元素除法
• .multiply($multiplier): 数组元素乘法
• .subtract($term): 数组元素减法
• .sum($term): 数组元素加法
• .add(): 同 .sum()
• .plus(): 同 .sum()
• .first(): 返回第一个元素
• .movingaverage($window): 用指定的窗口大小计算移动平均值
• .mvavg(): .movingaverage() 的简写
• .movingstd($window): 用指定的窗口大小计算移动标准差
• .mvstd(): .movingstd() 的简写

数据源设定类

• .elasticsearch(): 从 ES 读取数据
• .es(q="querystring", metric="cardinality:uid", index="logstash-*", offset="-1d"): .elasticsearch() 的简写
• .graphite(metric="path.to.*.data", offset="-1d"): 从 graphite 读取数据
• .quandl(): 从 quandl.com 读取 quandl 码
• .worldbank_indicators(): 从 worldbank.org 读取国家数据
• .wbi(): .worldbank_indicators() 的简写
• .worldbank(): 从 worldbank.org 读取数据
• .wb(): .worldbanck() 的简写

以上所有函数，都在 series_functions 目录下实现，每个 js 文件实现一个 TimelionFunction 功能。