AWS MSK ZooKeeper Info Test

In a distributed application cluster, clients are the nodes that access information from the Zookeeper servers grouped within a Zookeeper ensemble. At frequent intervals, every client sends a message to the server to let the sever know that the client is alive. Likewise, the server too sends an acknowledgement when a client connects. If there is no response from the connected server, the client automatically redirects the message to another server. If the clients are overloaded with requests or if the client takes too long to connect to the target AWS Managed Service Kafka, the requests could not be processed swiftly leading to time delays. To avoid such time delays and to ensure that the requests are processed faster, it is essential to keep track on the clients connecting to the target server. The AWS MSK Zookeeper Info test helps administrators in this regard!

This test also helps administrators determine which client is taking too long to process the requests and the client on which too many connections are currently active.

Target of the test : AWS Managed Service Kafka

Agent deploying the test : A remote agent

Outputs of the test : One set of results for each client connecting to the Zookeeper in the target AWS Managed Service Kafka server.

Configurable parameters for the test
Parameter Description

Test Period

How often should the test be executed.


The IP address of the AWS Managed Service Kafka Broker that is being monitored.


Specify the port number at which the specified HOST listens. By default, this is NULL.

AWS Default Region

This test uses AWS CLI to interact with AWS Managed Service Kafka and pull relevant metrics. To enable the test to connect to AWS, you need to configure the test with the name of the region to which all requests for metrics should be routed, by default. Specify the name of this AWS Default Region, here.

AWS Access Key ID, AWS Secret Access Key and Confirm Password

To monitor AWS Managed Service Kafka, the eG agent has to be configured with the access key and secret key of a user with a valid AWS account. For this purpose, we recommend that you create a special user on the AWS cloud, obtain the access and secret keys of this user, and configure this test with these keys. The procedure for this has been detailed in the Obtaining an Access key and Secret key topic. Make sure you reconfirm the access and secret keys you provide here by retyping it in the corresponding Confirm Password text box.

Timeout Seconds

Specify the maximum duration (in seconds) for which the test will wait for a response from the server. The default is 10 seconds.

Measurements made by the test
Measurement Description Measurement Unit Interpretation

ZooKeeper session state

Indicates the status of the client’s connection to Zookeeper.


The values reported by this measure and its numeric equivalents are mentioned in the table below:

Measure Value

Numeric Value
No connection 0
Closed 3
Authentication failed 5
Not connected 10
Associating 70
Connecting 80
Connected read only 90
Connected 100


By default, this measure reports the Measure Values listed in the table above to indicate the status of the broker’s connection to Zookeeper.

ZooKeeper request latency

Indicates the average time taken to process the requests received from this client.