JMX

Apache BookKeeper has extensive support for JMX, which allows viewing and managing a BookKeeper cluster.

This document assumes that you have basic knowledge of JMX. See Sun JMX Technology page to get started with JMX.

See the JMX Management Guide for details on setting up local and remote management of VM instances. By default the included bookkeeper script supports only local management - review the linked document to enable support for remote management (beyond the scope of this document).

Bookie Server is a JMX manageable server, which registers the proper MBeans during initialization to support JMX monitoring and management of the instance.

Bookie Server MBean Reference

This table details JMX for a bookie server.

_.MBean_.MBean Object Name_.Description
BookieServerBookieServer_Represents a bookie server. Note that the object name includes bookie port that the server listens on. It is the root MBean for bookie server, which includes statistics for a bookie server. E.g. number packets sent/received, and statistics for add/read operations.
BookieBookieProvide bookie statistics. Currently it just returns current journal queue length waiting to be committed.
LedgerCacheLedgerCacheProvide ledger cache statistics. E.g. number of page cached in page cache, number of files opened for ledger index files.