ALM-45427 ClickHouse服务在ZooKeeper的容量配额使用率超过阈值

告警解释

告警模块按60秒周期检测ClickHouse服务在ZooKeeper的容量配额使用百分比，当检测到使用百分比超过阈值（90%），系统产生此告警。

当系统检测到使用百分比低于阈值，且告警处理完成时，告警恢复。

告警属性

告警参数

对系统的影响

ClickHouse在ZooKeeper的容量配额超过阈值后，无法通过FusionInsight Manager对ClickHouse进行集群操作，无法使用ClickHouse服务功能。

可能原因

• ClickHouse在使用过程中，如表创建、插入或删除表数据等操作时，ClickHouse会在ZooKeeper的节点中创建znode，随着业务量的增加该znode实际容量可能会超过配置的阈值。
• ClickHouse在ZooKeeper上的元数据目录/clickhouse未设置有效的配额限制。

处理步骤

检查ClickHouse在ZooKeeper的znode节点容量值

1. 登录ZooKeeper客户端所在主机节点，执行以下命令登录ZooKeeper客户端工具。

   切换到客户端安装目录。

   例如：cd /opt/client

   执行以下命令配置环境变量。

   source bigdata_env

   执行以下命令进行用户认证。(普通模式跳过此步骤)

   kinit 组件业务用户

   执行以下命令登录客户端工具。

   zkCli.sh -server ZooKeeper角色实例所在节点业务IP: clientPort

2. 执行如下命令查看ZooKeeper上ClickHouse使用的配额情况，查看配额信息是否设置正常。
   listquota /clickhouse

   absolute path is /zookeeper/quota/clickhouse
   Quota for path /clickhouse does not exist.

   • 如上显示为ClickHouse使用的配额信息设置异常，执行3。
   • 否则，执行5。

3. 在FusionInsight Manager首页，选择“集群 > 服务 > ZooKeeper > 配置 > 全部配置”，搜索“quotas.auto.check.enable”，检查参数的值是否为“true”。

   如果“quotas.auto.check.enable”参数设置不为“true”，则修改该参数为“true”，单击“保存”保存配置。

4. 在FusionInsight Manager首页，选择“集群 > 服务 > ClickHouse > 更多 > 同步配置”，执行ClickHouse同步配置操作，同步配置成功后，执行1。
5. 计算返回的结果中Output stat的bytes值与Output quota的bytes值之比是否大于0.9。
   listquota /clickhouse

   absolute path is /zookeeper/quota/clickhouse
   Output quota for /clickhouse count=200000,bytes=1000000000
   Output stat for /clickhouse count=2667,bytes=60063

   如上，Output stat对应的bytes为：60063，Output quota的bytes为：1000000000。

   • 是，执行6。
   • 否，等待五分钟查看告警是否清除，若还未消除，执行8。

6. 在FusionInsight Manager首页，选择“集群 > 服务 > ClickHouse > 配置 > 全部配置”，搜索“clickhouse.zookeeper.quota.size”参数，将该参数的值调整为5中Output stat的bytes值的2倍，6000000为上限，超过6000000存在较高风险，请谨慎配置。
7. 重启告警信息对应的ClickHouse实例，等待五分钟，查看告警是否消除。
   • 是，处理完毕。
   • 否，再次执行6，等待五分钟，查看告警是否消除，若还未消除，执行8。

收集故障信息

8. 在FusionInsight Manager界面，选择“运维 > 日志 > 下载”。
9. 在“服务”中勾选待操作集群的“ClickHouse”。
10. 在“主机”中选择对应的主机。
11. 单击右上角的时间编辑按钮，设置日志收集的“开始时间”和“结束时间”分别为告警产生时间的前后1小时，单击“下载”。
12. 请联系运维人员，并发送已收集的故障日志信息。

告警清除

此告警修复后，系统会自动清除此告警，无需手工清除。

参考信息

不涉及。