Skip to main content

A simple healthcheck wrapper to monitor zookeeper.

Project description

zookeeper-healthcheck

Build Status PyPI PyPI - Python Version License

A simple healthcheck wrapper to monitor ZooKeeper.

ZooKeeper Healthcheck is a simple server that provides a singular API endpoint to determine the health of a ZooKeeper instance. This can be used to alert or take action on unhealthy ZooKeeper instances.

The service checks the health by sending netcat commands as well as checking that ZooKeeper is in a desired mode. It utilizes the commands echo ruok | nc zookeeper-host zookeeper-port and echo stat | nc zookeeper-host zookeeper-port | grep Mode to do so.

By default, the root endpoint / will return 200 OK healthy if ZooKeeper responds imok and is in mode leader or follower. It will return 503 Service Unavailable if ZooKeeper does not respond with imok or if its in an undesired mode (by default standalone).

Usage

ZooKeeper Healthcheck can be installed via pip. Both python and pip are required, as well as echo, nc and grep.

Command-Line

Install zookeeper-healthcheck via pip:

pip install zookeeper-healthcheck

To start the healthcheck server, run:

zookeeper-healthcheck

The server will now be running on localhost:12181.

Configuration

ZooKeeper Healthcheck can be configured via command-line arguments or by environment variables.

Port

The port for the zookeeper-healthcheck API.

Usage Value
Environment Variable HEALTHCHECK_PORT
Command-Line Argument --port
Default Value 12181

ZooKeeper Host

The host of the ZooKeeper instance to run the health check against. This is used with nc.

Usage Value
Environment Variable HEALTHCHECK_ZOOKEEPER_HOST
Command-Line Argument --zookeeper-host
Default Value localhost

ZooKeeper Port

The port of the ZooKeeper instance to run the health check against. This is used with nc.

Usage Value
Environment Variable HEALTHCHECK_ZOOKEEPER_PORT
Command-Line Argument --zookeeper-port
Default Value 2181

Healthy Modes

A comma-separated list of ZooKeeper modes to be marked as healthy. Any modes not in this list will mark ZooKeeper as unhealthy.

Usage Value
Environment Variable HEALTHCHECK_HEALTHY_MODES
Command-Line Argument --healthy-modes
Default Value leader,follower
Valid Values leader, follower, standalone

Log Level

The level of logs to be shown by the application.

Usage Value
Environment Variable HEALTHCHECK_LOG_LEVEL
Command-Line Argument --log-level
Default Value INFO
Valid Values DEBUG, INFO, WARNING, ERROR

All healthy responses are logged at INFO. Unhealthy responses are logged at WARNING. Any unexpected errors are logged at ERROR.

License

Copyright (c) 2019 Shawn Seymour.

Licensed under the Apache 2.0 license.

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-healthcheck, version 0.0.1
Filename, size File type Python version Upload date Hashes
Filename, size zookeeper_healthcheck-0.0.1-py3-none-any.whl (12.8 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size zookeeper-healthcheck-0.0.1.tar.gz (5.8 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