Skip to main content

Zookeeper's four letters command wrapper and web monitor.

Project description

image0 image1

Module lets you call ZooKeeper commands - four letters commands over TCP - It also has built-in web monitor. Based on Tornado, compatibile with Python 2.7.x, 3.x and above. It doesn’t require zookeeper, nor zookeeper’s headers (since it doesn’t utilize zkpython).


It can be installed from pypi or directly from git repository.

pip install zookeeper_monitor


git clone
cd zookeeper_monitor/
python install



from zookeeper_monitor import zk

def some_coroutine()
    host = zk.Host('zookeeper.addr.ip', 2181)
    # you can run each command as a coroutine example:
    # get srvr data
    srvr_data = yield host.srvr()
    # get stat data
    stat_data = yield host.stat()
    # get server state
    ruok = yield host.ruok()
    # stop zookeeper
    yield host.kill()

You can wrap it to sync code if you are not using tornado

from tornado.ioloop import IOLoop


Web monitor

To run web monitor you need to provide configuration, if you don’t, it will used localhost:2181 by default.

python -m zookeeper_monitor.web

# with configuration file
python -m zookeeper_monitor.web -c /somepath/cluster.json

# to see available options
python -m zookeeper_monitor.web --help

Next you navigate to (or whatever you specified).


Defining cluster cluster.json (json or yaml)

    "name": "brand-new-zookeeper-cluster",
    "hosts": [
        {"addr": "", "port": 2181, "dc":"eu-west"},
        {"addr": "", "port": 2181, "dc":"us-east"},
        {"addr": "", "port": 2181, "dc":"eu-west"}
  • name (string) - cluster name.
  • hosts (list) - List of hosts running ZooKeeper connected in cluster:
    • addr (string): IP or domain, mandatory
    • port (int): ZooKeeper port, optional, default 2181
    • dc (string): datacenter/location name, optional


Cluster view image22

Node stat view image23




  • more tests
  • more stats in webmonitor
  • parse zookeeper version
  • new commands in zookeeper 3.3 and 3.4
  • parse output of dump, reqs


0.3.0 - implemented mntr, credits to Robb Wagoner

0.2.5 - implemented with_timeout, handlers get_template, py3.3 gen.Task in Host, css colors

0.2.4 - separate getter template/static dir

0.2.3 - fix import in py3 web

0.2.2 - clean ups: pylint, README, classifiers

0.2.1 - fix package, fix tests

0.2.0 - implement more commands, updated docs

0.1.2 - release - pypi

0.1.1 - clean up

0.1.0 - public standalone

0.0.3 - 0.0.9 - refactor, tests

0.0.2 - working draft

0.0.1 - initial concept

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for zookeeper_monitor, version 0.3.0
Filename, size File type Python version Upload date Hashes
Filename, size zookeeper_monitor-0.3.0.tar.gz (18.2 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page