---
title: Telegraf Documentation
description: Telegraf plugin for collecting metrics from Apache Zookeeper
url: https://docs.influxdata.com/telegraf/v1/input-plugins/zookeeper/
estimated_tokens: 2526
product: Telegraf
version: v1
---

-   Telegraf v0.2.0+

# Apache Zookeeper Input Plugin

This plugin collects variables from [Zookeeper](https://zookeeper.apache.org) instances using the [`mntr` command](https://zookeeper.apache.org/doc/current/zookeeperAdmin.html#sc_zkCommands).

If the Prometheus Metric provider is enabled in Zookeeper use the [prometheus plugin](/telegraf/v1/plugins/#input-prometheus) instead with `http://<ip>:7000/metrics`.

**Introduced in:** Telegraf v0.2.0 **Tags:** applications **OS support:** all

## Global configuration options

Plugins support additional global and plugin configuration settings for tasks such as modifying metrics, tags, and fields, creating aliases, and configuring plugin ordering. See [CONFIGURATION.md](/telegraf/v1/configuration/#plugins) for more details.

## Configuration

```toml
# Reads 'mntr' stats from one or many zookeeper servers
[[inputs.zookeeper]]
  ## An array of address to gather stats about. Specify an ip or hostname
  ## with port. ie localhost:2181, 10.0.0.1:2181, etc.

  ## If no servers are specified, then localhost is used as the host.
  ## If no port is specified, 2181 is used
  servers = [":2181"]

  ## Timeout for metric collections from all servers.  Minimum timeout is "1s".
  # timeout = "5s"

  ## Float Parsing - the initial implementation forced any value unable to be
  ## parsed as an int to be a string. Setting this to "float" will attempt to
  ## parse float values as floats and not strings. This would break existing
  ## metrics and may cause issues if a value switches between a float and int.
  # parse_floats = "string"

  ## Optional TLS Config
  ## Set to true/false to enforce TLS being enabled/disabled. If not set,
  ## enable TLS only if any of the other options are specified.
  # tls_enable =
  ## Trusted root certificates for server
  # tls_ca = "/path/to/cafile"
  ## Used for TLS client certificate authentication
  # tls_cert = "/path/to/certfile"
  ## Used for TLS client certificate authentication
  # tls_key = "/path/to/keyfile"
  ## Password for the key file if it is encrypted
  # tls_key_pwd = ""
  ## Send the specified TLS server name via SNI
  # tls_server_name = "kubernetes.example.com"
  ## Minimal TLS version to accept by the client
  # tls_min_version = "TLS12"
  ## List of ciphers to accept, by default all secure ciphers will be accepted
  ## See https://pkg.go.dev/crypto/tls#pkg-constants for supported values.
  ## Use "all", "secure" and "insecure" to add all support ciphers, secure
  ## suites or insecure suites respectively.
  # tls_cipher_suites = ["secure"]
  ## Renegotiation method, "never", "once" or "freely"
  # tls_renegotiation_method = "never"
  ## Use TLS but skip chain & host verification
  # insecure_skip_verify = false
```

## Troubleshooting

If you have any issues please check the direct Zookeeper output using netcat:

```sh
$ echo mntr | nc localhost 2181
zk_version      3.4.9-3--1, built on Thu, 01 Jun 2017 16:26:44 -0700
zk_avg_latency  0
zk_max_latency  0
zk_min_latency  0
zk_packets_received     8
zk_packets_sent 7
zk_num_alive_connections        1
zk_outstanding_requests 0
zk_server_state standalone
zk_znode_count  129
zk_watch_count  0
zk_ephemerals_count     0
zk_approximate_data_size        10044
zk_open_file_descriptor_count   44
zk_max_file_descriptor_count    4096
```

## Metrics

Exact field names are based on Zookeeper response and may vary between configuration, platform, and version.

-   zookeeper
    -   tags:
        -   server
        -   port
        -   state
    -   fields:
        -   approximate\_data\_size (integer)
        -   avg\_latency (integer)
        -   ephemerals\_count (integer)
        -   max\_file\_descriptor\_count (integer)
        -   max\_latency (integer)
        -   min\_latency (integer)
        -   num\_alive\_connections (integer)
        -   open\_file\_descriptor\_count (integer)
        -   outstanding\_requests (integer)
        -   packets\_received (integer)
        -   packets\_sent (integer)
        -   version (string)
        -   watch\_count (integer)
        -   znode\_count (integer)
        -   followers (integer, leader only)
        -   synced\_followers (integer, leader only)
        -   pending\_syncs (integer, leader only)

## Example Output

```text
zookeeper,server=localhost,port=2181,state=standalone ephemerals_count=0i,approximate_data_size=10044i,open_file_descriptor_count=44i,max_latency=0i,packets_received=7i,outstanding_requests=0i,znode_count=129i,max_file_descriptor_count=4096i,version="3.4.9-3--1",avg_latency=0i,packets_sent=6i,num_alive_connections=1i,watch_count=0i,min_latency=0i 1522351112000000000
```

#### Related

-   [Configure plugins](/telegraf/v1/configure_plugins/)
-   [Apache Zookeeper Plugin Source](https://github.com/influxdata/telegraf/tree/v1.38.4/plugins/inputs/zookeeper/README.md)