zookeeper配置

旧城等待， 2022-05-18 00:53 181阅读 0赞

**配置参数详解(主要是%ZOOKEEPER\_HOME%/conf/zoo.cfg文件)**

<table> 
 <tbody> 
 <tr> 
 <td style="vertical-align:top;"> 参数名 </td> 
 <td style="vertical-align:top;"> 说明 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> clientPort </td> 
 <td style="vertical-align:top;"> 客户端连接server的端口，即对外服务端口，一般设置为2181吧。 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> dataDir </td> 
 <td style="vertical-align:top;"> 存储快照文件snapshot的目录。默认情况下，事务日志也会存储在这里。建议同时配置参数dataLogDir, 事务日志的写性能直接影响zk性能。 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> tickTime </td> 
 <td style="vertical-align:top;"> ZK中的一个时间单元。ZK中所有时间都是以这个时间单元为基础，进行整数倍配置的。例如，session的最小超时时间是2*tickTime。 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> dataLogDir </td> 
 <td style="vertical-align:top;"> 事务日志输出目录。尽量给事务日志的输出配置单独的磁盘或是挂载点，这将极大的提升ZK性能。&nbsp;&nbsp; （No&nbsp;<a href="http://lib.csdn.net/base/17" rel="nofollow">Java</a>&nbsp;system property） </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> globalOutstandingLimit </td> 
 <td style="vertical-align:top;"> 最大请求堆积数。默认是1000。ZK运行的时候， 尽管server已经没有空闲来处理更多的客户端请求了，但是还是允许客户端将请求提交到服务器上来，以提高吞吐性能。当然，为了防止Server内存溢出，这个请求堆积数还是需要限制下的。&nbsp;&nbsp; (Java system property:zookeeper.globalOutstandingLimit.&nbsp;) </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> preAllocSize </td> 
 <td style="vertical-align:top;"> 预先开辟磁盘空间，用于后续写入事务日志。默认是64M，每个事务日志大小就是64M。如果ZK的快照频率较大的话，建议适当减小这个参数。(Java system property:zookeeper.preAllocSize&nbsp;) </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> snapCount </td> 
 <td style="vertical-align:top;"> 每进行snapCount次事务日志输出后，触发一次快照(snapshot), 此时，ZK会生成一个snapshot.*文件，同时创建一个新的事务日志文件log.*。默认是100000.（真正的代码实现中，会进行一定的随机数处理，以避免所有服务器在同一时间进行快照而影响性能）(Java system property:zookeeper.snapCount&nbsp;) </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> traceFile </td> 
 <td style="vertical-align:top;"> 用于记录所有请求的log，一般调试过程中可以使用，但是生产环境不建议使用，会严重影响性能。(Java system property:?&nbsp;requestTraceFile&nbsp;) </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> maxClientCnxns </td> 
 <td style="vertical-align:top;"> 单个客户端与单台服务器之间的连接数的限制，是ip级别的，默认是60，如果设置为0，那么表明不作任何限制。请注意这个限制的使用范围，仅仅是单台客户端机器与单台ZK服务器之间的连接数限制，不是针对指定客户端IP，也不是ZK集群的连接数限制，也不是单台ZK对所有客户端的连接数限制。指定客户端IP的限制策略，这里有一个patch，可以尝试一下：<a href="http://rdc.taobao.com/team/jm/archives/1334" rel="nofollow">http://rdc.taobao.com/team/jm/archives/1334</a>（No Java system property） </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> clientPortAddress </td> 
 <td style="vertical-align:top;"> 对于多网卡的机器，可以为每个IP指定不同的监听端口。默认情况是所有IP都监听&nbsp;clientPort&nbsp;指定的端口。&nbsp;&nbsp;New in 3.3.0 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> minSessionTimeoutmaxSessionTimeout </td> 
 <td style="vertical-align:top;"> Session超时时间限制，如果客户端设置的超时时间不在这个范围，那么会被强制设置为最大或最小时间。默认的Session超时时间是在2 *&nbsp;&nbsp;tickTime ~ 20 * tickTime&nbsp;这个范围&nbsp;New in 3.3.0 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> fsync.warningthresholdms </td> 
 <td style="vertical-align:top;"> 事务日志输出时，如果调用fsync方法超过指定的超时时间，那么会在日志中输出警告信息。默认是1000ms。(Java system property:&nbsp;&nbsp;fsync.warningthresholdms&nbsp;)New in 3.3.4 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> autopurge.purgeInterval </td> 
 <td style="vertical-align:top;"> 在上文中已经提到，3.4.0及之后版本，ZK提供了自动清理事务日志和快照文件的功能，这个参数指定了清理频率，单位是小时，需要配置一个1或更大的整数，默认是0，表示不开启自动清理功能。(No Java system property)&nbsp;&nbsp;New in 3.4.0 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> autopurge.snapRetainCount </td> 
 <td style="vertical-align:top;"> 这个参数和上面的参数搭配使用，这个参数指定了需要保留的文件数目。默认是保留3个。(No Java system property)&nbsp;&nbsp;New in 3.4.0 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> electionAlg </td> 
 <td style="vertical-align:top;"> 在之前的版本中， 这个参数配置是允许我们选择leader选举<a href="http://lib.csdn.net/base/31" rel="nofollow">算法</a>，但是由于在以后的版本中，只会留下一种“TCP-based version of fast leader election”算法，所以这个参数目前看来没有用了，这里也不详细展开说了。(No Java system property) </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> initLimit </td> 
 <td style="vertical-align:top;"> Follower在启动过程中，会从Leader同步所有最新数据，然后确定自己能够对外服务的起始状态。Leader允许F在&nbsp;initLimit&nbsp;时间内完成这个工作。通常情况下，我们不用太在意这个参数的设置。如果ZK集群的数据量确实很大了，F在启动的时候，从Leader上同步数据的时间也会相应变长，因此在这种情况下，有必要适当调大这个参数了。(No Java system property) </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> syncLimit </td> 
 <td style="vertical-align:top;"> 在运行过程中，Leader负责与ZK集群中所有机器进行通信，例如通过一些心跳检测机制，来检测机器的存活状态。如果L发出心跳包在syncLimit之后，还没有从F那里收到响应，那么就认为这个F已经不在线了。注意：不要把这个参数设置得过大，否则可能会掩盖一些问题。(No Java system property) </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> leaderServes </td> 
 <td style="vertical-align:top;"> 默认情况下，Leader是会接受客户端连接，并提供正常的读写服务。但是，如果你想让Leader专注于集群中机器的协调，那么可以将这个参数设置为no，这样一来，会大大提高写操作的性能。(Java system property: zookeeper.&nbsp;leaderServes&nbsp;)。 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> server.x=[hostname]:nnnnn[:nnnnn] </td> 
 <td style="vertical-align:top;"> 这里的x是一个数字，与myid文件中的id是一致的。右边可以配置两个端口，第一个端口用于F和L之间的数据同步和其它通信，第二个端口用于Leader选举过程中投票通信。&nbsp;&nbsp; (No Java system property) </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> group.x=nnnnn[:nnnnn]weight.x=nnnnn </td> 
 <td style="vertical-align:top;"> 对机器分组和权重设置，可以&nbsp;&nbsp;<a href="http://zookeeper.apache.org/doc/r3.4.3/zookeeperHierarchicalQuorums.html" rel="nofollow">参见这里</a>(No Java system property) </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> cnxTimeout </td> 
 <td style="vertical-align:top;"> Leader选举过程中，打开一次连接的超时时间，默认是5s。(Java system property: zookeeper.&nbsp;&nbsp;cnxTimeout&nbsp;) </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> zookeeper.DigestAuthenticationProvider .superDigest </td> 
 <td style="vertical-align:top;"> ZK权限设置相关，具体参见&nbsp;&nbsp;<a href="http://nileader.blog.51cto.com/1381108/930635" rel="nofollow">《&nbsp;&nbsp;使用super&nbsp;&nbsp;身份对有权限的节点进行操作&nbsp;》&nbsp;</a>&nbsp;和&nbsp;&nbsp;<a href="http://nileader.blog.51cto.com/1381108/795525" rel="nofollow">《&nbsp;ZooKeeper&nbsp;&nbsp;&nbsp;权限控制&nbsp;》</a> </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> skipACL </td> 
 <td style="vertical-align:top;"> 对所有客户端请求都不作ACL检查。如果之前节点上设置有权限限制，一旦服务器上打开这个开头，那么也将失效。(Java system property:&nbsp;&nbsp;zookeeper.skipACL&nbsp;) </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> forceSync </td> 
 <td style="vertical-align:top;"> 这个参数确定了是否需要在事务日志提交的时候调用&nbsp;<a href="http://rdc.taobao.com/team/%5C/java%5C/jdk1.6.0_22%5C/jre%5C/lib%5C/rt.jar%3Cjava.nio.channels%28FileChannel.class%E2%98%83FileChannel" rel="nofollow">FileChannel&nbsp;</a>.force来保证数据完全同步到磁盘。(Java system property:&nbsp;zookeeper.forceSync&nbsp;) </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:top;"> jute.maxbuffer </td> 
 <td style="vertical-align:top;"> 每个节点最<a href="http://lib.csdn.net/base/20" rel="nofollow">大数据</a>量，是默认是1M。这个限制必须在server和client端都进行设置才会生效。(Java system property:&nbsp;jute.maxbuffer&nbsp;) </td> 
 </tr> 
 </tbody> 
