Fuel插件Elasticsearch-Kibana(0.7.0) Server安装部署指南
The Elasticsearch-Kibana Server Plugin
LMA(日志、监视和警报)工具链是专为Mirantis OpenStack设计的面向服务的监控解决方案。它由一组开源工具组成，能够帮助你在Openstack环境的基础设施水平上监视和诊断服务的可用性。该工具座位Fuel插件被打包并交付，你能够在Fuel的用户的图形界面安装它。LMA-Toolchain插件版本0.7兼容Mirantis OpenStack 6.1版。
Requirements
Installation Guide
如前所述，你可以将Elasticsearch 和 Kibana作为Fuel插件安装，或分离安装，在分离安装时，没有Elasticsearch-Kibana插件设置是必需的。你只需要按照说明安装LMA收集器插件即可。
Install the plugin on the Fuel Master Node
在Fuel主节点上安装ElasticsearchKibana插件遵循以下步骤:
1、从fuel插件目录中下载插件。
2、将插件rpm文件复制到Fuel主节点:
[root@home ~]# scp elasticsearch_kibana-0.7-0.7.0-0.noarch.rpm root@<Fuel Master node IP address>:/tmp
3、登录到Fuel主节点。使用Fuel的CLI安装插件：
[root@fuel ~]# fuel plugins --install /tmp/elasticsearch_kibana-0.7-0.7.0-0.noarch.rpm
4、验证插件安装正确：
[ root@fuel ~] # fuel plugins id | name | version | package_version ---|----------------------|---------|---------------- 1 | elasticsearch_kibana | 0.7.0 | 2.0.0
要安装LMA收集器插件，请遵循LMA收集器插件的说明指南。
Plugin configuration
配置ElasticsearchKibana插件,请执行以下步骤：
1、使用Fuel UI向导创建一个新环境。
2、单击“设置”选项卡，向下滚动，直到到达“弹性搜索”插件部分
3、选择Elasticsearch-Kibana插件复选框并填写配置。参数如下图所示：
a.Node name是必填字段，所有其他的字段要么是可选的，要么与默认值相关联。你应该在Node name字段填写在部署时将要安装Elasticsearch 和 Kibana的节点的名称。例如：elasticsearch。下面是节点的安装说明。
b.可选地，你可以为Elasticsearch数据库指创建多达三块的磁盘，这个插件将自动的在哪些磁盘上创建一个逻辑卷。如果你想要给磁盘分区，你也可以在Size字段指定分配大小。如果没有指定大小，那么该插件将会获取所有可用的磁盘空间。如果没有磁盘分配，那么Elasticsearch数据库将会在根文件系统上创建。
4、选择日志、监视和警报(LMA)收集器插件复选框并填写“事件分析”部分,如下图所示.关于LMA收集器的进一步说明,请查看收集器插件用户指南。
a.如果你想包括Openstack的服务通知，您可以选择OpenStack通知复选框。
5、点击页面下面的“保存设置”的按钮，来保存配置参数。
6、然后切换到Nodes选项卡，以添加一个带有base_os角色的节点。
7、在部署任何修改之前，请通过点击"Untitled (xx:yy)"编辑修改base_os节点名称为“elasticsearch”。
8、向下滚动到“网络”页面并验证你的网络。
9、最后部署您的更改
Plugin Install Verification
根据节点的数量和设置的复杂性，部署新的Mirantis OpenStack环境通常需要30分钟到几个小时。一旦你的环境已成功部署，您应该在Fuel UI中收到看起来像这样通知。
当前的Fuel插件的限制是不能包含动态的信息通知，例如：Grafana服务器的URL。限制将在下一个版本的Mirantis OpenStack中被修正，但同时你也不得不使用Fuel命令行检索该信息。
[ root@fuel ~] # fuel nodes id | status | name | cluster | ip | […] | roles ---|--------|----------------------|---------|-------------| |------ 1 | ready | elasticsearch | 1 | 10.20 . 0.3 | | base - os 6 | ready | Untitled ( 55 : b3 ) | 1 | 10.20 . 0.7 | | ceph - osd , compute 3 | ready | Untitled ( 73 : 19 ) | 1 | 10.20 . 0.5 | | controller 4 | ready | Untitled ( 1c : 5c ) | 1 | 10.20 . 0.6 | | controller 5 | ready | Untitled ( 75 : 35 ) | 1 | 10.20 . 0.8 | | ceph - osd , compute 2 | ready | Untitled ( ec : a2 ) | 1 | 10.20 . 0.4 | | controller
上面的命令行输出告诉您Elasticsearch Kibana服务器已经部署在node1，使用IP地址10.20.0.3 。为了验证Elasticsearch是否正确运行，请使用以下步骤。
[root@fuel ~] # curl http://10.20.0.3:9200/ { "status" : 200, "name" : "node-1", "cluster_name" : "elasticsearch", "version" : { "number" : "1.4.4", "build_hash" : "c88f77ffc81301dfa9dfd81ca2232f09588bd512", "build_timestamp" : "2015-02-19T13:05:36Z", "build_snapshot" : false, "lucene_version" : "4.10.3" }, "tagline" : "You Know, for Search" }
User Guide
Exploring the Data with Kibana
Kibana用户界面运行在端口80上。将浏览器指向URL http://10.20.0.3:80/你应该看到这样的屏幕:
Kibana仪表板分为4个主要部分：
1、time-picker控制部分，使得你能够自定义时间段与刷新频率。
2、查询和过滤部分，可以显示出所有的过滤器。
3、一个包含4个面板的日志分析行：
a.选择的时间段的日志消息的数量;
b.排名前十的主机;
c.前10个日志源;
d.按严重性分组的日志消息的数量.
4、按时间顺序排序的日志消息表。
Dashboard management
有2个指示板可用:
- 日志指示板是用于查看日志消息的Kibana主仪表板。
- 如果您在LMA收集器设置中启用此选项，则通知仪表板查看OpenStack通知。
您可以按照您喜欢的方式修改仪表板，并在工具栏中使用topright save图标来保存它。您还可以通过更改它的名称来保存修改过的仪表板的副本。
Filters and queries
过滤器和查询有相似的语法，但它们用于不同的目的:
- 过滤器用于限制显示在仪表板中的数据。
-
查询用于freetext搜索。您还可以组合多个查询并比较它们的结果。
为了进一步过滤基于日志的消息，例如，在deployment_id上，您需要扩展一个日志条目，然后通过单击放大镜图标来选择deployment_id字段，如下所示。
这将在仪表板中应用新的过滤器，如下所示。这将适用于在日志条目中被索引的任何字段。
过滤器和查询条件也可以包含通配符。可以根据以下模板请求通配符:p rogramname: <name>*。例如，要在仪表板中只显示Nova日志，您应该在查询文本框中输入程序名:Nova *:
您还可以指定多个查询来比较不同的数据集。若要添加新查询，请单击查询文本框右侧的+符号并输入新的搜索查询。
Troubleshooting
如果您在dasboard中没有数据，请使用下面的说明来排除问题:
- 检查LMA收集器服务是否已启动并运行:
# On CentOS /etc/init.d/lma_collector status # On Ubuntu status lma_collector
- 如果LMA收集器关闭，请重新启动它:
# On CentOS /etc/init.d/lma_collector start # On Ubuntu start lma_collector
- 查找LMA收集器日志文件中的错误(位于/var/log/lma_collector中)日志。
- 检查节点是否能够连接到端口9200上的Elasticsearch服务器。
References
● the official Elasticsearch documentation
● the official Hardware recommendations for Elasticsearch
● the official Kibana documentation
