Stackstate-Zookeeper Integration

Overview

Connect ZooKeeper to Stackstate in order to:

  • Visualize ZooKeeper performance and utilization.
  • Correlate the performance of ZooKeeper with the rest of your applications.

For more details about configuring this integration refer to the following file(s) on GitHub:

ZooKeeper Graph

Configuration

  1. Configure the Agent to connect to ZooKeeper. Edit conf.d/zk.yaml

    init_config:
    
    instances:
      - host: localhost
        port: 2181
        timeout: 3
    
  2. Restart the Agent

Validation

Execute the info command and verify that the integration check has passed. The output of the command should contain a section similar to the following:

Checks
======

  [...]

  zk
  --
    - instance #0 [OK]
    - Collected 8 metrics & 0 events

Metrics

zookeeper.bytes_received
(gauge)
zookeeper.bytes_sent
(gauge)
zookeeper.packets_received
(gauge)
The number of packets received.
shown as packet/second
zookeeper.packets_sent
(gauge)
The number of packets sent.
shown as packet/second
zookeeper.connections
(gauge)
The total count of client connections.
shown as connection
zookeeper.latency.avg
(gauge)
The amount of time it takes for the server to respond to a client request.
shown as millisecond
zookeeper.latency.max
(gauge)
The amount of time it takes for the server to respond to a client request.
shown as millisecond
zookeeper.latency.min
(gauge)
The amount of time it takes for the server to respond to a client request.
shown as millisecond
zookeeper.nodes
(gauge)
The number of znodes in the ZooKeeper namespace (the data).
shown as node
zookeeper.outstanding_requests
(gauge)
The number of queued requests when the server is under load and is receiving more sustained requests than it can process.
shown as request
zookeeper.zxid.count
(gauge)
zookeeper.zxid.epoch
(gauge)