集群配置参数 - 企业云产品文档

功能概述

ZooKeeper 支持自定义部分参数的值，用户可以根据自己的业务情况对集群运行参数进行调整，使该服务发挥出最优性能。

配置更新后，系统将依次自动重启所有 ZooKeeper 服务，使配置生效。重启所需时间与各节点服务器配置有关，一般在 1 分钟之内可以完成重启。

约束限制

ZooKeeper 3.4.9 - v1.0.0 版本暂不支持修改配置参数。

配置参数说明

ZooKeeper 常用配置参数说明如下。更多相关配置参数的说明和用法，可参考 ZooKeeper 官方文档。

参数说明

参数	说明
启用管理员用户	是否开启管理员用户。管理员用户可以对集群、ZNodes 及其数据，以及权限控制（ACL）进行管理。设置为 `true`，表示启用管理员用户。默认为 `false`，不启用。
管理员用户名	管理员用户的用户名。启用管理员用户时，该参数有效。默认值为 `super`。命名规则：可以由小写字母 `a～z`、数字 `0～9`、特殊字符 -_`组成，且必须以字母开头，长度为 `4~12 的字符串。
管理员密码	管理员用户的密码。启用管理员用户时，该参数有效。命名规则：可以由小写字母 `a～z`、大写字母 `A～Z`、数字 `0～9`、特殊字符 !@#$%&*()`组成，且长度为 `4~32 的字符串。
tickTime	ZooKeeper 最小时间单位 Tick 的毫秒数，用来调整心跳和超时。比如 Session 的最短超时时间为两个 Tick。默认值为 `2000`。
initLimit	允许 Follower 跟 Leader 进行初始化连接和数据同步的最长时间，以 Tick 为单位。默认值为 `10`，当 ZooKeeper 管理的数据量很大时，可调大该值。
syncLimit	允许 Follower 同步数据的最长时间，以 Tick 为单位。默认值为 `5`，当 Follower 的数据太旧，此 Follower 将被丢弃。
maxClientCnxns	限制以 IP 地址标识的客户端与单个 ZooKeeper 节点的最大并发连接数，用来防止某些 DoS 攻击，包括 `file descriptor exhaustion`。默认值为 `1000`，设为 `0` 表示不做限制。
autopurge.snapRetainCount	当自动清除功能（Auto Purge）开启时，需保留的最新快照和事务日志文件数，超过该数量的文件将被清除。默认值为 `3`。
autopurge.purgeInterval	自动清除功能的执行间隔，以 `小时` 为单位。默认值 `0` 表示不开启。
4lw.commands.whitelist	允许用户使用的 4 字母命令列表。 `mntr` 监控命令永远开启，平台用 `mntr` 命令来获取节点监控数据。
tcpKeepAlive	在 Socket 层面启用 TCP Keepalive 来防止节点之间意外断开。默认值 `false` 表示不开启。
启用文件查看控制台	默认值 `true` 表示开启，开启后，用户可通过 Web 浏览器 `http://ip` 查看、下载日志等文件。
文件查看用户名	自录文件查看控制台的用户名，启用文件查看控制台时，该参数有效。默认值为 `admin`。命名规则：可以由小写字母 `a～z`、数字 `0～9`、特殊字符 -_`组成，且以字母开头，长度为 `4~22 的字符串。
文件查看密码	登录文件查看控制台的密码，启用文件查看控制台时，该参数有效。默认值为 `admin`。命名规则：可以由小写字母 `a～z`、大写字母 `A～Z`、数字 `0～9`、特殊字符 !@#$%&*()`组成，且长度为 `4~32 的字符串。
启用 REST 网关	默认值为 `true`，表示开启，开启后，用户可通过 REST 网关提供的 HTTP 接口访问 ZooKeeper 节点数据。
是否启用 Exporter 服务	默认为 `true`，表示启用 Exporter 服务，用户需根据实际情况选择服务端口号。启用 Exporter 服务后，用户可以通过 `curl http://<ZooKeeper_server_IP>:7000/metrics` 查看 ZooKeeper 服务相关指标。详情参考官方文档。修改后会滚动重启 ZooKeeper 服务。
Exporter 服务端口号	默认值为 `7000`，修改后会滚动重启 ZooKeeper 服务。取值范围为 `7000 ~ 9199`。

