【转】zookeeper之 zkServer.sh命令、zkCli.sh命令、四字命令

桃扇骨 2021-11-17 17:06 330阅读 0赞

【FROM】[https://www.cnblogs.com/andy6/p/7674028.html][https_www.cnblogs.com_andy6_p_7674028.html]

一、zkServer.sh

1、查看 zkServer.sh 帮助信息

[root@bigdata05 bin]# ./zkServer.sh help
    ZooKeeper JMX enabled by default
    Using config: /bigdata/zookeeper-3.4.10/bin/../conf/zoo.cfg
    Usage: ./zkServer.sh {start|start-foreground|stop|restart|status|upgrade|print-cmd}

2、 启动/关闭 zk服务器

[root@bigdata05 bin]# ./zkServer.sh start
    [root@bigdata05 bin]# ./zkServer.sh stop

3、查看服务器状态

[root@bigdata05 bin]# ./zkServer.sh status
    ZooKeeper JMX enabled by default
    Using config: /bigdata/zookeeper-3.4.10/bin/../conf/zoo.cfg
    Mode: follower

二、zkCli.sh

1、查看 zkCli.sh 帮助信息

[zk: localhost:2181(CONNECTED) 0] help
    ZooKeeper -server host:port cmd args
    stat path [watch]
    set path data [version]
    ls path [watch]
    delquota [-n|-b] path
    ls2 path [watch]
    setAcl path acl
    setquota -n|-b val path
    history 
    redo cmdno
    printwatches on|off
    delete path [version]
    sync path
    listquota path
    rmr path
    get path [watch]
    create [-s] [-e] path data acl
    addauth scheme auth
    quit 
    getAcl path
    close 
    connect host:port

常用命令

0）连接zookeeper

[root@bigdata05 bin]# ./zkCli.sh -server localhost:2181

1）查看当前节点列表

[zk: localhost:2181(CONNECTED) 1] ls /
    [zookeeper, yarn-leader-election, hadoop-ha]

2）创建节点

[zk: localhost:2181(CONNECTED) 1] ls /
    [zookeeper, yarn-leader-election, hadoop-ha]
    [zk: localhost:2181(CONNECTED) 2] create /test "test"
    Created /test
    [zk: localhost:2181(CONNECTED) 3] ls /
    [zookeeper, test, yarn-leader-election, hadoop-ha]
    [zk: localhost:2181(CONNECTED) 4] create /test/test "test"
    Created /test/test
    [zk: localhost:2181(CONNECTED) 5] ls /
    [zookeeper, test, yarn-leader-election, hadoop-ha]
    [zk: localhost:2181(CONNECTED) 6] ls /test
    [test]

3）查看节点数据

[zk: localhost:2181(CONNECTED) 7] get /test
    test
    cZxid = 0x400000031
    ctime = Mon Oct 16 04:05:02 CST 2017
    mZxid = 0x400000031
    mtime = Mon Oct 16 04:05:02 CST 2017
    pZxid = 0x400000032
    cversion = 1
    dataVersion = 0
    aclVersion = 0
    ephemeralOwner = 0x0
    dataLength = 4
    numChildren = 1
    
    ######################

czxid 创建该节点的事物ID

ctime 创建该节点的时间

mZxid 更新该节点的事物ID

mtime 更新该节点的时间

pZxid 操作当前节点的子节点列表的事物ID(这种操作包含增加子节点，删除子节点)

cversion 当前节点的子节点版本号

dataVersion 当前节点的数据版本号

aclVersion 当前节点的acl权限版本号

ephemeralowner 当前节点的如果是临时节点，该属性是临时节点的事物ID

dataLength 当前节点的d的数据长度

numchildren 当前节点的子节点个数

4）设置节点数据

[zk: localhost:2181(CONNECTED) 8] set /test "666666"
    cZxid = 0x400000031
    ctime = Mon Oct 16 04:05:02 CST 2017
    mZxid = 0x400000033
    mtime = Mon Oct 16 04:08:44 CST 2017
    pZxid = 0x400000032
    cversion = 1
    dataVersion = 1
    aclVersion = 0
    ephemeralOwner = 0x0
    dataLength = 6
    numChildren = 1
    [zk: localhost:2181(CONNECTED) 10] get /test
    666666
    cZxid = 0x400000031
    ctime = Mon Oct 16 04:05:02 CST 2017
    mZxid = 0x400000033
    mtime = Mon Oct 16 04:08:44 CST 2017
    pZxid = 0x400000032
    cversion = 1
    dataVersion = 1
    aclVersion = 0
    ephemeralOwner = 0x0
    dataLength = 6
    numChildren = 1

5）删除节点

[zk: localhost:2181(CONNECTED) 11] delete /test
    Node not empty: /test
    [zk: localhost:2181(CONNECTED) 12] ls /
    [zookeeper, test, yarn-leader-election, hadoop-ha]
    [zk: localhost:2181(CONNECTED) 13] delete /test/test
    [zk: localhost:2181(CONNECTED) 14] ls /test
    []
    [zk: localhost:2181(CONNECTED) 15] delete /test
    [zk: localhost:2181(CONNECTED) 16] ls /
    [zookeeper, yarn-leader-election, hadoop-ha]

三、 ZooKeeper服务器端四字命令

ZooKeeper 支持某些特定的四字命令(The Four Letter Words)与其进行交互。它们大多是查询命令，用来获取 ZooKeeper 服务的当前状态及相关信息。用户在客户端可以通过 telnet 或 nc 向 ZooKeeper 提交相应的命令。 ZooKeeper 常用四字命令主要如下：

<table> 
 <thead> 
  <tr> 
   <th> 
    <div>
      ZooKeeper四字命令 
    </div> </th> 
   <th> 
    <div>
      功能描述 
    </div> </th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>conf</td> 
   <td>3.3.0版本引入的。打印出服务相关配置的详细信息。</td> 
  </tr> 
  <tr> 
   <td>cons</td> 
   <td>3.3.0版本引入的。列出所有连接到这台服务器的客户端全部连接/会话详细信息。包括"接受/发送"的包数量、会话id、操作延迟、最后的操作执行等等信息。</td> 
  </tr> 
  <tr> 
   <td>crst</td> 
   <td>3.3.0版本引入的。重置所有连接的连接和会话统计信息。</td> 
  </tr> 
  <tr> 
   <td>dump</td> 
   <td>列出那些比较重要的会话和临时节点。这个命令只能在leader节点上有用。</td> 
  </tr> 
  <tr> 
   <td>envi</td> 
   <td>打印出服务环境的详细信息。</td> 
  </tr> 
  <tr> 
   <td>reqs</td> 
   <td>列出未经处理的请求</td> 
  </tr> 
  <tr> 
   <td>ruok</td> 
   <td>测试服务是否处于正确状态。如果确实如此，那么服务返回"imok"，否则不做任何相应。</td> 
  </tr> 
  <tr> 
   <td>stat</td> 
   <td>输出关于性能和连接的客户端的列表。</td> 
  </tr> 
  <tr> 
   <td>srst</td> 
   <td>重置服务器的统计。</td> 
  </tr> 
  <tr> 
   <td>srvr</td> 
   <td>3.3.0版本引入的。列出连接服务器的详细信息</td> 
  </tr> 
  <tr> 
   <td>wchs</td> 
   <td>3.3.0版本引入的。列出服务器watch的详细信息。</td> 
  </tr> 
  <tr> 
   <td>wchc</td> 
   <td>3.3.0版本引入的。通过session列出服务器watch的详细信息，它的输出是一个与watch相关的会话的列表。</td> 
  </tr> 
  <tr> 
   <td>wchp</td> 
   <td>3.3.0版本引入的。通过路径列出服务器watch的详细信息。它输出一个与session相关的路径。</td> 
  </tr> 
  <tr> 
   <td>mntr</td> 
   <td>3.4.0版本引入的。输出可用于检测集群健康状态的变量列表</td> 
  </tr> 
 </tbody> 
</table>

--------------------

\#\#conf conf 命令是在 3.3.0 版本中引入的, 它会打印输出服务器配置的详细信息。以便运维人员能够很快速的查看 ZooKeeper 服务器当前运行时的一些配置参数。

### telnet示例 ###

![conf\_telnet][conf_telnet]

可以看到有些配置项我们没有在 zoo.cfg 配置文件中配置, 服务器使用了默认配置。

### nc示例 ###

![conf\_nc][conf_nc]

### 运行模式 ###

conf 命令会根据当前的运行模式来决定打印输出的服务器配置信息, 上面的两个示例是集群模式下的示例, 如果是单机模式(standalone), 则不会输出 initLimit、syncLimit、electionAlg 以及 electionPort 等集群配置信息。

![standalone][]

--------------------

\#\#cons cons 命令是 3.3.0 版本中引入的, 它用于输出所有连接到该服务器的客户端的完整连接和会话信息, 包括接收和发送包的数量、会话ID、操作延迟以及最后执行的操作等信息。

![cons][]

可以看到本机上有一个客户端连接。

--------------------

\#\#crst crst 命令是在 3.3.0 版本中引入的, 用于重置所有客户端连接的连接和会话统计信息。

![crst][]

--------------------

\#\#dump dump 命令用于输出未完成的会话和临时节点。 \#\#\#leader示例 ![dump\_leader][dump_leader] \#\#\#follower示例 ![dump\_follower][dump_follower]

--------------------

\#\#envi envi 命令用于打印输出服务器运行时的环境变量信息。

![envi][]

--------------------

\#\#ruok ruok 命令用于测试当前服务器是否正在运行。如果服务器正在运行则返回 "imok", 否则没有任何响应。

![ruok][]

需要注意的是, "imok" 响应不一定能够表明服务器已经加入到集群中, 仅仅说明服务器进程处于活动状态并且已经绑定到指定的客户端端口。 可以使用 "stat" 获取集群状态以及客户端连接信息。

--------------------

\#\#srst srst 命令用于重置服务器统计信息。

![srst][]

--------------------

\#\#srvr srvr 命令是在 3.3.0 版本中引入的, 它用于输出服务器的完整信息。

![srvr][]

--------------------

\#\#stat stat 命令用于输出服务器以及连接到该服务器的客户端的概要信息。

![stat][]

srvr 命令和 stat 命令的唯一区别是 srvr 不会输出客户端的概要信息。

--------------------

\#\#wchs wchs 命令是在 3.3.0 版本中引入的, 用于输出当前服务器上 Watcher 的概要信息。

![wchs][]

--------------------

\#\#wchc wchc 命令是在 3.3.0 版本中引入的, 用于按会话输出当前服务器上 watches 的详细信息。它会输出会话(连接)以及相关的 watches (路径) 列表。

![wchc][]

因为暂时没有 watches, 所以没有任何输出。

注意, 取决于 watches 的数量, 这个操作可能会非常耗时 (影响服务器性能), 所以需要谨慎使用。

--------------------

\#\#wchp wchp 命令是在 3.3.0 版本中引入的, 用于按路径输出当前服务器上 watches 的详细信息。它会输出路径 (znodes) 以及相关会话列表。

![wchp][]

同样的, 因为暂时没有 watches, 所以没有任何输出。

注意, 取决于 watches 的数量, 这个操作可能会非常耗时 (影响服务器性能), 所以需要谨慎使用。

--------------------

\#\#mntr mntr 命令是在 3.4.0 版本中引入的, 用于输出可用于监控集群健康的变量列表。 \#\#\#leader示例 ![mntr\_leader][mntr_leader] \#\#\#follower示例 ![mntr\_follower][mntr_follower]

\#\#\#示例说明 从上面两个示例可以看到, zk\_followers, zk\_synced\_followers 和 zk\_pending\_syncs 只有在 leader 服务器上运行 mntr 命令时才会输出。还需要注意的是, zk\_open\_file\_descriptor\_count 和 zk\_max\_file\_descriptor\_count 这两个变量只有在 Unix 平台上才可用。

文章可以转载，必须以链接形式标明出处。

转载于:https://www.cnblogs.com/pekkle/p/11180576.html

[https_www.cnblogs.com_andy6_p_7674028.html]: https://www.cnblogs.com/andy6/p/7674028.html
[conf_telnet]: https://static.oschina.net/uploads/img/201607/10125433_xyNq.png
[conf_nc]: https://static.oschina.net/uploads/img/201607/10130025_Avbk.png
[standalone]: https://static.oschina.net/uploads/img/201607/10131118_yYZd.png
[cons]: https://static.oschina.net/uploads/img/201607/10133640_FlME.png
[crst]: https://static.oschina.net/uploads/img/201607/10133937_DT5v.png
[dump_leader]: https://static.oschina.net/uploads/img/201607/10151408_UPqH.png
[dump_follower]: https://static.oschina.net/uploads/img/201607/10151524_F55N.png
[envi]: https://static.oschina.net/uploads/img/201607/10135132_aYJd.png
[ruok]: https://static.oschina.net/uploads/img/201607/10143445_ysTY.png
[srst]: https://static.oschina.net/uploads/img/201607/10144817_bSkd.png
[srvr]: https://static.oschina.net/uploads/img/201607/10144400_QBVv.png
[stat]: https://static.oschina.net/uploads/img/201607/10144521_ezCM.png
[wchs]: https://static.oschina.net/uploads/img/201607/10145214_e6yy.png
[wchc]: https://static.oschina.net/uploads/img/201607/10145749_IyLG.png
[wchp]: https://static.oschina.net/uploads/img/201607/10150324_4rAX.png
[mntr_leader]: https://static.oschina.net/uploads/img/201607/10140000_ozzK.png
[mntr_follower]: https://static.oschina.net/uploads/img/201607/10140019_5V3G.png