Google is committed to advancing racial equity for Black communities. See how.

ZooKeeper problems

These topics explain how to troubleshoot issues with ZooKeeper such as connection loss errors.

ZooKeeper connection loss errors

Sometimes the Edge components such as Message Processors and Management Servers may lose connectivity with ZooKeeper. This can lead to issues such as API Proxy deployment errors, Management API failures, and so on.


This section provides information and guidance on some specific procedures that can be followed for troubleshooting and resolving ZooKeeper connection loss errors.

Problem Error message in logs Playbook
ZooKeeper connection loss errors

You may see the following error in Router or Message Processor logs:

org.apache.zookeeper.KeeperException$ConnectionLossException: KeeperErrorCode = ConnectionLoss
org.apache.zookeeper.KeeperException.create( ~[zookeeper-3.4.6.jar:3.4.6-1569965]


You may see the following error while deploying API Proxy in Edge UI:

Error Fetching Deployments Error while checking path existence for path: PATH
ZooKeeper Connection Loss Errors

Diagnostic information

If you need assistance from Apigee Support on the ZooKeeper connection loss errors, then gather the following diagnostic information and share it in the support case:

Diagnostic information Location How do I gather this information?
ZooKeeper health check commands ZooKeeper
echo "ruok" | nc localhost 2181 | tee /tmp/zookeeper_NODE#_ruok_$(hostname)-$(date +%Y.%m.%d_%H.%M.%S).txt
echo srvr | nc localhost 2181 | tee /tmp/zookeeper_NODE#_srvr_$(hostname)-$(date +%Y.%m.%d_%H.%M.%S).txt
echo mntr | nc localhost 2181 | tee /tmp/zookeeper_NODE#_mntr_$(hostname)-$(date +%Y.%m.%d_%H.%M.%S).txt
echo stat | nc localhost 2181 | tee /tmp/zookeeper_NODE#_stat_$(hostname)-$(date +%Y.%m.%d_%H.%M.%S).txt
echo cons | nc localhost 2181 | tee /tmp/zookeeper_NODE#_cons_$(hostname)-$(date +%Y.%m.%d_%H.%M.%S).txt
ZooKeeper logs and associated files ZooKeeper
tar cvzf /tmp/zookeeper_logs_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/log/apigee-zookeeper/*.log /opt/apigee/apigee-zookeeper/conf/zoo.cfg /opt/apigee/data/apigee-zookeeper/data/myid

Compress all the diagnostic data ZooKeeper
tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/zookeeper_*