ZooKeeper

ZooKeeper is a centralized service for maintaining configuration information, naming, providing distributed synchronization, and providing group services.

image0

The Librato Agent allows you to easily monitor ZooKeeper’s health and performance. We use collectd’s native ZooKeeper plugin to gather metrics from your running ZooKeeper instance(s).

Installation

The ZooKeeper integration depends on the Librato Agent. If you haven’t already, you will first need to install the Librato Agent. Once this is complete, select the ZooKeeper icon in the integrations catalogue.

image1

Toggle the Enabled switch to activate the ZooKeeper integration on your Librato account and create the preconfigured ZooKeeper Space.

image2

At this point your integration is complete and any ZooKeeper metrics associated with this integration will be allowed through your Librato Agent service-side filters.

Plugin Configuration

By default, ZooKeeper listens on localhost port 2181. If necessary, this can be adjusted in your /opt/collectd/etc/collectd.conf.d/zookeeper.conf file.

LoadPlugin zookeeper
<Plugin "zookeeper">
  Host "127.0.0.1"
  Port "2181"
</Plugin>

Note: You must restart the agent after any changes to your Librato Agent configuration files.

$ sudo service collectd restart

At this point you should begin seeing librato.zookeeper.* metrics in your Librato account.

ZooKeeper Workspace

Visit your preconfigured Space to observe your new metrics as they stream in. You can use our dynamic tags field at the top to filter your view to a subset of metrics.

image3

Zookeeper Metrics and tags

The Zookeeper integration supports the following metrics and tags.

Note: All metrics are prefixed with librato.zookeeper..

Tag Name Description
host Host name or IP address of monitored server

Request statistics

Description Name Tags
Average latency latency.avg host
Minimum latency latency.min host
Max Latency latency.max host
Number of outstanding requests requests.outstanding host
Number of packets sent packets.sent host
Number of packets received packets.received host
Approximate size of sent data in bytes bytes.approximate_data_size host

Node statistics

Description Name Tags
Total number of nodes znodes host
Total number of ephemeral nodes emphemerals host
Total number of follower, non-leader nodes followers host
Total number of follower nodes synced with the leader node synced_followers host

FAQ

For specific answers to Librato Agent questions check out our Librato Agent FAQ.

Please let us know what you think about this integration. We would love to incorporate your feedback and any ideas you have on dashboard design into the ongoing development of our integrations.