ZooKeeper监控工具和配方技术文档

1. 安装指南

系统要求

• ZooKeeper版本：3.4.0 或更新版本。也可以在最新的3.3.x版本上应用ZOOKEEPER-744补丁。
• Python版本：2.6（之前版本可能也可以工作，但未经验证）。

安装步骤

• 从ZooKeeper的主干中获取已提交的监控工具和配方（ZOOKEEPER-799），位于 src/contrib/monitoring 目录下。
• 使用ZooKeeper JIRA提交问题或功能请求。
• 确保服务器理解 'mntr' 四字母单词命令。

2. 项目使用说明

本项目提供了两种监控ZooKeeper集群的方式：

1. 使用 'mntr' 四字母单词命令。
2. 使用JMX查询MBeans。

本项目主要包含使用第一种方式的监控工具和配方。

监控示例

运行以下命令来获取ZooKeeper服务器的状态信息：

$ echo 'mntr' | nc localhost 2181

输出示例：

zk_version  3.4.0--1, built on 06/19/2010 15:07 GMT
zk_avg_latency  141
zk_max_latency  1788
zk_min_latency  0
zk_packets_received 385466
zk_packets_sent 435364
zk_outstanding_requests 0
zk_server_state follower
zk_znode_count  5
zk_watch_count  0
zk_ephemerals_count 0
zk_approximate_data_size    41
zk_open_file_descriptor_count   20
zk_max_file_descriptor_count    1024

3. 项目API使用文档

本项目提供的 check_zookeeper.py 脚本可以与Nagios、Cacti和Ganglia一起使用。

Nagios使用方法

./check_zookeeper.py -o nagios -s "<server-or-list-of-servers>" -k <key> -w <warning> -c <critical>

Cacti使用方法

定义一个自定义数据输入方法：

./check_zookeeper.py -o cacti -s "<list-of-servers>" -k <key> --leader

输出集群领导者的单个值，或者：

./check_zookeeper.py -o cacti -s "<list-of-servers>" -k <key>

输出每个集群节点的多个值。

Ganglia使用方法

安装ganglia插件或：

./check_zookeeper.py -o ganglia -s "<current-zookeeper-node>"

使用gmetric发送ZooKeeper节点状态数据。

4. 项目安装方式

请参考项目readme文件中的说明进行安装，并检查子目录下的配置详情和每个平台的示例配置。

注意： 使用四字母单词命令时，请参考ZooKeeper官方文档中的相关命令说明。

---

本文档旨在帮助用户详细了解并使用ZooKeeper监控工具和配方，如有任何疑问或需要进一步的帮助，请通过ZooKeeper JIRA与我们联系。