</table>

zookeeper有这样一个特性：集群中只要有过半的机器是正常工作的，那么整个集群对外就是可用的。也就是说如果有2个zookeeper，那么只要有1个死了zookeeper就不能用了，因为1没有过半，所以2个zookeeper的死亡容忍度为0；同理，要是有3个zookeeper，一个死了，还剩下2个正常的，过半了，所以3个zookeeper的容忍度为1；同理你多列举几个：2 -> 0; 3 -> 1; 4 - >1; 5 -> 2; 6 -> 2会发现一个规律，2n和2n-1的容忍度是一样的，都是n-1，所以为了更加高效，何必增加那一个不必要的zookeeper呢。

\--高级配置参数  
dataLogDir ---用于单独设置transaction log的目录，transaction log分离可以避免和普通log还有快照的竞争  
globalOutstandingLimit --client请求队列的最大长度，防止内存溢出，默认值为1000  
preAllocSize ---预分配的Transaction log空间为block个proAllocSize KB，默认block为64M，一般不需要更改，除非snapshot过于频繁  
snapCount ---在snapCount个snapshot后写一次transaction log，默认值是100,000  
traceFile ---用于记录请求的log，打开会影响性能，用于debug的，最好不要定义  
maxClientCnxns ----最大并发客户端数，用于防止DOS的，默认值是10，设置为0是不加限制  
clientPortBindAddress ---3.3.0后新增参数，可是设置指定的client ip以及端口，不设置的话等于ANY:clientPort  
minSessionTimeout ---3.3.0后新增参数，最小的客户端session超时时间，默认值为2个tickTime，单位是毫秒  
maxSessionTimeout ---3.3.0后新增参数，最大的客户端session超时时间，默认值为20个tickTime，单位是毫秒  
\--集群参数  
electionAlg ---用于选举的实现的参数，0为以原始的基于UDP的方式协作，1为不进行用户验证的基于UDP的快速选举，2为进行用户验证的基于UDP的快速选举，3为基于TCP的快速选举，默认值为3  
initLimit ---多少个心跳时间内，允许其他server连接并初始化数据，如果ZooKeeper管理的数据较大，则应相应增大这个值  
leaderServes ---leader是否接受客户端连接。默认值为yes。 leader负责协调更新。当更新吞吐量远高于读取吞吐量时，可以设置为不接受客户端连接，以便leader可以专注于同步协调工作。默认值是yes，说明leader可以接受客户端连接。（注意：当集群中有超过3台ZooKeeper Server时，强烈建议打开leader选举 ）  
server.x=\[hostname\]:nnnnn\[:nnnnn\], etc ---配置集群里面的主机信息，其中server.x的x要写在myid文件中，决定当前机器的id，第一个port用于连接leader，第二个用于leader选举。如果electionAlg为0，则不需要第二个port。hostname也可以填ip。  
syncLimit ---多少个tickTime内，允许follower同步，如果follower落后太多，则会被丢弃。  
group.x=nnnnn\[:nnnnn\] ---  
weight.x=nnnnn ---

这两个是用于集群分组的参数，暂时只有3台机器，没仔细研究，先给个例子看看吧  
group.1=1:2:3 group.2=4:5:6 group.3=7:8:9 ? weight.1=1 weight.2=1 weight.3=1 weight.4=1 weight.5=1 weight.6=1 weight.7=1 weight.8=1 weight.9=1