Kibana 5 - timelion 介绍
优质
小牛编辑
130浏览
2023-12-01
Elasticsearch 2.0 开始提供了一个崭新的 pipeline aggregation 特性,但是 Kibana 并没有立刻跟进这方面的意思,相反,Elastic 公司推出了另一个实验室产品:Timelion。最后在 5.0 版中,timelion 成为 Kibana 5 默认分发的一个插件。
timelion 的用法在官博里已经有介绍。尤其是最近两篇如何用 timelion 实现异常告警的文章,更是从 ES 的 pipeline aggregation 细节和场景一路讲到 timelion 具体操作,我这里几乎没有再重新讲一遍 timelion 操作入门的必要了。不过,官方却一直没有列出来 timelion 支持的请求语法的文档,而是在页面上通过点击 Docs 按钮的方式下拉帮助。
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)
: 图例位置.static(value=1024, label="1k", offset="-1d", fit="scale")
:在图形上绘制一个固定值.value()
:.static()
的简写.title(title="qps")
:图表标题.trend(mode="linear", start=0, end=-10)
:采用 linear 或 log 回归算法绘制趋势图.yaxis($yaxis_number, $min, $max, $position)
: 设置 Y 轴属性,.yaxis(2) 表示第二根 Y 轴
数据运算类
.abs()
: 对整个数组元素求绝对值.precision($number)
: 浮点数精度.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()
的简写.fit($mode)
:使用指定的 fit 函数填充空值。可选项有:average, carry, nearest, none, scale.holt(alpha=0.5, beta=0.5, gamma=0.5, season="1w", sample=2)
:即 Elasticsearch 的 pipeline aggregation 所支持的 holt-winters 算法.log(base=10)
:对数.max()
:最大值.min()
:最小值.props()
:附加额外属性,比如.props(label=bears!)
.range(max=10, min=1)
:保持形状的前提下修改最大值最小值.scale_interval(interval="1s")
:在新间隔下再次统计,比如把一个原本 5min 间隔的date_histogram
改为每秒的结果.trim(start=1, end=-1)
:裁剪序列值
逻辑运算类
.condition(operator="eq", if=100, then=200)
:支持 eq、ne、lt、gt、lte、gte 等操作符,以及 if、else、then 赋值.if()
:.condition()
的简写
数据源设定类
.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()
的简写
以上所有函数,都在 kibana/src/core_plugins/timelion/server/series_functions
目录下实现,每个 js 文件实现一个 TimelionFunction
功能。