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.

Setup

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)

shown as
zookeeper.bytes_sent
(gauge)

shown as
zookeeper.packets_received
(gauge)
The number of packets received.
shown as packet
zookeeper.packets_sent
(gauge)
The number of packets sent.
shown as packet
zookeeper.connections
(gauge)
The total count of client connections.
shown as connection
zookeeper.datadog_client_exception
(rate)
The exception rate seen by the Datadog Agent when trying to collect stats.
shown as error
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.timeouts
(rate)
The rate of timeouts the Datadog Agent received when trying to collect stats.
shown as occurrence
zookeeper.zxid.count
(gauge)

shown as
zookeeper.zxid.epoch
(gauge)

shown as