es-head插件的安装与使用

head插件

elasticsearch-head是一个界面化的集群操作和管理工具，可以对集群进行傻瓜式操作。你可以通过插件把它集成到elasticsearch（5.0版本后不支持此方式）,也可以安装成一个独立webapp。elasticsearch-head插件是使用JavaScript开发的，依赖Node.js库，使用Grunt工具构建，所以等会我们要安装elasticsearch-head，还需要先安装Node.js和Grunt。

elasticsearch-head主要的作用有以下这些方面：

• 显示集群的拓扑,并且能够执行索引和节点级别操作
• 搜索接口能够查询集群中原始json或表格格式的检索数据
• 能够快速访问并显示集群的状态
• 有一个输入窗口,允许任意调用RESTful API。这个接口包含几个选项,可以组合在一起以产生不同的结果;
• 请求方法(get、put、post、delete),查询json数据,节点和路径
• 支持JSON验证器
• 支持重复请求计时器
• 支持使用javascript表达式变换结果

安装node.js

[root@es2 ~]# tar -zxf node-v10.6.0-linux-x64.tar.gz 
[root@es2 ~]# mv node-v10.6.0-linux-x64/ /usr/local/node
[root@es2 ~]# vim /etc/profile  尾部添加
export NODE_HOME=/usr/local/node
export PATH=$PATH:$NODE_HOME/bin

[root@es2 ~]# source /etc/profile
[root@es2 ~]# node -v  #验证node.js是否安装成功，如果能查看到版本号说明安装成功
v10.6.0
[root@es2 ~]# npm -v  #验证npm工具是否安装成功，如果能查看到版本号说明安装成功
6.1.0

安装elasticsearch-head插件

下载地址：https://github.com/mobz/elasticsearch-head把源码下载下来，下载的包名为：elasticsearch-head-master.zip，然后上传到Linux主机上。

   70  unzip elasticsearch-head-master.zip 
   71  mv elasticsearch-head-master/ /usr/local/es-head

安装grun工具
[root@es2 ~]# cd /usr/local/es-head/
[root@es2 es-head]# npm install -g grunt --registry=https://registry.npm.taobao.org
/usr/local/node/bin/grunt -> /usr/local/node/lib/node_modules/grunt/bin/grunt
+ grunt@1.0.4
added 97 packages from 63 contributors in 11.419s

编译elasticsearch-head源代码
npm install #使用npm编译es-head源码，但是建议大家不要用这个这种方式安装，
因为使用npm编译源码会下载很多依赖，这些依赖默认到国外镜像下载，所以速度
会很慢，看下面的命令：
npm install -g cnpm --registry=https://registry.npm.taobao.org #安装cnpm，这是链接中国的镜像

cnpm install #使用cnpm代替npm编译es-head源码

编译好后es-head根目录下会出现一个叫node_modules的目录，该目录就是存放源码编译后的可执行文件。到现在我们已经把elasticsearch-head插件和它的依赖都安装好了，那接下来我们就要对他的配置进行修改，准备运行。

插件配置修改

1、设置插件管理界面跨主机访问
插件默认是只有本机的IP才能访问的，也就是127.0.0.1，这样我们就无法跨主机访问head 插件的管理界面，所以需要把它改成所有IP地址都能访问。该配置在head插件安装目录根目录下，文件名为Gruntfile.js。
cd /usr/local/es-head
vi Gruntfile.js
在该配置文件中connect-server-options下添加hostname: ‘0.0.0.0’,这个配置，这样就不限制IP地址的访问了，具体看以下配置文件截图：

注意：要把主机防火墙9100的端口打开
[root@es2 es-head]# firewall-cmd --permanent --add-port=9100/tcp

2、设置连接elasticsearch的地址
head插件默认是连接本机的elasticsearch的，如果你的elasticsearch和head插件是安装在同一台主机上，那么就不需要修改配置，如果不是安装在同一台主机的，就必须修改配置了，配置文件在head插件安装目录的_site目录下，文件名为app.js。
vi app.js #编辑app.js文件
把this.base_uri = this.config.base_uri || this.prefs.get(“app-base_uri”) || “http://localhost:9200”;这行配置中的localhost改成你elasticsearch服务所在IP地址（如果安装在同一台主机就不需要修改），具体看以下配置文件截图：

3、elasticsearch配置允许跨域访问
cd /usr/local/es/config #进入elasticsearch存放配置文件的目录
vi elasticsearch.ym #编辑elasticsearch配置文件
在该配置文件中最末尾添加两个属性：

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

使head插件可以访问elasticsearch，具体看以下配置文件截图：

运行和使用head插件（要求三台es均安装并运行head）

head插件运行之前，需要重新启动es

cd /usr/local/es-head #先进入到head插件的安装目录根目录
grunt server #使用刚刚安装的grunt工具运行head插件
如果能打印以下的信息，那就说明head插件安装并运行成功，并且我们通过打印信息看到，它告诉我们可以通过localhost:9100访问web服务，该web服务就是head插件的管理界面，但是这个localhost要改成head插件所在的主机的具体IP地址。接下来我们就可以通过浏览器来访问head插件的管理界面了，在这管理界面中管理我们的elasticsearch服务。

[root@es2 es-head]# grunt  server
(node:8512) ExperimentalWarning: The http2 module is an experimental API.
Running "connect:server" (connect) task
Waiting forever...
Started connect web server on http://localhost:9100

随意一台es另开终端，访问head插件界面

firefox 192.168.1.109:9100

然后再如图位置写上本机IP地址并连接，可以看到集群状态

图片上的大数字是shard分片的编号，点击数字即可看到，如下所示

如上图，纵向来看，kgctest这个索引下，es2上的主分片1，在es3上有复制分片，主分片是粗线框，复制分配是细一点的

head插件的使用

overview

indices

browser

structured query

any query