启用管理员用户

是否开启管理员用户。管理员用户可以对集群、ZNodes 及其数据，以及权限控制（ACL）进行管理。

设置为 true，表示启用管理员用户。
默认为 false，不启用。

管理员用户名

管理员用户的用户名。

启用管理员用户时，该参数有效。默认值为 super。
命名规则：可以由小写字母 a～z、数字 0～9、特殊字符 -_`组成，且必须以字母开头，长度为 `4~12 的字符串。

管理员密码

管理员用户的密码。

启用管理员用户时，该参数有效。
命名规则：可以由小写字母 a～z、大写字母 A～Z、数字 0～9、特殊字符 !@#$%&*()`组成，且长度为 `4~32 的字符串。

tickTime

ZooKeeper 最小时间单位 Tick 的毫秒数，用来调整心跳和超时。

比如 Session 的最短超时时间为两个 Tick。
默认值为 2000。

initLimit

允许 Follower 跟 Leader 进行初始化连接和数据同步的最长时间，以 Tick 为单位。
默认值为 10，当 ZooKeeper 管理的数据量很大时，可调大该值。

syncLimit

允许 Follower 同步数据的最长时间，以 Tick 为单位。
默认值为 5，当 Follower 的数据太旧，此 Follower 将被丢弃。

maxClientCnxns

限制以 IP 地址标识的客户端与单个 ZooKeeper 节点的最大并发连接数，用来防止某些 DoS 攻击，包括 file descriptor exhaustion。
默认值为 1000，设为 0 表示不做限制。

autopurge.snapRetainCount

当自动清除功能（Auto Purge）开启时，需保留的最新快照和事务日志文件数，超过该数量的文件将被清除。
默认值为 3。

autopurge.purgeInterval

自动清除功能的执行间隔，以 小时 为单位。默认值 0 表示不开启。

4lw.commands.whitelist

允许用户使用的 4 字母命令列表。
mntr 监控命令永远开启，平台用 mntr 命令来获取节点监控数据。

tcpKeepAlive

在 Socket 层面启用 TCP Keepalive 来防止节点之间意外断开。默认值 false 表示不开启。

启用文件查看控制台

默认值 true 表示开启，开启后，用户可通过 Web 浏览器 http://ip 查看、下载日志等文件。

文件查看用户名

自录文件查看控制台的用户名，启用文件查看控制台时，该参数有效。

默认值为 admin。
命名规则：可以由小写字母 a～z、数字 0～9、特殊字符 -_`组成，且以字母开头，长度为 `4~22 的字符串。

文件查看密码

登录文件查看控制台的密码，启用文件查看控制台时，该参数有效。

默认值为 admin。
命名规则：可以由小写字母 a～z、大写字母 A～Z、数字 0～9、特殊字符 !@#$%&*()`组成，且长度为 `4~32 的字符串。

启用 REST 网关

默认值为 true，表示开启，开启后，用户可通过 REST 网关提供的 HTTP 接口访问 ZooKeeper 节点数据。

是否启用 Exporter 服务

默认为 true，表示启用 Exporter 服务，用户需根据实际情况选择服务端口号。
启用 Exporter 服务后，用户可以通过 curl http://<ZooKeeper_server_IP>:7000/metrics 查看 ZooKeeper 服务相关指标。详情参考官方文档。
修改后会滚动重启 ZooKeeper 服务。

Exporter 服务端口号

默认值为 7000，修改后会滚动重启 ZooKeeper 服务。
取值范围为 7000 ~ 9199。

修改集群配置参数

通过 Web 浏览器登录企业云平台的 Console。
在顶部菜单栏中选择产品与服务 > 消息队列与中间件 > ZooKeeper 服务，进入 ZooKeeper 管理页面。
在 ZooKeeper 管理页面，点击目标集群 ID，进入集群详情页面。
在右侧配置参数标签页，查看 ZooKeeper 集群当前版本所支持的参数配置项、参数描述及参数当前值。
点击修改属性，各参数值即进入可编辑状态，用户参考配置参数取值范围和描述，修改参数值。
确认参数信息无误后，点击保存，返回参数列表页面。