Grafana与Elasticsearch

  之前一直用ELK体系里的Kibana做ES的WEB前端展示,kibana功能简单，可以直接显示log的内容，非常人性化，缺陷是没有权限、用户管理（我之前用Nginx和haproxy其中之一来代替），图形展示不够丰富，管理api等限制，更由于我需要更丰富的图形展示功能，所以开始寻找他的替代品Grafana。

  Grafana简绍:

1. Grafana是用于可视化大型测量数据的开源程序，他提供了强大和优雅的方式去创建、共享、浏览数据。dashboard中显示了你不同metric数据源中的数据。

2. Grafana最常用于因特网基础设施和应用分析，但在其他领域也有机会用到，比如：工业传感器、家庭自动化、过程控制等等。

3. Grafana有热插拔控制面板和可扩展的数据源，目前已经支持Graphite、InfluxDB、OpenTSDB、Elasticsearch。

  这里先简单介绍下我的应用场景，ES用作时序数据库，后端agent每分钟读取云平台的性能监控数据，通过Kafka存到ES里。使用JSON数据存储格式，ES每天1.8亿条doc，因为数据包比较小，ES的

Primary Size每天30多G。

数据存储格式如下：

Grafana展示的效果截图：

具体实现：

一、添加elasticsearch数据源

  默认Grafana是安装了ES插件的，如果没装需要安装相应data source插件。

点击Data Sources-->+ Add data source--> Type-->elasticsearch

注：代理访问（access proxy）意味着，Grafana的后端将代理从浏览器的所有请求，并将它们发送到数据源。这很有用，因为它可以消除CORS（跨域站点资源）的问题，以及消除到浏览器的传播认证。

如果你选择直接访问（access direct）必须更新Elasticsearch配置允许从浏览器进行其他域的访问。可以通过在elasticsearch.yml指定如下配置选项：

http.cors.enabled: true
http.cors.allow-origin: "*"

二、Metric查询编辑器

  Elasticsearch查询编辑器允许选择多个指标和组由多个条款或过滤器。在右边使用加号和减号图标来添加/删除索引或按子句分组。有些度量值和组子句都有选项，单击选项文本以展开视图并按选项编辑公制或组。

1. Query：Lucence查询语法，跟kibana的查询一样，详情请查阅ES的官方文档。

2. Metric:计量的标准，可以取最大、最小、平均值或者count条目数等，Options可以进行脚本的计算，这里我把value的值乘以8，来进行网络Byte和bite的换算。

3. Group by：排序标准。可以以时间轴进行排序，也可以以自定义的term进行排序。需要这里需要注意一点，ES里如果需要以自定义的字符串term进行排序，会报错："Fielddata is disabled on text fields by default."；报错信息如下图所示：

   解决办法是用"keyword"进行排序，需要手动加入后缀'.keyword'，参考文档如下：https://www.elastic.co/guide/en/elasticsearch/reference/current/fielddata.html

4. Query里也可以用变量来代替，变量是在templating里预先定义好的。后面再详细介绍templating的概念。

三、Axes选项

    这里可以进行X轴和Y轴的定义。

1. Unit设置单位的换算，grafana这里自带了多种单位换算，包括时间、吞吐、温度等；

2. X-Axis里"mode"的选择，如果是要曲线图可以选择"Time",如果是要画柱状图可以选择"histogram"
   

四、Legend选项

    这里主要进行图上显示文字的设置。

如果不勾选“show”则不会在图上显示相关value的信息。

五、Display选项

    这里主要进行如何画图的一些设置。也可以在图上设置阀值，超出阀值会自动突出显示。

1. Draw Mode:绘制模式，选择线绘图还是柱状图绘图，更改之后需要和Axes中X-Axis的modes联调，才能正确绘图。

   Mode Option: ‘Fill’填充程序，如果设置为0，则不填充，完全是一条线的形式展示。如图所示：

   ；

   ‘Staircase’如果勾选则以阶梯的形式画图，如图示：

2. Stacking & Null value：这里需要注意‘Null value’的选择，选择‘connected’，在空值的时候画图会自动把线进行前后衔接，如果设置为零，会画出驼峰的形状。

3. Thresholds:阀值的设置:

   效果图如下：

   

六、Alert选项

    报警设置，需要提前配置好报警邮箱，遗憾的一点Elasticsearch目前版本还不支持Alert的配置，我已经在grafana的github issue上给ES投了一票，建议有类似需求的同学也积极参与进来。

七、Templating

Templating在dashboard manage里设置：

"Edit"添加变量，变量创建完成会在dashboard顶部显示，这里同样用的Lucene的查询语法：

变量的使用,在Metric里面用‘$’或者‘[[]]’进行变量的调用：

另外在General的Title里面也可以调用templating里定义的变量，这样图的标题也会随着变量的改变而改变。

  最后强调一点，更改完所有配置之后不要忘记点击保存按钮进行保存。

更多详细配置见文档：http://docs.grafana.org/features/datasources/elasticsearch/#using-elasticsearch-in-grafana

Grafana官方文档：http://docs.grafana.org/