Kafka plugin


This plugin

 collects metrics from the Kafka.

Prerequisites

Meter version 4.2 or later must be installed.

The Kafka plugin 0.8.2 or later supports the following Operating Systems.

Linux

✅️

Windows

✅️

OS X

✅️

Plugin Setup

To collect statistics from a Kafka broker, enable access to the JMX remote endpoint.

Run the server specifying the JMX_PORT.

For instance, $ JMX_PORT=9990 ./bin/kafka-server-start.sh config/server.properties

To install the plugin

  1. From the top right of the screen, perform one of the following actions:
    • Click Settings > Data Collection, select the TrueSight meter, and select the Sources tab.
    • Click Settings > Configure Sources.
  2. Use the search box or scroll through the page to find the source system which has the TrueSight meter on which you want to install the plugin.
  3. Click the name of the source to view source details.
  4. Select the Plugins tab.
  5. Use the search box or scroll through the page to find the plugin you want to install.
  6. Click + Install to start the installation.

    Refer to the following sections for the configuration details required to collect data and view the list of plugin metrics.

Configuration details

Field Name

Description

Host

Host of the Kafka JMX endpoint.

Port

Port of the Kafka JMX endpoint. Defaults to 9990.

Username

Username of the Kafka JMX endpoint.

Password

Password of the Kafka JMX endpoint.

Source

The Source to display in the legend for the metrics data. It will default to the hostname of the server.

Poll Interval

How often should the plugin poll for metrics.

Advanced configuration

To customize this plugin, see Kafka plugin on GitHub.

Plugin metrics

Metric Name

Description

KAFKA_JVM_HEAPMEMORY_USED

Heap Memory Used by the JVM.

KAFKA_TOPIC_MESSAGE_IN_RATE

Number of Message In on Topics per second.

KAFKA_TOPIC_BYTE_IN_RATE

Number of Bytes In on Topics per second.

KAFKA_TOPIC_BYTE_OUT_RATE

Number of Bytes Out from Topics per second.

KAFKA_PRODUCE_REQUEST_RATE

Number of Requests by Producers per second.

KAFKA_CONSUME_REQUEST_RATE

Number of requests by Fetch Consumers per second.

KAFKA_FOLLOW_REQUEST_RATE

Number of requests by Fetch Followers per second.

KAFKA_PRODUCE_REQUEST_FAILS

Total number of failed Produce Requests.

KAFKA_FETCH_REQUEST_FAILS

Total number of failed Fetch Requests.

KAFKA_ISR_SHRINK_RATE

If a brokers goes down, ISR for some of the partitions will shrink.

KAFKA_ISR_EXPAND_RATE

Number of ISR expansions per second.

KAFKA_PRODUCE_REQUEST_TOTAL_TIME

Total time of Producers requests.

KAFKA_CONSUME_REQUEST_TOTAL_TIME

Total time of Fetch Consumers requests.

KAFKA_FOLLOW_REQUEST_TOTAL_TIME

Total time of Fetch Followers requests.

KAFKA_PRODUCE_REQUEST_RESPONSE_TIME

Total time to send the response to the Producer.

KAFKA_CONSUME_REQUEST_RESPONSE_TIME

Total time to send the response to a Consumer.

KAFKA_FOLLOW_REQUEST_RESPONSE_TIME

Total time to send the reponse to a Follower.

KAFKA_NETWORK_PROCESSOR_IDLE_TIME

The average fraction of time the network processors are idle.

KAFKA_REQUEST_HANDLER_THREADS_IDLE_TIME

The average fraction of time the request handler threads are idle.

KAFKA_UNDER_REPLICATED_PARTITIONS

Number of under replicated partitions.

KAFKA_LEADER_ELECTION_RATE

Leader election rate. A non-zero value means broker failures.

KAFKA_UNCLEAN_LEADER_ELECTION_RATE

Unclean leader election rate.

KAFKA_MAX_LAG_MESSAGES_FOLLOWER_AND_REPLICAS

Max lag in message between follower and leader replicas.

KAFKA_PRODUCER_PURGATORY_REQUESTS_WAITING

Number of request waiting in the producer purgatory

KAFKA_PRODUCER_PURGATORY_REQUESTS_DELAYED

Number of delayed request in producer purgatory

KAFKA_FETCH_PURGATORY_REQUESTS_WAITING

Number of requests waiting in the fetch purgatory

KAFKA_FETCH_PURGATORY_REQUESTS_DELAYED

Number of delayed request in fetch purgatory

KAFKA_LEADER_COUNT

Number of leaders.

KAFKA_PARTITIONS_COUNT

Number of partitions.

KAFKA_OFFLINE_PARTITIONS_COUNT

Number of offline partitions.

KAFKA_ACTIVE_CONTROLLER_COUNT

Number of active controllers.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*